Wiki.jsインストール · 2 min read · Sep 08, 2025

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

Wiki.jsは、Node.js、Git、およびMarkdownに基づいた無料でオープンソースのウィキソフトウェアです。AGPL-v3ライセンスの下でリリースされており、パフォーマンスとシステムリソースの保護を目的としています。Wiki.jsは、システムのどこにでもインストールできる強力なウィキソフトウェアです。オペレーティングシステムにインストールすることも、Herokuなどのクラウドサービスを使用することもでき、DockerやKubernetesなどのコンテナ環境にWiki.jsをデプロイすることもできます。

Wiki.jsはPostgreSQLデータベースと互換性があり、追加の認証、ログシステム、検索エンジン、レンダリング、ストレージのための50以上の統合を提供します。美しく直感的なインターフェースを持つ管理ダッシュボードとページの上に構築された強力なウィキソフトウェアです。技術スタックを文書化するための完全にカスタマイズ可能なウィキソフトウェアです。

この記事では、Debian 12システムにWiki.jsをインストールする方法を示します。PostgreSQLデータベースサーバーを利用し、Nginxをリバースプロキシとして使用し、Let’s EncryptからのSSL/TLS証明書でWiki.jsインスタンスを保護する手順を案内します。

前提条件

進む前に、以下を確認してください：

  • Debian 12サーバー。
  • 管理者権限を持つ非ルートユーザー。
  • サーバーのIPアドレスを指すドメイン名。この例では、ドメインwiki.howtoforge.localを使用します。

依存関係のインストール

最初の段階では、Wiki.jsで使用されるいくつかの依存関係をインストールします。これには以下が含まれます：

  • PostgreSQLデータベースサーバー：これはWiki.jsのデータベースとして使用されます。
  • Nginxウェブサーバー：NginxウェブサーバーはWiki.jsのリバースプロキシとして使用されます。
  • Node.jsとNPM：JavaScriptランタイムエンジンNode.jsとNPMパッケージマネージャー。
  • CertbotとNginx Certbotプラグイン：Let’s Encryptを介してSSL/TLS証明書を生成するためのCertbotと、NginxサーバーブロックをHTTPSで自動的に確認するNginx Certbotプラグイン。

始めるには、以下のコマンドを使用してDebianリポジトリを更新およびリフレッシュします。

sudo apt update

次に、以下のapt installコマンドを使用してWiki.jsのパッケージ依存関係をインストールします。以下のコマンドで、PostgreSQLデータベースサーバー、Node.jsとNPM、Nginxウェブサーバー、Certbot、およびCertbot Nginxプラグインをインストールします。

sudo apt install postgresql postgresql-common nodejs npm nginx certbot python3-certbot-nginx

インストールを確認するためにyと入力します。

依存関係がインストールされたら、以下のコマンドを使用してそれぞれを確認します。

PostgreSQLサービスのステータスをsystemctlコマンドを使用して確認します。

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

以下のような出力が表示されます。

postgresqlサーバーの確認

Nginxサービスのステータスを確認して、実行中で有効であることを確認します。

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Nginxが実行中で有効であれば、以下の出力がターミナルに表示されます。

nginxの確認

最後に、以下のコマンドを実行してNode.jsとNPMを確認します。出力には、システムにインストールされている現在のNode.jsとNPMのバージョンが表示されます。

node --version  
npm --version

PostgreSQLデータベースとユーザーの作成

依存関係をインストールした後、次のステップはWiki.jsインストール用の新しいデータベースとユーザーを作成することです。そのためには、psqlクライアントを介してPostgreSQLにログインする必要があります。

以下のコマンドを実行してPostgreSQLサーバーにログインします。

sudo -u postgres psql

ログインしたら、以下のクエリを実行して新しいPostgreSQLデータベースとユーザーwikijsを作成します。以下のクエリでパスワードを変更してください。

CREATE USER wikijs WITH PASSWORD 'p4ssw0rd';  
CREATE DATABASE wikijs OWNER wikijs;

ユーザーとデータベースの作成

データベースとユーザーが作成されたら、以下のクエリを使用してPostgreSQLインスタンス上の利用可能なデータベースとユーザーのリストを確認します。


du  

l

PostgreSQLに作成されたデータベースとユーザーwikijsが表示されるはずです。

データベースとユーザーのリストの確認

