帮助:MediaWiki安装指南 - 版本历史

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

2026-05-21T03:18:10Z

帮助命名空间规范化：移除一级标题并修正渲染安全写法

←上一版本		2026年5月21日 (四) 11:18的版本
第1行：		第1行：
	= MediaWiki安装指南 =
	本页给出通用安装流程，并提供本站当前环境可复用的参数示例。实际部署请以官方文档为准。		本页给出通用安装流程，并提供本站当前环境可复用的参数示例。实际部署请以官方文档为准。

第50行：		第49行：

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

Maintenance script：统一帮助命名空间内容风格与结构

2026-05-21T03:09:45Z

统一帮助命名空间内容风格与结构

显示更改

Move page script：Move page script移动页面帮助:MediaWiki 安装至帮助:MediaWiki安装指南：统一帮助命名空间标题命名规范

2026-05-21T03:06:41Z

Move page script移动页面帮助:MediaWiki 安装至帮助:MediaWiki安装指南：统一帮助命名空间标题命名规范

←上一版本	2026年5月21日 (四) 11:06的版本
（没有差异）

Maintenance script：基于本站实际配置统一校对安装说明

2026-01-12T15:04:48Z

基于本站实际配置统一校对安装说明

显示更改

Maintenance script：按当前站点实际配置更新更新与依赖

2026-01-12T15:00:26Z

按当前站点实际配置更新更新与依赖

←上一版本		2026年1月12日 (一) 23:00的版本
第15行：		第15行：

	=== 更新与依赖 ===		=== 更新与依赖 ===
			根据本站当前部署（Debian 12 + Nginx + PHP 8.2 FPM + MySQL），建议按以下方式更新与安装依赖：
	在安装前先更新软件包并安装基本依赖：<syntaxhighlight lang="bash">
			<syntaxhighlight lang="bash">
	sudo apt update && sudo apt upgrade -y		sudo apt update && sudo apt upgrade -y
	sudo apt install ~~apache2~~ mysql-server ~~php~~ ~~php~~-cli ~~php~~-mysql ~~php~~-gd ~~php~~-mbstring ~~php~~-xml ~~php~~-curl ~~php~~-~~json~~ ~~php~~-~~zip~~ unzip git -y		sudo apt install nginx mysql-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
			# 多媒体与差异对比工具
			sudo apt install ffmpeg poppler-utils imagemagick php-wikidiff2 -y
	</syntaxhighlight>		</syntaxhighlight>
	如需 HTTPS，可同时安装 certbot/openssl 等工具，稍后用于申请证书或配置自签名证书。

			如需启用 Lua/时间线/乐谱等扩展，可按需补充：
			<syntaxhighlight lang="bash">
			# Scribunto
			sudo apt install php-luasandbox -y
			# EasyTimeline/Score 等
			sudo apt install perl ploticus lilypond ghostscript -y
			</syntaxhighlight>

			说明：本站使用 Nginx，如需 Apache 请改用对应包与配置；PHP-FPM 请确保与 Nginx 配置匹配。
	== 安装步骤 ==		== 安装步骤 ==
	=== 1. 下载 MediaWiki ===		=== 1. 下载 MediaWiki ===

Maintenance script：更新安装指南为通用步骤

2025-12-26T13:10:35Z

更新安装指南为通用步骤

←上一版本	2025年12月26日 (五) 21:10的版本
第1行：	第1行：
		'''说明''' 本指南结合 MediaWiki 官方文档与实际部署经验，概述典型的安装流程。请始终以 [https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki 官方安装指南] 为权威来源，并根据自己的环境调整命令与路径。

		== 环境准备 ==
		=== 系统与组件 ===
		确保服务器运行受支持的 Linux 发行版，例如 Debian 11/12、Ubuntu 22.04 及以上版本，或其他受 MediaWiki 官方支持的发行版。
		* 查看系统版本：<syntaxhighlight lang="bash">
		cat /etc/os-release
		</syntaxhighlight>
		* 检查 PHP、MySQL 与 HTTP 服务器版本：<syntaxhighlight lang="bash">
		php -v
		mysql --version
		apachectl -v
		</syntaxhighlight>
		建议使用 PHP 8.1/8.2、MySQL 8.0 或 MariaDB 10.6+，并将 Web 服务器的用户（如 www-data、apache）纳入后续目录权限管理。

		=== 更新与依赖 ===
		在安装前先更新软件包并安装基本依赖：<syntaxhighlight lang="bash">
		sudo apt update && sudo apt upgrade -y
		sudo apt install apache2 mysql-server php php-cli php-mysql php-gd php-mbstring php-xml php-curl php-json php-zip unzip git -y
		</syntaxhighlight>
		如需 HTTPS，可同时安装 certbot/openssl 等工具，稍后用于申请证书或配置自签名证书。

		== 安装步骤 ==
		=== 1. 下载 MediaWiki ===
		从官方 https://releases.wikimedia.org 下载当前稳定版本。示例命令：<syntaxhighlight lang="bash">
		cd /var/www
		wget https://releases.wikimedia.org/mediawiki/1.44/mediawiki-1.44.0.tar.gz
		tar -xzvf mediawiki-1.44.0.tar.gz
		mv mediawiki-1.44.0 mediawiki
		</syntaxhighlight>
		部署后可将目录权限授予 Web 用户，例如：<code>chown -R www-data:www-data /var/www/mediawiki</code>。

		=== 2. 创建数据库与用户 ===
		登录 MySQL 创建专用数据库与账号：<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>
		建议使用长密码、避免写入命令历史（可在 <code>.mysql_history</code> 中禁用）并定期更换凭据。

		=== 3. 运行安装向导 ===
		在浏览器打开 <code>http://<你的域名或IP>/mediawiki/mw-config/</code>，安装向导会依次要求填写环境检测、数据库信息、站点名称、管理员账号、上传目录等。
		在“数据库”步骤中填写上一步创建的数据库信息。按照提示完成后会生成 <code>LocalSettings.php</code>，请下载到本地后上传到 MediaWiki 根目录。

		=== 4. 完成安装与安全加固 ===
		上传 LocalSettings 后即可通过 <code>http://<域名>/mediawiki</code> 访问。
		* 删除或锁定安装目录：<code>chmod -R 700 /var/www/mediawiki/mw-config</code>
		* 确保 <code>LocalSettings.php</code> 权限为 600，Web 服务器可读。
		* 关闭 config 目录的写权限：<syntaxhighlight lang="bash">
		chmod a-w /var/www/mediawiki/config
		</syntaxhighlight>

		== 后续依赖与扩展 ==
		=== php-wikidiff2 ===
		改善差异显示，安装命令：<syntaxhighlight lang="bash">
		sudo apt install php-wikidiff2 -y
		</syntaxhighlight>
		配置：<syntaxhighlight lang="php">
		$wgDiffEngine = 'wikidiff2';
		$wgDiff3 = '/usr/bin/diff3';
		</syntaxhighlight>

		=== php-luasandbox 与 Scribunto ===
		安装 Lua 沙箱：<syntaxhighlight lang="bash">
		sudo apt install php-luasandbox -y
		</syntaxhighlight>
		启用扩展：<syntaxhighlight lang="php">
		wfLoadExtension('Scribunto');
		$wgScribuntoEngineConf['luasandbox']['memoryLimit'] = 50 * 1024 * 1024;
		</syntaxhighlight>

		=== 多媒体工具 ===
		* ffmpeg：<code>sudo apt install ffmpeg -y</code>
		* poppler-utils（PDF 处理）：<code>sudo apt install poppler-utils -y</code>
		* Composer（依赖管理）：<code>curl -sS https://getcomposer.org/installer \| php && mv composer.phar /usr/local/bin/composer</code>
		* EasyTimeline/Score/PdfHandler 等扩展可根据需要分别安装 ploticus、perl、lilypond、ghostscript、imagemagick 等依赖。

		== HTTPS 与短链接 ==
		配置 Apache 使其同时支持短链接与 https，可在虚拟主机中加入：<syntaxhighlight lang="apache">
		RewriteEngine On
		RewriteCond %{HTTPS} off
		RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
		RewriteCond %{REQUEST_URI} !\.(css\|js\|png\|jpg\|jpeg\|gif\|ico\|svg\|woff\|woff2\|ttf\|eot\|less)$ [NC]
		RewriteCond %{REQUEST_URI} !^/load.php [NC]
		RewriteCond %{REQUEST_URI} !^/api.php [NC]
		RewriteCond %{REQUEST_URI} !^/images/ [NC]
		RewriteRule ^w/(.*)$ /mediawiki/index.php?title=$1 [L,QSA]
		RewriteCond %{REQUEST_FILENAME} !-f
		RewriteCond %{REQUEST_FILENAME} !-d
		RewriteRule ^(.*)$ /mediawiki/index.php [L,QSA]
		</syntaxhighlight>
		配合以下 LocalSettings：<syntaxhighlight lang="php">
		$wgScriptPath = '/mediawiki';
		$wgArticlePath = '/w/$1';
		$actions = [ 'view','edit','history','delete','purge','info','watch','unwatch','protect','rollback'];
		foreach ($actions as $action) {
		$wgActionPaths[$action] = '/w/' . $action . '/$1';
		}
		$wgActionPaths['view'] = $wgArticlePath;
		</syntaxhighlight>

		== 性能与维护 ==
		* 使用缓存（APCu/Redis）加速页面与消息
		* 启用 <code>wgMainCacheType</code>、<code>wgParserCacheType</code> 等缓存参数
		* 定期运行维护脚本：<syntaxhighlight lang="bash">
		php maintenance/run.php update.php
		php maintenance/run.php rebuildrecentchanges.php
		php maintenance/run.php refreshLinks.php
		php maintenance/run.php rebuildtextindex.php
		php maintenance/run.php runJobs.php
		</syntaxhighlight>
		建议将常用脚本加入 cron，如每日凌晨自动执行，以减轻手动干预。

		== 故障排查 ==
		* 页面渲染成 WikiText：检查 PHP-FPM/Apache 是否正常、LocalSettings 是否可读
		* 安装向导无法完成：检查文件夹权限，确保 <code>mw-config</code> 可写且临时可执行
		* 文件上传失败：核实 <code>images/</code> 权限、PHP 限制与 <code>$wgFileExtensions</code> 设置
		* 数据库连接出错：确认凭据、字符集（utf8mb4）及正确的数据库主机

		{{Template:站点帮助文档}}

