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

MediaWikiは、WikipediaやWikimediaなどの最大のウィキサイトで使用されるオープンソースのウィキソフトウェアです。これは、コラボレーションおよびドキュメンテーションプラットフォームとして使用できる無料のウィキソフトウェアです。強力でスケーラブルで、機能が豊富なウィキ実装です。

このチュートリアルでは、Debian 12サーバーにLAMPスタック（Apache、MariaDB、PHP）を使用してMediaWikiをインストールする方法を示します。さらに、CertbotとLetsencryptを使用してMediaWikiをHTTPSで保護する方法も示します。

前提条件

始める前に、次のものを用意してください：

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

LAMPスタックのインストール

MediaWikiは、データストアとしてMySQL/MariaDBを使用するPHPベースのオープンソースソフトウェアです。現在、MediaWikiの安定版（1.41）は、少なくともPHP 7.3.4以上とMariaDB 10.3.0を必要とします。Webサーバーとしては、ApacheまたはNginxのいずれかを使用できます。

このセクションでは、MediaWikiインストールを実行するために使用されるLAMPスタック（Apache、MariaDB、PHP）をインストールします。

まず、次のコマンドでDebianリポジトリを更新します。

sudo apt update

リポジトリが更新されたら、以下のコマンドでLAMPスタックの依存関係をインストールします。インストールを確認するためにYを入力します。

sudo apt install apache2 mariadb-server imagemagick libapache2-mod-php php php-common php-intl php-xml php-curl php-gd php-mbstring php-mysql php-apcu

install deps

インストールが完了したら、ApacheとMariaDBサービスを確認して、両方のサービスが実行されていることを確認します。

以下のコマンドでApacheウェブサーバーを確認します。出力がenabledであれば、Apacheが有効であり、起動時に自動的に開始されることが確認されます。実行中の場合、出力はactive (running)となります。

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

verify apache2

次に、以下のコマンドでMariaDBデータベースサーバーを確認します。出力は似たようなもので、出力がenabledであればMariaDBが有効であり、active (running)であればMariaDBが実行中であることを確認します。

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

verify mariadb

最後に、以下のコマンドでPHPのバージョンを確認し、有効なモジュールのリストを表示します。DebianサーバーにインストールされているPHP 8.2が表示されます。

php -v  
php -m

verify php

PHPの設定

LAMPスタックをインストールした後、php.iniファイルを編集してMediaWiki用のいくつかのデフォルトパラメータを変更することでPHPインストールを設定します。

PHPを設定するには、以下のnanoエディタコマンドでPHP設定ファイル/etc/php/8.2/apache2/php.iniを開きます。

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

以下の設定にデフォルト構成を変更し、date.timezoneとmemory_limitを現在の環境に合わせて調整してください。

date.timezone = Europe/Amsterdam  
upload_max_filesize = 80M  
memory_limit = 512M  
max_execution_time = 360

ファイルを保存して終了します。

次に、以下のコマンドを実行してApacheサービスを再起動し、変更を適用します。

sudo systemctl restart apache2

MariaDBサーバーの設定

PHPが設定されたら、次のステップはMariaDBサーバーを保護し、MediaWiki用の新しいデータベースとユーザーを作成することです。この例では、コマンドラインのmariadb-secure-installationを利用してMariaDBサーバーを保護し、MariaDBクライアントを介して新しいデータベースとユーザーを作成します。

MariaDBサーバーのインストールを保護するには、以下のmariadb-secure-installationコマンドを実行します。

sudo mariadb-secure-installation

新しい設定をMariaDBサーバーに受け入れるためにYを入力するか、拒否するためにnを入力します：

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

MariaDBサーバーの展開が保護されたら、以下のmariadbコマンドを使用してMariaDBサーバーにログインします。プロンプトが表示されたらMariaDBのrootパスワードを入力します。

sudo mariadb -u root -p

次に、MediaWiki用の新しいMariaDBデータベースとユーザーを作成するために以下のクエリを実行します。この例では、新しいデータベースmediawikidb、ユーザーmediawiki、パスワードmediawikipassdbを作成します。以下の内容は自分の資格情報に合わせて調整できます。

CREATE DATABASE mediawikidb;  
CREATE USER mediawiki@localhost IDENTIFIED BY 'mediawikipassdb';  
GRANT ALL ON mediawikidb.* TO mediawiki@localhost WITH GRANT OPTION;  
FLUSH PRIVILEGES;

create database and user

次に、以下のクエリを実行してMariaDBユーザーmediawikiの権限を確認します。ユーザーmediawikiがデータベースmediawikidbにアクセスできることを確認します。

SHOW GRANTS FOR mediawiki@localhost;

最後に、終了したらquitと入力してMariaDBから退出します。

check user privileges

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

依存関係がインストールされ、設定されたので、MediaWikiをインストールできます。MediaWikiには、安定版、レガシー版、LTS版の複数のバージョンがあります。この場合、MediaWikiの最新の安定版1.41をインストールします。

