說明:MediaWiki安裝指南

MediaWiki安裝指南

本頁給出通用安裝流程，並提供本站當前環境可復用的參數示例。實際部署請以官方文檔為準。

參考環境

• 作業系統：Debian 12
• Web 伺服器：Nginx
• PHP：8.2（PHP-FPM）
• 資料庫：MariaDB 10.11

1. 安裝系統依賴

sudo apt update && sudo apt upgrade -y
sudo apt install nginx mariadb-server php8.2-fpm php8.2-cli php8.2-mysql php8.2-gd php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip php8.2-intl php8.2-apcu unzip git -y

2. 下載並解壓 MediaWiki

cd /var/www
wget https://releases.wikimedia.org/mediawiki/1.45/mediawiki-1.45.0.tar.gz
tar -xzvf mediawiki-1.45.0.tar.gz
mv mediawiki-1.45.0 mediawiki

3. 創建資料庫與帳號

CREATE DATABASE my_wiki CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY '强密码';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost';
FLUSH PRIVILEGES;

4. 運行安裝嚮導

訪問：https://你的域名/mw-config/

完成後將生成的 LocalSettings.php 放入站點根目錄。

5. 關鍵配置示例

$wgScriptPath = '';
$wgArticlePath = '/wiki/$1';

6. 常用安裝後維護

php /var/www/mediawiki/maintenance/run.php update.php
php /var/www/mediawiki/maintenance/run.php rebuildrecentchanges.php
php /var/www/mediawiki/maintenance/run.php refreshLinks.php
php /var/www/mediawiki/maintenance/run.php runJobs.php

7. 安全與排錯

• 確保 `LocalSettings.php` 權限最小化。
• 上傳失敗時檢查 PHP 上傳大小限制與目錄權限。
• 頁面無法渲染時優先檢查 PHP-FPM 與 Nginx 日誌。

官方文檔

• https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki