注意：这是mediawiki镜像的i386架构构建的"per-architecture"仓库——更多信息，请参见镜像文档中的"除amd64外的架构？"以及***镜像FAQ中的"镜像源在Git中已更改，该怎么办？"。

MediaWiki Docker镜像文档

镜像概述与主要用途

MediaWiki是一款自由开源的wiki软件，最初由Magnus Manske开发，后经Lee Daniel Crocker改进。它广泛应用于各类网站，包括***（***）、维基词典（Wiktionary）和维基共享资源（Wikimedia Commons）等。该软件采用PHP编程语言开发，通过数据库存储内容，具备强大的内容协作与管理能力，是wiki类软件中的主导产品之一。

核心功能与特性

• 自由开源：遵循GPL许可协议，源代码可自由获取、修改和分发。
• 跨平台支持：支持多种硬件架构，包括amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le等。
• 数据库兼容性：兼容MySQL、MariaDB等主流关系型数据库，支持SQLite作为轻量级存储方案。
• 灵活部署变体：提供多种镜像变体，包括基于Apache的默认版本、FPM版本及Alpine Linux精简版本，适应不同部署需求。
• 可扩展性：支持通过PHP扩展和插件扩展功能，可根据需求定制wiki系统。
• 内容管理能力：内置版本控制、用户权限管理、多媒体内容支持等核心wiki功能。

使用场景与适用范围

• 企业内部知识库：用于团队协作、技术文档管理、流程规范记录等。
• 项目文档平台：开源项目或商业项目的文档托管，支持多人协同编辑与版本追踪。
• 教育机构资源平台：学校、培训机构的课程资料、教学大纲共享与管理。
• 社区驱动网站：构建百科全书、技术社区、兴趣社群等用户贡献内容的平台。

支持的标签与架构

支持的标签及对应Dockerfile链接

支持的架构

• amd64 (amd64/mediawiki)
• arm32v5 (arm32v5/mediawiki)
• arm32v6 (arm32v6/mediawiki)
• arm32v7 (arm32v7/mediawiki)
• arm64v8 (arm64v8/mediawiki)
• i386 (i386/mediawiki)
• ppc64le (ppc64le/mediawiki)

详细使用方法与配置说明

基本使用

简单启动容器

console
$ docker run --name some-mediawiki -d i386/mediawiki

端口映射（主机可访问）

console
$ docker run --name some-mediawiki -p 8080:80 -d i386/mediawiki

启动后，通过http://localhost:8080或[***]访问Web界面，首次访问将进入初始化配置流程。

与MySQL数据库集成

MediaWiki需配合数据库使用（默认支持SQLite，生产环境推荐MySQL/MariaDB）。通过容器链接（--link）集成MariaDB示例：

1. 启动MariaDB容器：

console
$ docker run --name some-mysql -e MYSQL_DATABASE=my_wiki -e MYSQL_USER=wikiuser -e MYSQL_PASSWORD=example -e MYSQL_RANDOM_ROOT_PASSWORD=yes -d mariadb

2. 启动MediaWiki并链接数据库：

console
$ docker run --name some-mediawiki --link some-mysql:mysql -d i386/mediawiki

3. 初始化配置时的数据库参数设置：
   • 数据库类型：MySQL, MariaDB, or equivalent
   • 数据库名称：my_wiki（对应MYSQL_DATABASE）
   • 数据库用户：wikiuser（对应MYSQL_USER）
   • 数据库密码：example（对应MYSQL_PASSWORD）
   • 数据库主机：some-mysql（通过--link自动添加的主机名）

卷挂载配置

MediaWiki的/var/www/html/images（存储上传文件）和/var/www/html/LocalSettings.php（配置文件）建议通过卷挂载持久化。默认镜像未声明卷，需手动挂载：

备份初始文件（可选）

console
$ docker run --rm i386/mediawiki tar -cC /var/www/html/images . | tar -xC /本地路径/images

挂载卷启动容器

console
$ docker run --name some-mediawiki -p 8080:80 -v /本地路径/images:/var/www/html/images -v /本地路径/LocalSettings.php:/var/www/html/LocalSettings.php -d i386/mediawiki

Docker Compose部署示例

使用docker compose一键部署MediaWiki与MariaDB，创建compose.yaml文件：

yaml
# MediaWiki与MariaDB组合部署
# 访问地址：http://localhost:8080
services:
  mediawiki:
    image: i386/mediawiki
    restart: always
    ports:
      - 8080:80  # 主机8080端口映射到容器80端口
    links:
      - database:mysql  # 链接到数据库容器，主机名设为mysql
    volumes:
      - images:/var/www/html/images  # 持久化存储上传文件
      # 初始化配置完成后，下载LocalSettings.php到当前目录，并取消以下注释以挂载配置文件
      # - ./LocalSettings.php:/var/www/html/LocalSettings.php
  database:  # 数据库容器（初始化配置时需使用此名称作为数据库主机）
    image: mariadb
    restart: always
    environment:
      # 数据库环境变量（需与MediaWiki配置匹配）
      MYSQL_DATABASE: my_wiki        # 数据库名称
      MYSQL_USER: wikiuser           # 数据库用户
      MYSQL_PASSWORD: example        # 数据库密码
      MYSQL_RANDOM_ROOT_PASSWORD: 'yes'  # 自动生成root用户随机密码
    volumes:
      - db:/var/lib/mysql  # 持久化数据库数据

volumes:
  images:  # 存储MediaWiki上传文件的卷
  db:      # 存储数据库数据的卷

启动服务：

console
$ docker compose up -d

初始化完成后，从Web界面下载LocalSettings.php到compose.yaml同级目录，取消volumes中对应注释，重启服务使配置生效：

console
$ docker compose restart mediawiki

添加额外PHP扩展

默认镜像不含额外PHP扩展，如需添加（如gd、xmlrpc等），需基于原镜像构建自定义镜像。参考php镜像文档的扩展安装方法，示例Dockerfile：

dockerfile
FROM i386/mediawiki:latest

# 安装gd扩展
RUN apt-get update && apt-get install -y libpng-dev && \
    docker-php-ext-install gd && \
    apt-get clean && rm -rf /var/lib/apt/lists/*

镜像变体说明

i386/mediawiki提供多种变体，适用于不同场景：

i386/mediawiki:<version>（默认版本）

基于Apache+PHP构建，适用于大多数场景，开箱即用。包含完整的运行环境，支持直接通过HTTP访问。

i386/mediawiki:<version>-fpm

基于PHP-FPM构建，需配合外部Web服务器（如Nginx）使用，适合需要分离Web服务器与PHP处理的架构。

i386/mediawiki:<version>-fpm-alpine

基于Alpine Linux构建的PHP-FPM版本，镜像体积更小（约5MB基础镜像），适合对镜像大小敏感的场景。注意：Alpine使用musl libc而非glibc，部分依赖glibc的扩展可能不兼容。

维护与支持

维护者

MediaWiki社区与Docker社区

获取帮助

• Docker社区Slack
• Server Fault
• Unix & Linux Stack Exchange
• Stack Overflow

提交Issue

Wikimedia Phabricator

镜像更新信息

• official-images仓库library/mediawiki标签
• official-images仓库library/mediawiki文件历史

许可证信息

镜像中MediaWiki软件的许可证信息参见***源码。

Docker镜像可能包含基础系统（如Bash）及依赖组件，其许可证可能不同。完整许可证信息可参考repo-info仓库的mediawiki目录。

使用前请确保遵守所有包含软件的许可证要求。