帮助:MediaWiki 安装：修订间差异
来自陋室
更多操作
删除的内容 添加的内容
修改内容 |
Maintenance script（留言 | 贡献） 基于本站实际配置统一校对安装说明 |
||
| （未显示2个用户的9个中间版本） | |||
| 第1行： | 第1行： | ||
'''说明''' 本指南结合 MediaWiki 官方文档与实际部署经验，概述通用安装流程，并结合本站（learn.houjue.digital）当前环境给出可直接复用的参数与命令。请始终以 [https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki 官方安装指南] 为权威来源，并根据自己的环境调整命令与路径。 |
|||
这个页面介绍了本站的 [[mw:Download|MediaWiki]] 的安装笔记. |
|||
== |
== 环境准备 == |
||
=== 系统与组件 === |
|||
本站当前运行环境如下（可按需替换为你的实际版本）： |
|||
* 操作系统：Debian 12 (bookworm) |
|||
* Web 服务器：Nginx 1.22.x |
|||
* PHP：8.2.x（PHP-FPM） |
|||
* 数据库：MariaDB 10.11.x |
|||
常用版本检查命令： |
|||
'''服务器提供商''': [https://cloud.tencent.com/ 腾讯云]-轻量云（轻量应用服务器） |
|||
'''地域和可用区''': 新加坡 | 新加坡一区 |
|||
'''实例规格''': |
|||
* '''CPU''': 2 核 |
|||
* '''内存''': 2GB |
|||
* '''系统盘''': SSD 云硬盘 50GB |
|||
* '''流量包''': 1024GB/月（峰值带宽 30Mbps） |
|||
== 服务器环境 == |
|||
=== 操作系统 === |
|||
'''镜像名称''': [https://www.debian.org/distrib/ Debian] |
|||
'''操作系统''': Debian 12.0 64bit |
|||
<syntaxhighlight lang="bash"> |
<syntaxhighlight lang="bash"> |
||
cat /etc/os-release |
cat /etc/os-release |
||
nginx -v |
|||
sudo apt update |
|||
sudo apt upgrade |
|||
</syntaxhighlight> |
|||
=== 服务器软件 === |
|||
* '''[https://www.bt.cn/new/download.html 宝塔Linux面板]''' : 正式版 9.4.0 |
|||
<syntaxhighlight lang="bash"> |
|||
wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh && bash install_panel.sh ed8484bec |
|||
</syntaxhighlight> |
|||
* '''Apache [https://httpd.apache.org/download.cgi httpd] 2.4.62 (PHP+fpm)''' |
|||
<syntaxhighlight lang="bash"> |
|||
which apache2 |
|||
apache2 -v |
|||
</syntaxhighlight> |
|||
* '''[https://dev.mysql.com/downloads/windows/installer/ MySQL 5.7.44]'''（MediaWiki 最低要求 5.7，大内存机器首选 8.0+，官方推荐 MongoDB） |
|||
<syntaxhighlight lang="bash"> |
|||
which mysql |
|||
systemctl status mysql |
|||
</syntaxhighlight> |
|||
* '''[https://www.php.net/downloads.php PHP] 8.2.27'''（MediaWiki 最低要求 8.1） |
|||
<syntaxhighlight lang="bash"> |
|||
which php |
|||
php -v |
php -v |
||
mysql --version |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
=== 更新与依赖 === |
|||
* '''[https://www.phpmyadmin.net/downloads/ phpMyAdmin] 5.2'''（可通过宝塔安装） |
|||
根据本站当前部署（Debian 12 + Nginx + PHP 8.2 FPM + MariaDB），建议按以下方式更新与安装依赖： |
|||
== 服务器依赖 == |
|||
=== php-[[mw:Wikidiff2|wikidiff2]] === |
|||
<syntaxhighlight lang="bash"> |
<syntaxhighlight lang="bash"> |
||
sudo apt update && sudo apt upgrade -y |
|||
apt-get install php-wikidiff2 |
|||
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 |
|||
find /usr/lib/ -name wikidiff2.so |
|||
# 多媒体与差异对比工具 |
|||
nano /www/server/php/82/etc/php.ini |
|||
sudo apt install ffmpeg poppler-utils imagemagick php-wikidiff2 -y |
|||
extension=/usr/lib/php/20220829/wikidiff2.so |
|||
php -m | grep wikidiff2 |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
如需启用 Lua/时间线/乐谱等扩展，可按需补充： |
|||
<syntaxhighlight lang="php"> |
|||
$wgDiffEngine = "wikidiff2"; |
|||
$wgDiff3 = "/usr/bin/diff3"; |
|||
</syntaxhighlight> |
|||
=== php-[https://www.mediawiki.org/wiki/LuaSandbox luasandbox] === |
|||
<syntaxhighlight lang="bash"> |
<syntaxhighlight lang="bash"> |
||
# Scribunto |
|||
sudo apt update |
|||
sudo apt install php-luasandbox -y |
sudo apt install php-luasandbox -y |
||
# EasyTimeline/Score 等 |
|||
find /usr/lib/php/ -name "luasandbox.so" |
|||
sudo apt install perl ploticus lilypond ghostscript -y |
|||
nano /www/server/php/82/etc/php.ini |
|||
extension=/usr/lib/php/20220829/luasandbox.so |
|||
php -m | grep luasandbox |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
说明：本站使用 Nginx + PHP-FPM，如需 Apache 请改用对应包与配置；PHP-FPM 请确保与 Nginx 配置匹配。 |
|||
<syntaxhighlight lang="php"> |
|||
wfLoadExtension( 'Scribunto' ); |
|||
$wgScribuntoEngineConf['luasandbox']['memoryLimit'] = 50 * 1024 * 1024; |
|||
</syntaxhighlight> |
|||
=== [https://ffmpeg.org/download.html ffmpeg] 6.1（可通过宝塔安装） === |
|||
== 安装步骤 == |
|||
=== 1. 下载 MediaWiki（通用流程） === |
|||
从官方 https://releases.wikimedia.org 下载当前稳定版本。示例命令： |
|||
<syntaxhighlight lang="bash"> |
<syntaxhighlight lang="bash"> |
||
cd /var/www |
|||
which ffmpeg |
|||
wget https://releases.wikimedia.org/mediawiki/1.45/mediawiki-1.45.0.tar.gz |
|||
ffmpeg -version |
|||
tar -xzvf mediawiki-1.45.0.tar.gz |
|||
mv mediawiki-1.45.0 mediawiki |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
本站实际路径：<code>/var/www/mediawiki</code>，Web 用户为 <code>www-data</code>。 |
|||
=== [https://getcomposer.org/download/ Composer] === |
|||
=== 2. 创建数据库与用户（通用流程） === |
|||
<syntaxhighlight lang="bash"> |
|||
登录数据库创建专用数据库与账号： |
|||
composer update --no-dev |
|||
<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> |
</syntaxhighlight> |
||
本站实际数据库配置（见 <code>/var/www/learn.php</code>）： |
|||
== MediaWiki 插件依赖 == |
|||
* 数据库：<code>learn</code> |
|||
* 用户：<code>learn</code> |
|||
* 主机：<code>localhost</code> |
|||
=== 3. 运行安装向导（通用流程） === |
|||
=== [[mw:Extension:EasyTimeline|EasyTimeline]] === |
|||
在浏览器打开 <code>https://<你的域名或IP>/mw-config/</code>，安装向导会依次要求填写环境检测、数据库信息、站点名称、管理员账号、上传目录等。 |
|||
完成后会生成 <code>LocalSettings.php</code>，请放到 MediaWiki 根目录。 |
|||
本站实际配置： |
|||
==== [https://ploticus.sourceforge.net/doc/download.html Ploticus] ==== |
|||
* <code>$wgServer = "https://learn.houjue.digital";</code> |
|||
* <code>$wgScriptPath = "";</code> |
|||
* <code>$wgArticlePath = "/wiki/$1";</code> |
|||
* 上传目录：<code>/sgcos/images</code>（映射为 <code>/images</code>） |
|||
=== 4. 完成安装与安全加固（通用流程） === |
|||
上传 LocalSettings 后即可通过站点访问。 |
|||
* 锁定安装目录：<code>chmod -R 700 /var/www/mediawiki/mw-config</code> |
|||
* 确保 <code>LocalSettings.php</code> 权限为 600，Web 服务器可读。 |
|||
* 关闭 config 目录写权限： |
|||
<syntaxhighlight lang="bash"> |
<syntaxhighlight lang="bash"> |
||
chmod a-w /var/www/mediawiki/config |
|||
sudo apt update |
|||
sudo apt install ploticus |
|||
ploticus -version |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
== 后续依赖与扩展 == |
|||
==== [https://www.perl.org/get.html perl] ==== |
|||
=== php-wikidiff2 === |
|||
改善差异显示，安装命令： |
|||
<syntaxhighlight lang="bash"> |
<syntaxhighlight lang="bash"> |
||
sudo apt |
sudo apt install php-wikidiff2 -y |
||
sudo apt install perl |
|||
perl -v |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
配置： |
|||
<syntaxhighlight lang="php"> |
<syntaxhighlight lang="php"> |
||
$wgDiffEngine = 'wikidiff2'; |
|||
$wgTimelinePloticusCommand = '/usr/bin/ploticus'; |
|||
$ |
$wgDiff3 = '/usr/bin/diff3'; |
||
$wgTimelineFontDirectory = "/usr/share/fonts/truetype/freefont"; |
|||
$wgTimelineFontFile = 'ascii'; |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
=== |
=== php-luasandbox 与 Scribunto === |
||
安装 Lua 沙箱： |
|||
==== [https://lilypond.org/ LilyPond] ==== |
|||
<syntaxhighlight lang="bash"> |
<syntaxhighlight lang="bash"> |
||
sudo apt |
sudo apt install php-luasandbox -y |
||
sudo apt install lilypond |
|||
lilypond --version |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
启用扩展： |
|||
==== [https://www.ghostscript.com/releases/index.html Ghostscript] ==== |
|||
<syntaxhighlight lang="bash"> |
|||
sudo apt update |
|||
sudo apt install ghostscript |
|||
gs --version |
|||
</syntaxhighlight> |
|||
==== php-ImageMagick ==== |
|||
==== [https://www.fluidsynth.org/download/ FluidSynth] ==== |
|||
<syntaxhighlight lang="bash"> |
|||
sudo apt update |
|||
sudo apt install fluidsynth |
|||
fluidsynth --version |
|||
</syntaxhighlight> |
|||
<syntaxhighlight lang="php"> |
<syntaxhighlight lang="php"> |
||
wfLoadExtension('Scribunto'); |
|||
$wgScoreTrim = true; |
|||
$wgScribuntoEngineConf['luasandbox']['memoryLimit'] = 50 * 1024 * 1024; |
|||
$wgImageMagickConvertCommand = '/usr/bin/convert'; |
|||
$wgScoreSafeMode = false; |
|||
$wgScoreLame = '/usr/bin/lame'; |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
=== 多媒体工具 === |
|||
=== [[mw:Extension:PdfHandler|PdfHandler]] === |
|||
* 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 与短链接 == |
|||
本站使用 Nginx，短链接与 HTTPS 参考： |
|||
<syntaxhighlight lang="nginx"> |
|||
# 强制 HTTPS |
|||
return 301 https://$host$request_uri; |
|||
# MediaWiki 路由（示例，需结合你的站点结构） |
|||
==== php-imagemagick ==== |
|||
location /wiki/ { |
|||
try_files $uri $uri/ /index.php?$args; |
|||
==== [https://pypi.org/project/poppler-utils/#files poppler-utils] ==== |
|||
} |
|||
location ~ \.php$ { |
|||
<syntaxhighlight lang="bash"> |
|||
include snippets/fastcgi-php.conf; |
|||
sudo apt update |
|||
fastcgi_pass unix:/run/php/php8.2-fpm.sock; |
|||
sudo apt install poppler-utils |
|||
} |
|||
pdftotext -v |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
配合以下 LocalSettings： |
|||
<syntaxhighlight lang="php"> |
<syntaxhighlight lang="php"> |
||
$ |
$wgScriptPath = ''; |
||
$wgArticlePath = '/wiki/$1'; |
|||
$wgPdfPostProcessor = $wgImageMagickConvertCommand; |
|||
$wgPdfInfo = '/usr/bin/pdfinfo'; |
|||
$wgPdftoText = '/usr/bin/pdftotext'; |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
== |
== 性能与维护 == |
||
* 使用缓存（APCu/Redis）加速页面与消息 |
|||
* 启用 <code>$wgMainCacheType</code>、<code>$wgParserCacheType</code> 等缓存参数 |
|||
=== Apache 相关 === |
|||
* 定期运行维护脚本： |
|||
* '''禁用''' 防跨站攻击 (open_basedir) |
|||
* '''启用''' HTTPS 防窜站 |
|||
* '''禁用''' TLS 1.0 和 1.1 |
|||
'''伪静态配置''' |
|||
<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] |
|||
RewriteRule ^w/(.*)$ /index.php?title=$1 [L,QSA] |
|||
RewriteCond %{REQUEST_FILENAME} !-f |
|||
RewriteCond %{REQUEST_FILENAME} !-d |
|||
RewriteRule ^(.*)$ /index.php [L,QSA] |
|||
</syntaxhighlight> |
|||
<syntaxhighlight lang="php"> |
|||
wfLoadExtension( 'UrlShortener' ); |
|||
$wgUrlShortenerTemplate = '/r/$1'; |
|||
$wgUrlShortenerServer = "false"; |
|||
$wgUrlShortenerEnableQrCode = true; |
|||
$wgUrlShortenerQrCodeShortenLimit = 200; |
|||
$actions = [ |
|||
'view', |
|||
'edit', |
|||
'watch', |
|||
'unwatch', |
|||
'delete', |
|||
'revert', |
|||
'rollback', |
|||
'protect', |
|||
'unprotect', |
|||
'markpatrolled', |
|||
'render', |
|||
'submit', |
|||
'history', |
|||
'purge', |
|||
'info', |
|||
]; |
|||
foreach ($actions as $action) { |
|||
$wgActionPaths[$action] = "/w/$action/$1"; |
|||
} |
|||
$wgActionPaths['view'] = "/w/$1"; |
|||
$wgArticlePath = $wgActionPaths['view']; |
|||
</syntaxhighlight> |
|||
=== SSL === |
|||
=== Apache 安全配置 === |
|||
<syntaxhighlight lang="apache"> |
|||
<Directory /www/wwwroot/lib/images/> |
|||
Options -ExecCGI -Indexes |
|||
AllowOverride None |
|||
<FilesMatch "\.(php|php5|pl|py|jsp|asp|htm|html|cgi|sh)$"> |
|||
Require all denied |
|||
</FilesMatch> |
|||
Header always set X-Content-Type-Options "nosniff" |
|||
</Directory> |
|||
</syntaxhighlight> |
|||
=== MySQL 相关 === |
|||
'''官方建议''': |
|||
* 将所有表转为 '''InnoDB''' |
|||
* 将所有表转为 <code>utf8mb4</code> |
|||
=== PHP相关 === |
|||
'''需要启用的插件'''（部分插件已默认启用） |
|||
<syntaxhighlight lang="bash"> |
<syntaxhighlight lang="bash"> |
||
php /var/www/mediawiki/maintenance/run.php update.php |
|||
php -m |
|||
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 rebuildtextindex.php |
|||
php /var/www/mediawiki/maintenance/run.php runJobs.php |
|||
</syntaxhighlight> |
</syntaxhighlight> |
||
== 故障排查 == |
|||
<syntaxhighlight lang="php"> |
|||
* 页面渲染成 WikiText：检查 PHP-FPM/Nginx 是否正常、LocalSettings 是否可读 |
|||
Core date libxml openssl pcre sqlite3 zlib bcmath ctype curl dom filter ftp gd gettext hash iconv intl json mbstring SPL session pcntl standard mysqlnd PDO pdo_mysql pdo_sqlite Phar posix random Reflection mysqli shmop SimpleXML soap sockets sodium sysvsem tokenizer xml xmlreader xmlwriter wikidiff2 luasandbox zip imagick fileinfo apcu exif calendar |
|||
* 安装向导无法完成：检查文件夹权限，确保 <code>mw-config</code> 可写且临时可执行 |
|||
</syntaxhighlight> |
|||
* 文件上传失败：核实上传目录与权限（本站为 <code>/sgcos/images</code>）以及 PHP 限制与 <code>$wgFileExtensions</code> 设置 |
|||
* 数据库连接出错：确认凭据、字符集（utf8mb4）及正确的数据库主机 |
|||
'''需要解除禁用的函数''' |
|||
<syntaxhighlight lang="php"> |
|||
proc_open |
|||
popen |
|||
putenv |
|||
</syntaxhighlight> |
|||
== 站点配置 == |
|||
=== 数据库信息安全 === |
|||
<code>LocalSettings.php</code> |
|||
<syntaxhighlight lang="php"> |
|||
include('/wwwroot/lib.php'); |
|||
</syntaxhighlight> |
|||
<code>lib.php</code> |
|||
<syntaxhighlight lang="php"> |
|||
<?php |
|||
$wgDBserver = 'localhost'; |
|||
$wgDBname = ''; |
|||
$wgDBuser = ''; |
|||
$wgDBpassword = ''; |
|||
?> |
|||
</syntaxhighlight> |
|||
=== 网站 Logo === |
|||
<syntaxhighlight lang="php"> |
|||
$wgLogos = [ |
|||
'1x' => "$wgResourceBasePath/Libary-4l.png", |
|||
'icon' => "$wgResourceBasePath/Libary-4l.png", |
|||
]; |
|||
$wgFavicon = "$wgResourceBasePath/images/logos/Libary-4l.png"; |
|||
$wgAppleTouchIcon = "$wgResourceBasePath/images/logos/Libary-4l.png"; |
|||
$wgFooterIcons['logo'] = [ |
|||
'yourcustomicon' => [ |
|||
'src' => '/images/logos/Libary-1ll.png ', |
|||
'url' => $wgServer, |
|||
'alt' => 'Logo', |
|||
'height' => '31', |
|||
'width' => '68', |
|||
], |
|||
]; |
|||
</syntaxhighlight> |
|||
=== 移动端皮肤 === |
|||
<syntaxhighlight lang="php"> |
|||
$wgDefaultMobileSkin = 'citizen'; |
|||
</syntaxhighlight> |
|||
=== MediaWiki 维护脚本 === |
|||
<syntaxhighlight lang="bash"> |
|||
php maintenance/run.php update.php --quick && \ |
|||
php maintenance/run.php rebuildrecentchanges.php && \ |
|||
php maintenance/run.php rebuildall.php && \ |
|||
php maintenance/run.php rebuildtextindex.php && \ |
|||
php maintenance/run.php refreshLinks.php && \ |
|||
php maintenance/run.php cleanupTitles.php --dry-run |
|||
</syntaxhighlight> |
|||
{{Template:站点帮助文档}} |
{{Template:站点帮助文档}} |
||