/var/wwwディレクトリに移動し、以下のwgetコマンドを使用してMediaWikiのソースコードをダウンロードします。MediaWikiのダウンロードページを訪れて最新バージョンを取得してください。

cd /var/www/  
wget https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.0.tar.gz

ダウンロードが完了したら、以下のコマンドでソースコードを抽出します。その後、抽出したディレクトリの名前をmediawikiに変更します。これにより、MediaWikiのDocumentRootディレクトリは/var/www/mediawikiになります。

tar -xvzf mediawiki-*.tar.gz  
mv mediawiki-*/ mediawiki/

最後に、/var/www/mediawikiディレクトリの所有権をユーザーwww-dataに変更し、パーミッションを0755に変更します。

sudo chown -R www-data:www-data /var/www/mediawiki  
sudo chmod 755 /var/www/mediawiki

Apache仮想ホストの設定

MediaWikiのソースコードをダウンロードしたので、このセクションではMediaWikiを実行するための新しいApache仮想ホストファイルを作成します。サーバーIPアドレスを指すドメイン名を用意してください。商用の場合は公開ドメインを購入するか、ローカルドメイン名を使用できます。

始める前に、以下のコマンドでApacheのリライトモジュールを有効にします。

sudo a2enmod rewrite

次に、新しいApache仮想ホスト設定/etc/apache2/sites-available/mediawiki.confをnanoエディタコマンドで作成します。

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

以下の設定を挿入し、ServerNameオプションを自分のドメイン名とアクセスおよびエラーログのパスに変更してください。

  
  
 ServerName wiki.howtoforge.local  
  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/mediawiki  
  
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log  
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted

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

次に、仮想ホストファイルmediawiki.confを有効にし、以下のコマンドでApacheの構文を確認します。正しいApache構文があれば、Syntax OKのような出力が表示されます。

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

最後に、Apacheウェブサーバーを再起動してMediaWikiの新しい仮想ホストを適用します。再起動後、MediaWikiのインストールが準備完了となります。

sudo systemctl restart apache2

setup apache vhost

HTTPSでMediaWikiを保護する

MediaWikiのApache仮想ホスト設定を作成したので、CertbotとLetsencryptを使用してインストールをHTTPSで保護しましょう。これは公開ドメインを使用している場合にのみ適用されますが、ローカルドメインを使用している場合は自己署名証明書を生成し、手動でHTTPSを適用できます。

以下のコマンドでCertbotとCertbot Apacheプラグインをインストールします。インストールを確認するためにYを入力します。

sudo apt install certbot python3-certbot-apache

インストールが完了したら、以下のcertbotコマンドを実行してMediaWikiのドメイン名用のSSL/TLS証明書を生成します。ドメイン名とメールアドレスは自分の情報に変更してください。

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

プロセスが完了すると、証明書は/etc/letsencrypt/live/domain.comディレクトリに保存され、仮想ホストもHTTPSで設定されます。

MediaWikiのインストール

お好みのWebブラウザを開き、http://wiki.howtoforge.local/のようにドメイン名にアクセスします。すべてがうまくいけば、MediaWikiのウェルカムページが表示されます。ウィキを設定するリンクをクリックします。

setup wiki

MediaWikiのデフォルト言語を選択し、続行をクリックします。

select language

環境チェックでは、システムがMediaWikiの要件を満たしていることを確認します。その後、再度続行をクリックします。

environment check

データベースとしてMariaDBを選択し、名前、ユーザー、パスワードを入力します。次に、続行をクリックして進みます。

db configuration

次に、MediaWikiの管理者ユーザー名、メールアドレス、パスワードを入力し、続行をクリックします。

setup admin

追加設定では、使用したいデフォルトテーマを選択し、続行をクリックしてインストールを進めます。

default settings

続行をクリックしてMediaWikiのインストールを確認します。

confirm the installation

complete

インストールが完了すると、ファイルLocalSettings.phpが自動的にローカルコンピュータにダウンロードされ、MediaWikiインストールディレクトリにファイルをアップロードするための指示が表示されます。

installation finished

ターミナルに戻り、以下のコマンドを実行して新しいファイルLocalSettings.phpを作成します。

sudo -u www-data nano /var/www/mediawiki/LocalSettings.php

ダウンロードしたLocalSettings.phpファイルを開き、PHPコードをサーバーにコピー＆ペーストします。その後、ファイルを保存して終了します。

Webブラウザに戻り、ウィキに入るリンクをクリックします。インストールしたMediaWikiのデフォルトホームページが表示されます。

mediawiki home

結論

おめでとうございます！Debian 12サーバーにMediaWikiを正常にインストールしました。LAMPスタック（Apache、MariaDB、PHP）を使用してMediaWikiをインストールし、LetsencryptからHTTPSでMediaWikiを保護しました。