PostgreSQLサーバーから退出するにはquitと入力します。

Wiki.jsソースコードのダウンロード

次のセクションでは、Wiki.jsのソースコードをサーバーにダウンロードし、適切な権限と所有権でインストールディレクトリを設定します。

以下のコマンドを実行して新しいユーザーwikijsを作成します。

sudo useradd -m -s /bin/false wikijs

次に、新しいディレクトリ/opt/wikijsを作成し、その中に移動します。そして、以下のwgetコマンドを使用してWiki.jsのソースコードをダウンロードします。

mkdir -p /opt/wikijs; cd /opt/wikijs  
wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz

ダウンロードが完了したら、Wiki.jsのソースコードを抽出し、/opt/wikijsディレクトリの所有権をユーザーwikijsに変更します。

tar -xf wiki-js.tar.gz  
sudo chown -R wikijs:wikijs /opt/wikijs

Wiki.jsの設定

Wiki.jsをダウンロードしたら、次にPostgreSQLデータベースとユーザーでWiki.jsインストールを設定し、Wiki.jsのバインドIPアドレスも設定します。

デフォルトのWiki.js設定config.sample.ymlをconfig.ymlにコピーし、以下のnanoエディタを使用して開きます。

sudo -u wikijs cp config.sample.yml config.yml  
sudo -u wikijs nano config.yml

デフォルトのデータベース設定をPostgreSQLデータベース、ユーザー、およびパスワードに変更します。

  # PostgreSQL / MySQL / MariaDB / MS SQL Serverのみ：  
  host: localhost  
  port: 5432  
  user: wikijs  
  pass: p4ssw0rd  
  db: wikijs  
  ssl: false

デフォルトのbindIPオプションをlocalhostまたは127.0.0.1に変更します。これにより、Wiki.jsがlocalhostで実行されます。

bindIP: 127.0.0.1

完了したら、保存して終了します。

次に、以下のコマンドを実行してWiki.jsインストールを実行およびテストします。

sudo -u wikijs node server

Wiki.jsがデフォルトポート3000でlocalhostで実行されているという確認が表示されるはずです。

wiki.jsの設定

最後に、Ctrl+cを押してWiki.jsプロセスを終了します。

Wiki.jsをバックグラウンドでサービスとして実行する

Wiki.jsの設定が完了したので、次のステップはWiki.jsをバックグラウンドでsystemdサービスとして実行するように設定します。以下のアプローチを使用することで、systemctlユーティリティを介してWiki.jsを簡単に管理できます。

以下のnanoエディタコマンドを使用して、Wiki.js用の新しいsystemdサービスファイル/etc/systemd/system/wikijs.serviceを作成します。

sudo nano /etc/systemd/system/wikijs.service

以下の設定を挿入して、Wiki.jsがバックグラウンドでサービスとして実行できるようにします。

[Unit]  
Description=Wiki.js  
After=network.target postgresql.service  
  
[Service]  
Type=simple  
ExecStart=/usr/bin/node server  
Restart=always  
  
User=wikijs  
Environment=NODE_ENV=production  
WorkingDirectory=/opt/wikijs  
  
[Install]  
WantedBy=multi-user.target

完了したら、ファイルを保存してエディタを終了します。

次に、以下のsystemctlコマンドを実行してsystemdマネージャーをリロードし、Wiki.jsの新しいサービスファイルを適用します。

sudo systemctl daemon-reload

以下のコマンドを使用してWiki.jsサービスを開始および有効にできます。これにより、Wiki.jsがlocalhostでデフォルトポート3000でバックグラウンドで開始され、ブート時に自動的に実行されるようになります。

sudo systemctl start wikijs  
sudo systemctl enable wikijs

wiki.jsの開始と有効化

以下のコマンドを使用してwikijsサービスを確認し、サービスが実行中であることを確認します。

sudo systemctl status wikijs

以下のような出力が表示されるはずです。

wiki.jsサービスの確認

最後に、以下のssコマンドを実行して、Wiki.jsアプリケーションが使用しているポート3000を確認します。

ss -tulpn | grep 3000

Wiki.jsが実行中であれば、Node.jsアプリケーションがポート3000を使用していることが表示されるはずです。

Nginxをリバースプロキシとして設定する

