帮助: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