Debian 12にDokuWikiをインストールする方法

DokuWikiは、データベースを必要としないシンプルで多用途なオープンソースのウィキソフトウェアです。メンテナンスの容易さ、可読性、ユーザー管理で知られており、企業や共同作業環境での文書作成と管理に最適です。PHPで動作し、その多用途なウィキソフトウェアと組み込みのアクセス制御（ACL）は主要な認証ドライバーをサポートしています。DokuWikiは簡単な管理を提供し、インストール、メンテナンス、バックアップが1つのホストから別のホストへ簡単に行えます。

このガイドでは、Debian 12サーバーにDokuWikiをインストールする手順を説明します。LAMPスタック（Apache2、MariaDB、PHP）、UFW、およびLetsencryptを介したSSL/TLS証明書を使用してDokuWikiをインストールします。

前提条件

このガイドを進めるために、以下のものを用意してください：

Debian 12サーバー。
管理者権限を持つ非ルートユーザー。
サーバーのIPアドレスを指すドメイン名。

依存関係のインストール

デフォルトでは、DokuWikiパッケージはDebianリポジトリにあります。しかし、最新のDokuWikiをインストールするために、手動でDokuWikiをDebianサーバーにインストールします。

このセクションでは、LAMPスタックパッケージ（Apache2、MariaDB、PHP）、UFW、およびCertbotを含むDokuWikiの依存関係をインストールします。

始める前に、以下のコマンドを使用してDebianリポジトリを更新してください。

sudo apt update

次のapt installコマンドを使用してLAMPスタック、UFW、およびCertbotパッケージをインストールします。プロンプトが表示されたらYと入力してENTERを押してください。

sudo apt install apache2 mariadb-server php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd ufw certbot python3-certbot-apache

install deps

インストールが完了したら、ApacheとMariaDBのサービスステータスを確認して、サービスが実行中であることを確認します。

以下のコマンドを実行してapache2サービスを確認します。

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

apache2が実行中の場合、出力は「active (running)」となります。また、「enabled」という出力は、apache2がシステム起動時に開始されることを確認します。

verify apache2

次に、以下のコマンドを実行してmariadbサービスを確認します。

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

mariadbサービスが「enabled」と「active (running)」であることを確認してください。

verify mariadb

UFWの設定

このガイドでは、UFW（Uncomplicated Firewall）を使用してDebianサーバーを保護します。そのためには、リモートアクセス用にSSHポートを開き、DokuWikiのインストールを実行するためにHTTPおよびHTTPSプロトコル用のポートを開く必要があります。

以下のコマンドを実行して、UFWにOpenSSHおよびWWW Fullプロファイルを追加します。

OpenSSHプロファイルはデフォルトのSSHポート22を開き、WWW FullプロファイルはHTTPおよびHTTPSポートの両方を開きます。

sudo ufw allow OpenSSH  
sudo ufw allow 'WWW Full'

次に、以下のコマンドを実行してDebianマシンでUFWを開始および有効にします。

sudo ufw enable

確認を求められたらyと入力し、出力として「Firewall is active and enabled on system startup」のようなメッセージが表示されるはずです。UFWはシステム起動時に自動的に実行されます。

setup ufw

最後に、以下のコマンドを実行してUFWのステータスを確認します。OpenSSHおよびWWW Fullプロファイルの両方がUFW有効ルールにリストされていることを確認してください。

sudo ufw status

verify ufw

php.iniの設定

次のセクションでは、デフォルトのphp.iniファイルを変更し、DokuWikiインストール用にいくつかの設定を調整してPHPを設定します。

以下のnanoエディタコマンドを実行してPHP設定ファイル「/etc/php/8.2/apache2/php.ini」を開きます。

sudo nano /etc/php/8.2/apache2/php.ini

デフォルトの設定を以下のように変更します。memory_limitパラメータは現在のサーバーRAMに合わせて調整してください。

memory_limit=256M  
upload_max_filesize=32M  
post_max_size=32M  
max_execution_time=60

完了したら、ファイルを保存して閉じます。

次に、以下のsystemctlコマンドを実行してapache2サービスを再起動し、変更を反映させます。

sudo systemctl restart apache2

MariaDBサーバーの設定

PHPを設定したので、次のステップはMariaDBサーバーのインストールを設定し、DokuWikiで使用する新しいデータベースとユーザーを作成することです。

以下のmariadb-secure-installationコマンドを実行してMariaDBの設定プロセスを開始します。

sudo mariadb-secure-installation

新しい設定をMariaDBに適用するかどうか尋ねられたらYと入力します。または、拒否するためにnと入力することもできます。以下は、プロンプトが表示されるいくつかのMariaDB設定です：

デフォルトのMariaDBインストールにはパスワードがありません。パスワードを求められたらENTERを押してください。
次に、MariaDBのrootパスワードを設定するためにYを入力します。その後、MariaDBの新しいパスワードを入力し、パスワードを繰り返します。
MariaDBインストールから匿名ユーザーを削除するためにYを入力します。
MariaDBのrootユーザーのリモートログインを無効にするように求められたら再度Yを入力します。
MariaDBからデフォルトのデータベーステストを削除するためにYを入力します。
最後に、テーブルの権限を再読み込みして新しい変更を適用するためにYを入力します。

MariaDBの設定が完了したら、DokuWikiで使用する新しいデータベースとユーザーを作成する必要があります。