現在、Wiki.jsがlocalhostでデフォルトポート3000で実行されています。次のステップでは、Wiki.jsのリバースプロキシとして使用される新しいNginxサーバーブロック設定を作成します。始める前に、サーバーIPアドレスを指すドメイン名があることを確認してください。

以下のnanoエディタコマンドを使用して、新しいNginxサーバーブロック設定/etc/nginx/sites-available/wikijsを作成します。

sudo nano /etc/nginx/sites-available/wikijs

以下の設定を挿入し、Wiki.jsインストールのドメイン名を変更してください。

server {  
    listen 80;  
    server_name wiki.howtoforge.local;  
  
    root /opt/wikijs;  
  
    access_log  /var/log/nginx/wikijs.access.log;  
    error_log   /var/log/nginx/wikijs.error.log;  
  
    location / {  
        proxy_http_version 1.1;  
        proxy_set_header Upgrade $http_upgrade;  
        proxy_set_header Connection "upgrade";  
        proxy_set_header Host $http_host;  
        proxy_set_header X-Real-IP $remote_addr;  
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
        proxy_set_header X-Forwarded-Proto $scheme;  
        proxy_pass http://127.0.0.1:3000;  
    }  
}

ファイルを保存して、完了したらエディタを終了します。

次に、以下のコマンドを実行してWiki.jsサーバーブロック設定を有効にし、Nginxの構文を確認します。

sudo ln -s /etc/nginx/sites-available/wikijs /etc/nginx/sites-enabled  
sudo nginx -t

正しいNginx構文があれば、テストは成功しました - 構文は正しいですという出力が得られるはずです。

次に、以下のコマンドを使用してNginxサービスを再起動し、設定した新しいサーバーブロックを適用します。

sudo systemctl restart nginx

Nginxが再起動したら、お好みのウェブブラウザを起動し、Wiki.jsインストールのドメイン名（例：http://wiki.howtoforge.local/）にアクセスします。すべてがうまくいけば、以下のようなWiki.jsインストールページが表示されるはずです。

wiki.jsインストールページ

SSL/TLS証明書でWiki.jsを保護する

次のステップでは、LetsencryptからのSSL/TLS証明書でWiki.jsインストールを保護します。また、Certbot Nginxプラグインを介して自動的にHTTPからHTTPSにリダイレクトを設定します。

以下のcertbotコマンドを実行して、Letsencryptから新しいSSL/TLS証明書を生成します。ドメイン名とメールアドレスの詳細を自分の情報に変更してください。

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

プロセスが完了すると、SSL証明書は/etc/letsencrypt/live/wiki.howtoforge.local/ディレクトリに利用可能になります。Wiki.jsサーバーブロック設定は、Certbot Nginxプラグインを介してHTTPSで自動的に設定されます。

Wiki.jsインストールの開始

ウェブブラウザに戻り、Wiki.jsのドメイン名（例：http://wiki.howtoforge.local/）にアクセスします。自動的に安全なHTTPS接続にリダイレクトされるはずです。

次に、Wiki.jsの管理者ユーザーを作成し、メールアドレスとパスワードを入力します。次に、INSTALLをクリックしてインストールを確認します。

wiki.jsインストール

インストールが完了すると、Wiki.jsのログインページにリダイレクトされるはずです。管理者のメールアドレスとパスワードを入力し、LOGINをクリックします。

Wiki.jsログインページ

インストールが成功すると、Wiki.jsのウェルカムページが表示されるはずです。ここから新しいホームページを作成するか、Wiki.js管理ダッシュボードにアクセスできます。

インストール成功

ADMINISTRATIONをクリックすると、以下のようなWiki.js管理ページが表示されるはずです。

wiki.js管理ダッシュボード

SYSTEMセクションで、System Infoメニューをクリックして、Wiki.jsインストールに関する詳細情報を取得します。以下に、Wiki.js 2.5がNode.js 18.xおよびPostgreSQL 15.xでインストールされていることが表示されるはずです。

wiki.jsシステム情報

結論

これで完了です！すべての手順を実行し、Debian 12システムにWiki.jsをインストールしました。PostgreSQLデータベースサーバー、Nginxをリバースプロキシとして使用し、Let’s EncryptからのSSL/TLS証明書でインストールを保護しました。これで、Wiki.jsを使用して会社の文書を作成し始めることができます。

Share: X/Twitter LinkedIn
#Wiki.jsインストール

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

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