インストールガイド · 2 min read · Sep 22, 2025

Wiki.jsのインストール方法 - Debian 9上のNodeJSベースのWikiソフトウェア

Wiki.jsは、Node.js、Git、およびMarkdownに基づいたオープンソースのモダンで強力なWikiアプリです。Wiki.jsは、非常に高速なNode.jsエンジン上で動作し、CPUリソースを節約するように最適化されています。Wiki.jsの特徴として言及すべき点は以下の通りです：

  • GitによってサポートされたMarkdown編集
  • 軽量でありながら非常に強力
  • モダンなウェブのために美しくデザインされている
  • 統合されたアクセス制御
  • 直感的なアセット管理
  • 組み込みの検索エンジン

このチュートリアルでは、NGINXをリバースプロキシサーバーとして使用し、MongoDBをデータベースサーバーとして使用し、PM2をプロセスマネージャーとして使用して、Debian 9オペレーティングシステム上でWiki.jsバージョン1のインストールプロセスを説明します。オプションで、acme.shクライアントとLet’s Encrypt証明書機関を使用してSSLサポートを追加することで、トランスポート層を保護することができます。

要件

Wiki.jsを実行するための要件は以下の通りです：

  • Node.js 6.11.1から10.xが必要です。
  • MongoDBバージョン3.2以降。
  • Gitバージョン2.7.4以降。
  • NGINX、Apache、Caddy、H2Oなどのウェブサーバーソフトウェア。
  • 空のGitリポジトリ（オプション）。
  • 最低512MBのRAM。1GBのRAMを推奨。
  • 約300MBのディスクスペース。
  • A/AAAA DNSレコードが設定されたドメイン名。

前提条件

  • Debian 9オペレーティングシステム。
  • sudo権限を持つ非ルートユーザー。

初期ステップ

Debianシステムのバージョンを確認します：

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

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

dpkg-reconfigure tzdata

オペレーティングシステムのパッケージ（ソフトウェア）を更新します。これは重要な最初のステップであり、オペレーティングシステムのデフォルトソフトウェアパッケージの最新の更新とセキュリティ修正があることを保証します：

apt update && apt upgrade -y

Debianオペレーティングシステムの基本管理に必要な必須パッケージをいくつかインストールします：

apt install -y curl wget vim git unzip socat sudo bash-completion apt-transport-https build-essential dirmngr

ステップ1 - Node.jsとnpmのインストール

Wiki.jsはNode.js上に構築されています。私たちは、執筆時点でWiki.jsのために推奨される最新バージョンであるバージョン10 をインストールします。Linuxでは、Node.jsのインストールオプションがいくつかあります：Linuxバイナリ（x86/x64）、ソースコード、またはパッケージマネージャーを介して。私たちは、Node.jsのインストールと更新を簡単にするパッケージ管理オプションを使用します。

NodeSourceリポジトリからNode.jsの最新の推奨バージョンをダウンロードしてインストールします：

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

注意：npmはNode.jsと共に配布されているため、Node.jsをダウンロードすると、自動的にnpmがシステムにインストールされます。

Node.jsとnpmのバージョンを確認します：

`node -v && npm -v  
# v10.15.1  
# 6.4.1  
`

npmはNode.jsとは別のプロジェクトであり、より頻繁に更新される傾向があります。そのため、Node.js（したがってnpm）をダウンロードしたばかりでも、npmを更新する必要があるでしょう。幸いなことに、npmは自分自身を更新する方法を知っています！npmを更新するには、ターミナルに次のコマンドを入力します： 

sudo npm install -g npm@latest

このコマンドはnpmを最新の安定版に更新します。

npmのバージョンを再確認します：

npm -v  
# 6.8.0

そして、最新のバージョン番号が返されるはずです。

ステップ2 - MongoDBデータベースのインストール

Wiki.jsはデータを保存するためのデータベースが必要であり、現在の安定版のWiki.jsはMongoDBデータベースエンジンのみをサポートしています。それに従って、MongoDBデータベースをインストールする必要があります。

MongoDBデータベースをダウンロードしてインストールします：

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

MongoDBのバージョンを確認します：

mongo --version | head -n 1 && mongod --version | head -n 1

MongoDBサービスがまだ開始されていない場合は、開始して有効にします（再起動時に開始するように設定）：

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

ステップ3 - acme.shクライアントのインストールとLet’s Encrypt証明書の取得（オプション）

HTTPSでウェブサイトを保護することは必須ではありませんが、サイトのトラフィックを保護するための良いプラクティスです。Let’s EncryptからSSL証明書を取得するために、acme.shクライアントを使用します。Acme.shは、ゼロ依存関係でLet’s EncryptからSSL証明書を取得するための純粋なUNIXシェルソフトウェアです。

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

sudo su - root  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh  
./acme.sh --install --accountemail [email protected]  
source ~/.bashrc  
cd ~

acme.shのバージョンを確認します：

acme.sh --version  
# v2.8.1

あなたのドメイン/ホスト名のためにRSAおよびECC/ECDSA証明書を取得します：

# RSA 2048  
acme.sh --issue --standalone -d example.com --keylength 2048  
# ECDSA  
acme.sh --issue --standalone -d example.com --keylength ec-256

テスト用の偽の証明書が必要な場合は、上記のコマンドに--stagingフラグを追加できます。

