Debian 9にWiki.jsをインストールする方法

Wiki.jsは、Node.js、MongoDB、Git、Markdownに基づいて構築された無料のオープンソースの最新のWikiアプリです。Wiki.jsソースコードはGitHubで公開されています。このガイドでは、Node.js、MongoDB、PM2、Nginx、Git、Acme.shを使用して、新しいDebian 9 VultrインスタンスにWiki.jsをインストールする方法を示します。

必要条件

  • Node.js 6.9.0以降
  • MongoDB 3.2以降
  • Nginx
  • Git 2.7.4以降
  • Git準拠のリポジトリ(パブリックまたはプライベート)(オプション
  • 最小 768MB RAM
  • A/ AAAAレコードが設定されたドメイン名

Debianのバージョンを確認してください。

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

システムが最新であることを確認します。

apt update && apt upgrade -y

必要なパッケージをインストールします。

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

アクセス権をnon-root持つ新しいユーザーアカウントを作成し、sudoそれに切り替えます。

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

をユーザー名に置き換えjohndoeます。

タイムゾーンを設定します。

sudo dpkg-reconfigure tzdata

Gitをインストールする

DebianにGitをインストールします。

sudo apt install -y git

Gitのバージョンを確認します。

git --version
# git version 2.11.0

Node.jsをインストールする

Node.js用のNodeSource APTリポジトリを利用してNode.jsをインストールします。

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs

Node.jsとnpmのバージョンを確認してください。

node -v && npm -v
# v8.11.2
# 5.6.0

MongoDBをインストールする

Wiki.jsはデータベースエンジンとしてMongoDBを使用します。それによると、サーバーにMongoDBをインストールする必要があります。インストールには公式のMongoDBリポジトリを使用します。

MongoDB Community Editionをインストールします。

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

バージョンを確認してください。

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.5
# db version v3.6.5

MongoDBを有効にして起動します。

sudo systemctl enable mongod.service
sudo systemctl start mongod.service

Nginxをインストールして構成する

標準のWebサーバーをWiki.jsの前に置くことを強くお勧めします。これにより、SSL、複数のWebサイト、キャッシュなどの機能を使用できるようになります。このチュートリアルではNginxを使用しますが、他のサーバーでも使用できます。適切に構成する必要があります。

Nginxをインストールします。

wget https://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key
rm nginx_signing.key
sudo -s
printf "deb https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

バージョンを確認してください。

sudo nginx -v
# nginx version: nginx/1.15.0

Nginxを有効にして起動します。

sudo systemctl enable nginx.service
sudo systemctl start nginx.service

Nginx をWiki.jsアプリケーションの(HTTPまたはHTTPSSSLを使用する場合)リバースプロキシとして構成します。

実行してsudo vim /etc/nginx/conf.d/wiki.js.conf、以下の基本的なリバースプロキシ構成を入力します。

server {

    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_next_upstream error timeout http_502 http_503 http_504;
    }

}

上記の設定で変更する必要があるのはserver_nameディレクティブのみであり、proxy_pass以外のポートを設定する場合はディレクティブも可能です3000。Wiki.jsは3000デフォルトでポートを使用します。

構成を確認してください。

sudo nginx -t

Nginxをリロードします。

sudo systemctl reload nginx.service

Acme.shをインストールし、Let's Encrypt証明書を取得します(オプション)。

でWikiを保護するHTTPS必要はありませんが、サイトのトラフィックを保護することをお勧めします。Let's EncryptからSSL証明書を取得するために、Acme.shクライアントを使用します。Acme.shは、依存関係がゼロのLet's EncryptからSSL証明書を取得するための純粋なUNIXシェルソフトウェアです。これにより、正常に実行するために多くの依存関係を必要とする他のいくつかのACMEプロトコルクライアントと比較して、非常に軽量になります。

Acme.shをダウンロードしてインストールします。

sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]
cd ~

バージョンを確認してください。

/etc/letsencrypt/acme.sh --version
# v2.7.9

のRSAおよびECDSA証明書を取得しwiki.example.comます。

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --keylength ec-256 

ドメイン名に置き換えることwiki.example.comを忘れないでください。

上記のコマンドを実行すると、証明書とキーは次のディレクトリにあります。

  • RSAの場合:/etc/letsencrypt/wiki.example.comディレクトリ。
  • ECC / ECDSAの場合:/etc/letsencrypt/wiki.example.com_eccディレクトリ。

Let's Encryptから証明書を取得したら、それらを利用するようにNginxを構成する必要があります。

sudo vim /etc/nginx/conf.d/wiki.js.conf再度実行し、NginxをHTTPSリバースプロキシとして構成します。

server {

    listen [::]:443 ssl http2;
    listen 443 ssl http2;
    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    # RSA
    ssl_certificate /etc/letsencrypt/wiki.example.com/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/example.com.key;

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_next_upstream error timeout http_502 http_503 http_504;
    }

}

