帮助:MediaWiki安装指南：修订间差异

以互动方式浏览历史

删除的内容添加的内容

可视化wikitext

行内

2026年5月21日 (四) 11:18的最新版本

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

参考环境

操作系统：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

@@ 第1行： / 第1行： @@
+本页给出通用安装流程，并提供本站当前环境可复用的参数示例。实际部署请以官方文档为准。
-这个页面介绍了本站的 MediaWiki 的安装笔记.
-== 基本环境的安装 ==
-=== 系统 ===
-==== 系统版本 ====
-<code>cat /etc/os-release # 显示发行版的详细信息</code>
+== 参考环境 ==
-<code>PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"</code>
-==== 系统更新 ====
+* 操作系统：Debian 12
+* Web 服务器：Nginx
-<code>sudo apt update # 更新包索引</code>
+* PHP：8.2（PHP-FPM）
+* 数据库：MariaDB 10.11
+== 1. 安装系统依赖 ==
-<code>sudo apt upgrade # sudo apt upgrade</code>
+<syntaxhighlight lang="bash">
-=== 宝塔面板 ===
+sudo apt update && sudo apt upgrade -y
-Linux面板安装脚本,正式版：9.4.0
+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 ==
-<code>wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh && bash install_panel.sh ed8484bec</code>
+<syntaxhighlight lang="bash">
-=== 环境 ===
+cd /var/www
-==== PHP ====
+wget https://releases.wikimedia.org/mediawiki/1.45/mediawiki-1.45.0.tar.gz
-<code>php -v</code>
+tar -xzvf mediawiki-1.45.0.tar.gz
+mv mediawiki-1.45.0 mediawiki
+</syntaxhighlight>
+== 3. 创建数据库与账号 ==
-<code>PHP 8.2.26 (cli) (built: Nov 25 2024 17:21:51) (NTS)</code>
+<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>which php</code>
+访问：<code>https://你的域名/mw-config/</code>
-<code>/usr/bin/php</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:帮助文档]]

阅读	移动优化
编辑	维基化 · 快速指南 · 编辑页面 · 图片指南 · 编辑摘要 · 编辑冲突
高级编辑	站点分类 · 站点模板 · 模板编写指南 · 模板样式 · 解析函数
协作	历史与回退 · 保护页面
个人定制	定制消息 · Gadget
管理	学习指南 · 怎样的页面才会被计算为"文章页" · MediaWiki安装指南 · 扩展语法与格式示例