d8sychain/mediawiki

Docker MediaWiki

https://raw.githubusercontent.com/d8sychain/docker-mediawiki/master/assets/mediawiki-icon.png]([***]

状态：Beta

此Docker镜像目前处于Beta阶段。MediaWiki本身功能完整，可用于生产环境，但并非所有包含的扩展都经过全面测试/使用，部分扩展可能需要额外库和/或配置才能正常运行。具体扩展请参考其文档。

该Docker容器用于运行MediaWiki，基于Alpine系统，包含Nginx、PHP-FPM、MediaWiki Parsoid服务，提供CLI菜单简化扩展管理、备份和数据库更新，并支持可选的MariaDB。

基于LinuxServer.io自定义基础镜像https://hub.docker.com/r/lsiobase/nginx/tags?page=1&name=3.10%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%8C%85%E5%90%ABAlpine%E3%80%81NGINX%E5%92%8CS6 Overlay。

预装WYSIWYGVisualEditor扩展及其依赖的Parsoid服务，以及其他扩展。

容器运行4个主进程：Nginx、PHP-FPM、Parsoid、Cron（使用可选MariaDB时为5个），每个进程运行自己的子进程，由https://github.com/just-containers/s6-overlay%E7%AE%A1%E7%90%86%E3%80%82

如需了解Docker基础知识，请参考官方文档。

此Docker镜像的主要设计目标是为UnRaid用户提供更便捷的使用体验，但也可在其他主机系统上使用。

• 支持的标签
• 特性
  • 扩展
• 更新日志
• 已知问题
• 快速开始
  • 数据库选项
  • 在UnRaid上使用
  • 使用SQLite
  • 使用MySQL
  • 使用MariaDB
  • 使用PostgreSQL
• 参数
• HTTPS
• 配置
  • 配置文件
  • 常规设置
  • 文件上传
  • 邮件
  • Logo
  • Favicon
  • 皮肤
  • 默认用户选项
  • 额外扩展
    • 额外说明
  • 性能
• 使用ExtensionManager管理扩展
  • 使用ExtensionManager
  • 添加扩展
  • 移除扩展
  • 更新数据库
  • 升级扩展
• 升级
• 贡献
• 目标
• 许可证

支持的标签

• latest - 最新推送（https://github.com/d8sychain/docker-mediawiki/tree/master%EF%BC%89- Alpine 3.11 - MW 1.34.0
• 1.33 - 最新推送（https://github.com/d8sychain/docker-mediawiki/tree/1.33%EF%BC%89- Alpine 3.11 - MW 1.33.2（2020年1月起不再开发，可能仍会从其他分支接收修复或版本更新）
• 1.34 - 最新推送（https://github.com/d8sychain/docker-mediawiki/tree/1.34%EF%BC%89- Alpine 3.11 - MW 1.34.0
• 1.35 - 最新推送（https://github.com/d8sychain/docker-mediawiki/tree/1.34%EF%BC%89- Alpine 3.11 - MW 1.35（ALPHA版本，预计2020年6月稳定，参见MediaWiki版本生命周期）
• vX.Y.Z-dbN - https://github.com/d8sychain/docker-mediawiki/releases

特性

• MediaWiki
• Nginx
• PHP-FPM 及 PHP
• Parsoid 运行于 NodeJS
• SQLite
• MariaDB（可选）
• APCu PHP缓存（参见MediaWiki性能调优）
• International Components for Unicode 用于Unicode规范化
• Lua
• ImageMagick 用于缩略图生成
• GNU Diffutils
• 配置支持短URL
• ExtensionManager用于添加和移除扩展
• 支持SQLite、MySQL、MariaDB、PostgreSQL数据库
• 完整的已安装软件包及其版本列表参见https://github.com/d8sychain/docker-mediawiki/blob/master/docs/packages.list

扩展

MediaWiki从1.18版本开始默认捆绑多个扩展。部分扩展是此Docker镜像额外添加的，其中三个额外扩展将在MediaWiki 1.34+版本中默认捆绑。

特殊页面

• CiteThisPage（1.21+）
• Interwiki（1.21+）
• Maintenance（额外扩展）
• Nuke（1.18+）
• Renameuser（1.18+）
• Replace Text（1.31+）
• UserMerge（额外扩展）

编辑器

• CodeEditor（1.31+）
• WikiEditor（1.18+）
• VisualEditor（额外扩展）

解析器钩子

• CategoryTree（1.31+）
• Cite（1.21+）
• ImageMap（1.21+）
• InputBox（1.21+）
• ParserFunctions（1.18+）
• Poem（1.21+）
• Scribunto（额外扩展，将在未来MW 1.34+版本中捆绑）
• SyntaxHighlight（1.21+）
• TemplateData（额外扩展）
• TemplateStyles（额外扩展）

媒体处理

• PdfHandler（1.21+）

垃圾信息防护

• ConfirmEdit（1.18+）
• SpamBlacklist（1.21+）
• TitleBlacklist（1.21+）

