查看“︁Help:MediaWiki安装指南”︁的源代码

本页给出通用安装流程，并提供本站当前环境可复用的参数示例。实际部署请以官方文档为准。

== 参考环境 ==
* 操作系统：Debian 12
* Web 服务器：Nginx
* PHP：8.2（PHP-FPM）
* 数据库：MariaDB 10.11

== 1. 安装系统依赖 ==
<syntaxhighlight lang="bash">
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
</syntaxhighlight>

== 2. 下载并解压 MediaWiki ==
<syntaxhighlight lang="bash">
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
</syntaxhighlight>

== 3. 创建数据库与账号 ==
<syntaxhighlight lang="sql">
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;
</syntaxhighlight>

== 4. 运行安装向导 ==
访问：<code>https://你的域名/mw-config/</code>

完成后将生成的 <code>LocalSettings.php</code> 放入站点根目录。

== 5. 关键配置示例 ==
<syntaxhighlight lang="php">
$wgScriptPath = '';
$wgArticlePath = '/wiki/$1';
</syntaxhighlight>

== 6. 常用安装后维护 ==
<syntaxhighlight lang="bash">
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
</syntaxhighlight>

== 7. 安全与排错 ==
* 确保 <code>LocalSettings.php</code> 权限最小化。
* 上传失败时检查 PHP 上传大小限制与目录权限。
* 页面无法渲染时优先检查 PHP-FPM 与 Nginx 日志。

== 官方文档 ==
* https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki

{{Template:站点帮助文档}}
[[Category:帮助文档]]