以下のコマンドを実行してMariaDBサーバーにログインします。プロンプトが表示されたらMariaDBのrootパスワードを入力します。

sudo mariadb -u root -p

次に、以下のクエリを実行して新しいデータベースdokuwikidb、ユーザーdokuwiki、パスワード「p4ssword」を作成します。新しいパスワードに変更してください。

CREATE DATABASE dokuwikidb;  
CREATE USER dokuwiki@localhost IDENTIFIED BY 'p4ssword';  
GRANT ALL PRIVILEGES ON dokuwikidb.* TO dokuwiki@localhost;  
FLUSH PRIVILEGES;

create database user

次に、ユーザーdokuwikiがデータベースdokuwikidbに対する権限を持っていることを確認します。

SHOW GRANTS FOR dokuwiki@localhost;

以下の出力では、ユーザーdokuwikiがデータベースdokuwikidbに対して完全な権限を持つように設定されています。

show dtabase user

最後に、quitと入力してMariaDBサーバーから退出し、次のステップに進みます。

DokuWikiソースコードのダウンロード

このセクションでは、DokuWikiソースコードをダウンロードし、適切な権限でインストールディレクトリを設定します。

/var/www/ディレクトリに移動し、以下のwgetコマンドを使用してDokuWikiの最新の安定版をダウンロードします。

cd /var/www/  
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

次に、ファイルdokuwiki-stable.tgzを抽出し、抽出したディレクトリの名前をdokuwikiに変更します。これにより、DokuWikiのインストールディレクトリは/var/www/dokuwikiに配置されます。

tar xzvf dokuwiki-stable.tgz  
sudo mv dokuwiki-*a dokuwiki

最後に、以下のコマンドを実行して/var/www/dokuwikiディレクトリの所有権をユーザーwww-dataおよびグループwww-dataに変更します。これにより、Apache2ウェブサーバーがDokuWikiソースコードを読み取れるようになります。

sudo chown -R www-data:www-data /var/www/dokuwiki

Apache2仮想ホストの設定

DokuWikiをダウンロードした後、DokuWikiを実行するための新しいApache2仮想ホストファイルを作成します。ドメイン名が準備できていることを確認してください。この例では、ドメインwiki.howtoforge.localを使用します。

次に、以下のnanoエディタコマンドを実行して新しいApache2仮想ホスト設定/etc/apache2/sites-available/dokuwiki.confを作成します。

sudo nano /etc/apache2/sites-available/dokuwiki.conf

以下の設定を挿入し、ドメイン名wiki.howtoforge.localをあなたのドメインに変更してください。

  
    ServerName    wiki.howtoforge.local        
    DocumentRoot  /var/www/dokuwiki  
  
      
          
            AllowOverride All  
            Require all denied  
          
          
            Order allow,deny  
            Deny from all  
          
      
  
    ErrorLog   /var/log/apache2/wiki.howtoforge.local_error.log  
    CustomLog  /var/log/apache2/wiki.howtoforge.local_access.log combined

完了したら、ファイルを保存して閉じます。

次に、以下のコマンドを実行してdokuwiki.conf仮想ホストを有効にし、Apacheの構文を確認してエラーがないことを確認します。

sudo a2ensite dokuwiki.conf  
sudo apachectl configtest

構文が正しく、エラーがない場合、「Syntax OK」という出力が表示されます。

setup apache2

最後に、以下のコマンドを実行してApache2サーバーを再起動し、変更を適用します。

sudo systemctl restart apache2

SSL/TLS証明書でDokuWikiを保護する

この時点で、DokuWikiは実行中でアクセス可能です。しかし、インストールを安全にするために、Letsencryptを介してSSL/TLS証明書を設定します。

以下のcertbotコマンドを実行して、DokuWikiのドメイン名用のSSL/TLS証明書を生成します。メールアドレスとドメイン名をあなたの情報に変更してください。

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

プロセスが完了すると、DokuWikiのインストールは自動的にHTTPSで設定されるはずです。SSL/TLS証明書は/etc/letsencrypt/live/yourdomain.comディレクトリに配置されます。

ウェブインストーラーを介してDokuWikiをインストールする

ウェブブラウザを開き、DokuWikiインストール用のドメイン名（例：https:/wiki.howtoforge.local/install.php）にアクセスします。DokuWikiのウェブインストーラーが表示されるはずです。

ACLを有効にするオプションを選択し、管理ユーザー、メールアドレス、およびDokuWikiのパスワードを入力してから、保存をクリックします。

install dokuwiki

インストールが成功すると、「設定が正常に完了しました。」という出力が表示されるはずです。

installation finished

次に、ターミナルに戻り、以下のコマンドを使用してinstall.phpスクリプトを削除します。

sudo rm /var/www/dokuwiki/install.php

次に、「あなたの新しいDokuWiki」というリンクをクリックして続行します。DokuWikiのホームページが表示されるはずです。

dokuwiki homepage

次に、ログインボタンをクリックすると、DokuWikiのログインページが表示されるはずです。

管理ユーザーとパスワードを入力し、ログインをクリックします。成功すると、DokuWikiのダッシュボードが表示されます。

dockuwiki dashboard

結論

おめでとうございます！Debian 12サーバーにDokuWikiのインストールが完了しました。LAMPスタック（Apache2、MariaDB、PHP）を使用してDokuWikiをインストールしました。また、UFW（Uncomplicated Firewall）とLetsencryptからのSSL/TLS証明書でDokuWikiのインストールを保護しました。