発行された証明書をリストするには、次のコマンドを実行します：

acme.sh --list

証明書を保存するためのフォルダーを作成します。私たちは/etc/letsencryptを使用しますが、SSL証明書を保存するために好みの任意の場所を使用できます。

mkdir -p /etc/letsencrypt/example.com  
mkdir -p /etc/letsencrypt/example.com_ecc

証明書を/etc/letsencryptディレクトリにインストール/コピーします。

# RSA  
acme.sh --install-cert -d example.com \   
        --cert-file /etc/letsencrypt/example.com/cert.pem \  
        --key-file /etc/letsencrypt/example.com/private.key \  
        --fullchain-file /etc/letsencrypt/example.com/fullchain.pem \  
        --reloadcmd "sudo systemctl reload nginx.service"  
  
# ECC/ECDSA  
acme.sh --install-cert -d example.com --ecc \  
        --cert-file /etc/letsencrypt/example.com_ecc/cert.pem \  
        --key-file /etc/letsencrypt/example.com_ecc/private.key \  
        --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem \  
        --reloadcmd "sudo systemctl reload nginx.service"

上記のコマンドを実行した後、あなたの証明書とキーは以下にあります：

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

すべての証明書は60日ごとに自動的に更新されます。

証明書を取得した後、rootユーザーからログアウトし、通常のsudoユーザーに戻ります：

exit

ステップ4 - NGINXのインストールと設定

Wiki.js（または任意のHTTP Node.jsアプリ）は、実際のウェブサーバー（NGINXやApacheなど）なしで動作できます。しかし、Wiki.jsの前に標準のウェブサーバーを置くことを強く推奨します。これにより、SSL、複数のウェブサイト、キャッシングなどの機能を使用できます。このチュートリアルではNGINXを使用しますが、他のサーバーでも構いません。適切に設定する必要があります。

以下のコマンドを発行して、公式の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

NGINXのバージョンを確認します：

sudo nginx -v  
# nginx version: nginx/1.15.8

NGINXサービスを有効にして開始します：

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

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 example.com;

    charset utf-8;
    client_max_body_size 50M;  
    
    ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;  
    ssl_certificate_key /etc/letsencrypt/example.com/private.key;  
    ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;  
    ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.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;
    }
    
}

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

NGINXの設定を確認します：

sudo nginx -t

最後に、変更を有効にするためにNGINXを再読み込みする必要があります：

sudo systemctl reload nginx.service

ステップ5 - Wiki.jsのインストールと設定

Wiki.jsが存在するドキュメントルートディレクトリを作成します：

sudo mkdir -p /var/www/wiki.js

ドキュメントルートディレクトリに移動します：

cd /var/www/wiki.js

/var/www/wiki.jsディレクトリの所有権をyour_userに変更します：

sudo chown -R [your_user]:[your_user] /var/www/wiki.js

注意：上記のコマンドのyour_userを、あなたがこのチュートリアルの前提条件として作成した非ルートユーザーに置き換えてください *。

/var/www/wiki.jsディレクトリから、最新のWiki.jsアプリケーションを取得してインストールするために次のコマンドを実行します：

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

インストールが完了したら、現在インストールされているWiki.jsのバージョンを表示するために次のコマンドを実行できます：

node wiki --version  
# 1.0.117

インストールが完了すると、設定ウィザードを起動するように求められます。

設定ウィザードを起動するには、次のコマンドを実行します：

node wiki configure

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

最初に、ウェルカムメッセージが表示されます。「開始」ボタンをクリックします：

Wiki.jsインストーラー

次に「システムチェック」ページが表示されます。すべての要件が満たされている場合は、「続行」ボタンをクリックします。

システムチェック

Wikiに関する一般情報を入力し、「続行」ボタンをクリックします：

一般情報

「重要な考慮事項」の通知を読み、「続行」をクリックして次のステップに進みます：

考慮すべき重要なこと

次に、データベースに接続して続行します：

データベース接続

Wiki.jsがデータベースに正常に接続されたというメッセージが表示されるはずです。「続行」ボタンをクリックします：

データベース接続成功

パスを設定して続行します：

パスを設定

リモートGitリポジトリを設定するか、またはこのステップをスキップします。このステップはオプションですが、強く推奨されます：

リモートGITリポジトリの設定

次に、「続行」ボタンをクリックします：

インストールを続行

管理者アカウントを作成し、「続行」ボタンをクリックします：

管理者アカウントの作成

最後に、Wiki.jsを起動します：

Wiki.jsを起動

約30秒待つと、Wiki.jsのホームページにリダイレクトされるはずです：

Wiki.jsホームページ

インストールが完了しました。Wikiのウェルカムページが表示されるはずです：

Wiki.jsへようこそ

ステップ6 - PM2プロセスマネージャーの設定

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

PM2に自動起動サービスとして設定するように指示します：

/var/www/wiki.js/node_modules/pm2/bin/pm2 startup

最後に、現在のPM2設定を保存するために次のコマンドを実行します：

/var/www/wiki.js/node_modules/pm2/bin/pm2 save

これで、あなたのWiki.jsはバックグラウンドプロセスとして実行され、PM2がプロセスマネージャーとして使用されます。

リンク

Share: X/Twitter LinkedIn
#インストールガイド

新しい投稿を受信箱で受け取る

スパムはありません。いつでも購読を解除できます。