Maintenance script：更新安装指南为通用步骤

2025-12-26T13:08:49Z

更新安装指南为通用步骤

显示更改

Maintenance script：校对修改：修复强调文本前后多余空格、不一致的空格等问题

2025-12-26T12:11:11Z

校对修改：修复强调文本前后多余空格、不一致的空格等问题

显示更改

Maintenance script：校对修改：修复强调文本前后多余空格、不一致的空格等问题

2025-12-26T12:07:42Z

校对修改：修复强调文本前后多余空格、不一致的空格等问题

←上一版本		2025年12月26日 (五) 20:07的版本
第1行：		第1行：
	'''注意：''' 此笔记基于 MediaWiki 官方手册及其他网络教程校对，适用于在 Debian Linux 服务器（使用宝塔面板）上安装 MediaWiki。		'''注意：'''此笔记基于 MediaWiki 官方手册及其他网络教程校对，适用于在 Debian Linux 服务器（使用宝塔面板）上安装 MediaWiki。

	== 服务器配置 ==		== 服务器配置 ==

	'''服务器提供商''': [https://cloud.tencent.com/product/lighthouse 腾讯云]-轻量云（轻量应用服务器）		'''服务器提供商''': [https://cloud.tencent.com/product/lighthouse 腾讯云]-轻量云（轻量应用服务器）

第35行：		第34行：
	=== 服务器软件 ===		=== 服务器软件 ===

	* '''[https://www.bt.cn/new/download.html 宝塔Linux面板]''' : 7.9.8		* '''[https://www.bt.cn/new/download.html 宝塔Linux面板]''': 7.9.8
	* '''[https://httpd.apache.org/ Apache httpd]''': 2.4.65		*'''[https://httpd.apache.org/ Apache httpd]''': 2.4.65
	* '''MySQL''': 8.0.36 (MediaWiki 最低要求 5.7。大内存机器可考虑 8.0+，官方也推荐 MongoDB)		* '''MySQL''': 8.0.36 (MediaWiki 最低要求 5.7。大内存机器可考虑 8.0+，官方也推荐 MongoDB)
	* '''PHP''': 8.2.29 (MediaWiki 1.44.0 支持 PHP 8.1 - 8.3，推荐使用 8.2)		* '''PHP''': 8.2.29 (MediaWiki 1.44.0 支持 PHP 8.1 - 8.3，推荐使用 8.2)
第266行：		第265行：
	=== MySQL 配置建议 ===		=== MySQL 配置建议 ===

	* 将所有表转换为 '''InnoDB''' 存储引擎。		* 将所有表转换为 '''InnoDB'''存储引擎。
	* 使用 <code>utf8mb4</code> 字符集以支持更广泛的 Unicode 字符。		* 使用 <code>utf8mb4</code> 字符集以支持更广泛的 Unicode 字符。

	=== PHP 配置 ===		=== PHP 配置 ===

	'''需要启用的扩展'''：		'''需要启用的扩展'''：
	通过宝塔面板的 PHP 管理界面或编辑 <code>php.ini</code>，确保以下扩展已启用（大部分可能已默认安装或启用）：		通过宝塔面板的 PHP 管理界面或编辑 <code>php.ini</code>，确保以下扩展已启用（大部分可能已默认安装或启用）：

Maintenance script：修复格式问题和内容准确性，包括链接格式、版本兼容性、配置文件完整性

2025-12-26T11:36:24Z

修复格式问题和内容准确性，包括链接格式、版本兼容性、配置文件完整性

←上一版本		2025年12月26日 (五) 19:36的版本
第35行：		第35行：
	=== 服务器软件 ===		=== 服务器软件 ===

	* '''[https://www.bt.cn/new/download.html 宝塔Linux面板]''' : 7.9.8 ~~(注：您提供的版本号 11.2.0 与命令中显示的 7.9.8 不一致，请以实际为准)~~		* '''[https://www.bt.cn/new/download.html 宝塔Linux面板]''' : 7.9.8
	* '''~~Apache~~[httpd]''': 2.4.65		* '''[https://httpd.apache.org/ Apache httpd]''': 2.4.65
	* '''MySQL''': 8.0.36 (MediaWiki 最低要求 5.7。大内存机器可考虑 8.0+，官方也推荐 MongoDB)		* '''MySQL''': 8.0.36 (MediaWiki 最低要求 5.7。大内存机器可考虑 8.0+，官方也推荐 MongoDB)
	* '''PHP''': 8.2.29 (MediaWiki ~~最低要求~~ 8.1)		* '''PHP''': 8.2.29 (MediaWiki 1.44.0 支持 PHP 8.1 - 8.3，推荐使用 8.2)
	* '''[https://www.phpmyadmin.net/downloads/ phpMyAdmin]''': 5.2（可通过宝塔安装）		* '''[https://www.phpmyadmin.net/downloads/ phpMyAdmin]''': 5.2（可通过宝塔安装）

第217行：		第217行：
	RewriteCond %{REQUEST_URI} !^/images/ [NC]		RewriteCond %{REQUEST_URI} !^/images/ [NC]

	# 重写 wiki 页面路径~~（建议使用 /w/ 而非 /w/ ）~~		# 重写 wiki 页面路径
	RewriteRule ^w/(.*)$ /index.php?title=$1 [L,QSA]		RewriteRule ^w/(.*)$ /index.php?title=$1 [L,QSA]

第256行：		第256行：
	# 设置安全头		# 设置安全头
	Header always set X-Content-Type-Options "nosniff"		Header always set X-Content-Type-Options "nosniff"
			</Directory>
	</syntaxhighlight>		</syntaxhighlight>
	设置目录权限：		设置目录权限：

帮助:MediaWiki安装指南 - 版本历史

Maintenance script：​帮助命名空间规范化：移除一级标题并修正渲染安全写法

Maintenance script：​统一帮助命名空间内容风格与结构

Move page script：​Move page script移动页面帮助:MediaWiki 安装至帮助:MediaWiki安装指南：​统一帮助命名空间标题命名规范

Maintenance script：​基于本站实际配置统一校对安装说明

Maintenance script：​按当前站点实际配置更新更新与依赖

Maintenance script：​更新安装指南为通用步骤

Maintenance script：​更新安装指南为通用步骤

Maintenance script：​校对修改：修复强调文本前后多余空格、不一致的空格等问题

Maintenance script：​校对修改：修复强调文本前后多余空格、不一致的空格等问题

Maintenance script：​修复格式问题和内容准确性，包括链接格式、版本兼容性、配置文件完整性

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

Maintenance script：统一帮助命名空间内容风格与结构

Move page script：Move page script移动页面帮助:MediaWiki 安装至帮助:MediaWiki安装指南：统一帮助命名空间标题命名规范

Maintenance script：基于本站实际配置统一校对安装说明

Maintenance script：按当前站点实际配置更新更新与依赖

Maintenance script：更新安装指南为通用步骤

Maintenance script：更新安装指南为通用步骤

Maintenance script：校对修改：修复强调文本前后多余空格、不一致的空格等问题

Maintenance script：校对修改：修复强调文本前后多余空格、不一致的空格等问题

Maintenance script：修复格式问题和内容准确性，包括链接格式、版本兼容性、配置文件完整性