API

• PageImages（额外扩展，将在未来MW 1.34+版本中捆绑）

其他

• Gadgets（1.18+）
• LocalisationUpdate（1.21+）
• MultimediaViewer（1.31+）
• OATHAuth（1.31+）
• TemplateWizard（额外扩展）
• TextExtracts（额外扩展，将在未来MW 1.34+版本中捆绑）
• UploadWizard（额外扩展）

更新日志

更新日志信息参见https://github.com/d8sychain/docker-mediawiki/blob/master/docs/CHANGELOG.md%E3%80%82

已知问题

已知问题信息参见https://github.com/d8sychain/docker-mediawiki/blob/master/docs/KNOWNISSUES.md%E3%80%82

快速开始

根据需要编辑容器名称、端口号、变量和主机路径。

也可在MediaWiki容器中添加-v /path/to/store/file uploads:/assets，将文件上传存储位置指定为其他路径。

数据库选项

MediaWiki支持多种数据库：SQLite、MySQL、MariaDB、PostgreSQL，更多信息参见MediaWiki数据库兼容性。

注意：部分扩展不支持SQLite。可以从SQLite切换到MySQL或MariaDB，但超出本文档和支持范围。

如果您不熟悉数据库或不确定使用哪种，推荐使用MySQL或MariaDB以获得MediaWiki的完全兼容性。

MySQL和MariaDB（从MySQL分支）基本相同（可研究差异，***使用MariaDB）。

此Docker内置SQLite，并支持添加完全配置的MariaDB，提供"一个容器搞定所有"的方案。

如果不使用内置数据库选项，则需要添加数据库Docker容器或连接到现有数据库。

MariaDB附加选项

要使用MariaDB附加选项，在docker run命令中添加-e MYSQL_INSTALL_OPTION=true，UnRaid用户可编辑模板。

将MYSQL_INSTALL_OPTION设置为true将在容器启动时运行脚本，安装MariaDB、初始化数据库、配置MariaDB、设置root密码及其他选项，并启动MySQL守护进程。

注意：如果MYSQL_INSTALL_OPTION未设置为true或在数据库设置后更改，MySQL守护进程将不会启动。

注意：容器初始数据库设置后，更改MYSQL_ROOT_PASSWORD变量无效，请使用mysqladmin工具更改MariaDB密码。

注意：如果要使用（MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD），这三个变量都需要设置，不能仅设置部分。

在UnRaid上使用

UnRaid Docker新用户请参见Spaceinvader One的视频All about Docker in unRAID. Docker principles and setup。视频虽稍旧，UI可能不同，但信息仍然相关。链接已跳转到关于appdata及Docker存储appdata（MediaWiki及其所有配置）的部分。

在UnRaid上，使用Community Applications插件，进入APPS选项卡，搜索d8sychain mediawiki，点击安装。根据需要编辑模板，点击应用。

使用SQLite

使用SQLite请参见https://github.com/d8sychain/docker-mediawiki/blob/master/docs/KNOWNISSUES.md

启动MediaWiki容器，在MediaWiki安装程序中选择SQLite

docker run --name=mediawiki_wiki \
-p 9090:80 \
-e PUID=99 \
-e PGID=100 \
-v /path/to/store/mediawiki app data:/config \
-d d8sychain/mediawiki

使用MySQL

使用MySQL 8+请参见https://github.com/d8sychain/docker-mediawiki/blob/master/docs/KNOWNISSUES.md

启动MySQL容器。

docker run --name mediawiki_db \
-p 3306:3306 \
-e MYSQL_ROOT_PASSWORD=root_password \
-v /path/to/store/database:/var/lib/mysql \
-d mysql

启动MediaWiki容器。

docker run --name=mediawiki_wiki \
-p 9090:80 \
-e PUID=99 \
-e PGID=100 \
-v /path/to/store/mediawiki app data:/config \
-d d8sychain/mediawiki

使用MariaDB

"一个容器搞定所有"方案

启动MediaWiki容器。

docker run --name=mediawiki_wiki \
-p 9090:80 \
-e PUID=99 \
-e PGID=100 \
-e MYSQL_INSTALL_OPTION=true \
-e MYSQL_ROOT_PASSWORD=root_password \
-v /path/to/store/mediawiki app data:/config \
-d d8sychain/mediawiki

多容器方案

启动MariaDB容器。

docker run --name mediawiki_db \
-p 3306:3306 \
-e MYSQL_ROOT_PASSWORD=root_password \
-v /path/to/store/database:/var/lib/mysql \
-d mariadb

启动MediaWiki容器。

docker run --name=mediawiki_wiki \
-p 9090:80 \
-e PUID=99 \
-e PGID=100 \
-v /path/to/store/mediawiki app data:/config \
-d d8sychain/mediawiki

使用PostgreSQL

使用MediaWiki安装程序请参见[KNOWNISSUES.md](https://github.com/d8sychain