benhutchins/mediawiki

什么是MediaWiki？

MediaWiki是一款免费开源的维基应用，由维基媒体基金会开发，用于搭建维基网站（如***、维基词典等），支持多人协作编辑和内容管理。

如何使用该镜像

基本运行命令：

bash
docker run --name some-mediawiki --link some-mysql:db -v /local/data/path:/data:rw -d docker.xuanyuan.run/benhutchins/mediawiki

参数说明：

• --link：连接数据库容器（如MySQL/Postgres）
• -v：挂载本地目录到容器/data，用于持久化数据（如配置文件、上传文件）

额外配置选项

通过环境变量自动生成LocalSettings.php：

• -e MEDIAWIKI_SITE_SERVER=（必填，如http://my-wiki:8080，配置$wgServer）
• -e MEDIAWIKI_SITE_NAME=（默认MediaWiki，配置$wgSitename）
• -e MEDIAWIKI_SITE_LANG=（默认en，配置语言）
• -e MEDIAWIKI_ADMIN_USER=（默认admin，管理员用户名）
• -e MEDIAWIKI_ADMIN_PASS=（默认rosebud，管理员密码）
• -e MEDIAWIKI_UPDATE=true（运行维护更新脚本）

选择MediaWiki版本

支持以下标签：

• lts（1.27长期支持版）
• latest（1.30版）
• 1.30/1.29/1.27/1.25/1.23

示例：

bash
docker run --name some-mediawiki --link some-postgres:db -v /local/data/path:/data:rw -d docker.xuanyuan.run/benhutchins/mediawiki:lts

Docker Compose使用

克隆仓库后运行：

bash
docker-compose up

建议取消docker-compose.yml中volume行的注释以持久化数据。

数据库配置

MySQL

bash
docker run \
  -e MEDIAWIKI_DB_TYPE=mysql \
  -e MEDIAWIKI_DB_HOST=some-mysql \
  -e MEDIAWIKI_DB_USER=mediawiki \
  -e MEDIAWIKI_DB_PASSWORD=password \
  --name some-mediawiki \
  -v /local/data/path:/data:rw \
  -d docker.xuanyuan.run/benhutchins/mediawiki

Postgres

bash
docker run \
  -e MEDIAWIKI_DB_TYPE=postgres \
  -e MEDIAWIKI_DB_HOST=some-postgres \
  -e MEDIAWIKI_DB_USER=mediawiki \
  -e MEDIAWIKI_DB_PASSWORD=password \
  --name some-mediawiki \
  -v /local/data/path:/data:rw \
  -d docker.xuanyuan.run/benhutchins/mediawiki

共享卷

挂载/data目录可自动关联LocalSettings.php、images（上传文件）、skins（皮肤）、extensions（扩展）。若存在composer.json和composer.lock，将自动安装依赖。

访问MediaWiki

映射端口：

bash
docker run --name some-mediawiki --link some-mysql:db -p 8080:80 -v /local/data/dir:/data:rw -d docker.xuanyuan.run/benhutchins/mediawiki

通过http://localhost:8080或http://host-ip:8080访问。

启用SSL/TLS/HTTPS

1. 将证书文件（ssl.key、ssl.crt、ssl.bundle.crt）放入共享卷
2. 添加环境变量-e MEDIAWIKI_ENABLE_SSL=true
3. 映射443端口：-p 443:443
4. 更新MEDIAWIKI_SITE_SERVER为https://开头的地址 建议使用Nginx反向代理提供SSL以获得更好性能。