構成を確認してください。

sudo nginx -t

Nginxをリロードします。

sudo systemctl reload nginx.service

Wiki.jsをインストールする

Wiki.jsをインストールする空のドキュメントルートフォルダーを作成します。

sudo mkdir -p /var/www/wiki.example.com

ドキュメントルートフォルダーに移動します。

cd /var/www/wiki.example.com

/var/www/wiki.example.comフォルダの所有権をユーザーに変更しますjohndoe

sudo chown -R johndoe:johndoe /var/www/wiki.example.com

/var/www/wiki.example.comフォルダーから次のコマンドを実行して、Wiki.jsをダウンロードしてインストールします。

curl -sSo- https://wiki.js.org/install.sh | bash

現在インストールされているWiki.jsのバージョンを表示するには、次のコマンドを実行します。

node wiki --version
# 1.0.78

インストールが完了すると、構成ウィザードを実行するように求められます。

実行して構成ウィザードを開始します。

node wiki configure

これにより、http://localhost:3000Wiki.jsを構成するために移動するように通知されます。Wiki.jsの前にNginxがある場合は、にアクセスするhttp://wiki.example.com代わりにドメイン名(など)を開くことができますlocalhost

Webブラウザーを使用して、http://wiki.example.com画面上の指示に移動し、それに従います。構成ウィザードで入力したすべての設定がconfig.ymlファイルに保存されます。構成ウィザードが自動的にWiki.jsを起動します。

PM2のセットアップ

デフォルトでは、システムの再起動後、Wiki.jsは自動的に起動しません。起動時に起動するために、PM2プロセスマネージャをセットアップする必要があります。PM2はローカルNPMモジュールとしてWiki.jsにバンドルされているため、PM2をグローバルにインストールする必要はありません。

自身をスタートアップサービスとして構成するようPM2に指示します。

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup

最後に、現在のPM2構成を保存します。

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

Wiki.jsインスタンスは、PM2をプロセスマネージャーとして使用して、バックグラウンドプロセスとして実行されます。でOSをsudo reboot再起動し、再起動後にWiki.jsが起動するかどうかを確認できます。



Leave a Comment

CentOS 7にApacheをインストールする方法

CentOS 7にApacheをインストールする方法

CentOS 7サーバーにApache 2.4をインストールする方法を説明します。安定したウェブサーバーを構築するための前提条件と手順を解説します。

FreeBSD 11.1にBlacklistdをインストールする方法

FreeBSD 11.1にBlacklistdをインストールする方法

FreeBSD 11.1におけるBlacklistdのインストール方法について詳しく解説します。この方法を通じて、強力なセキュリティ対策を実装できます。

Windows Serverのサーバーマネージャーを使用した複数サーバーの管理

Windows Serverのサーバーマネージャーを使用した複数サーバーの管理

サーバーマネージャーを使用して、Windows Serverの管理が向上します。セキュリティリスクを軽減し、効率的な管理を実現します。

CentOS 7にSeafileサーバーをインストールする方法

CentOS 7にSeafileサーバーをインストールする方法

CentOS 7にSeafileサーバーをインストールする方法。Seafile(コミュニティバージョン)は、ownCloudに似た無料のオープンソースファイル同期および共有ソリューションです。

DebianでSnortを設定する方法

DebianでSnortを設定する方法

Snortは無料のネットワーク侵入検知システムです。最新の方法で、SnortをDebianにインストールし、設定する手順を紹介します。ネットワークのセキュリティを強化しましょう。

CentOS 7にGraylogサーバーをインストールする方法

CentOS 7にGraylogサーバーをインストールする方法

CentOS 7にGraylogサーバーをインストールし、ログ管理を行う方法を学びます。

WindowsでhMailServerを使用してメールサーバーを構築する

WindowsでhMailServerを使用してメールサーバーを構築する

WindowsサーバーでWebサイトを実行している場合、電子メールも受信できるようにするためにhMailServerを使用する方法を解説します。

Ubuntu 19.04にFiveMサーバーをインストールする方法

Ubuntu 19.04にFiveMサーバーをインストールする方法

FiveMサーバーをUbuntu 19.04にインストールするための詳細なガイド。必要条件からインストール、起動、トラブルシューティングまで、すべてのステップを含みます。

WsgiDAVを使用してDebian 10にWebDAVをデプロイする

WsgiDAVを使用してDebian 10にWebDAVをデプロイする

Debian 10にWebDAVをデプロイする方法を学び、WsgiDAVとSSL証明書で安全な接続を実現しましょう。

ヘルスケア2021における人工知能の影響

ヘルスケア2021における人工知能の影響

ヘルスケアにおけるAIは、過去数十年から大きな飛躍を遂げました。したがって、ヘルスケアにおけるAIの未来は、日々成長を続けています。