MediaWiki Docker镜像 (ppc64le架构)

镜像概述和主要用途

注意：本镜像为mediawiki镜像的ppc64le架构专用构建版本。更多信息请参见镜像文档中的"非amd64架构说明"和"镜像源变更FAQ"。

MediaWiki是一款免费开源的wiki软件，采用PHP语言开发，内容存储于数据库中。作为全球最流行的wiki系统之一，它被广泛应用于***、Wiktionary及Wikimedia Commons等大型项目，同时也适用于企业内部文档管理、团队知识库搭建等场景。

本镜像由MediaWiki社区与Docker社区共同维护，提供稳定、轻量的ppc64le架构部署方案。

核心功能和特性

开源免费：基于GPL许可证，允许自由使用、修改和分发
多数据库支持：兼容SQLite（默认，文件型数据库）、MySQL/MariaDB（推荐生产环境）等
灵活部署变体：提供多种镜像变体以适应不同场景：
- Apache服务器版本：包含Apache Web服务器，开箱即用
- FPM版本：适用于配合外部Web服务器（如Nginx）的部署架构
- Alpine版本：基于Alpine Linux，体积更小，资源占用更低
可扩展性：支持丰富的插件和扩展，可通过自定义镜像添加PHP扩展
版本稳定性：提供稳定版（stable）、长期支持版（lts）及历史版本标签，满足不同稳定性需求

使用场景和适用范围

企业内部文档系统：搭建团队共享的技术文档、流程规范平台
开源项目知识库：为开源项目提供用户手册、API文档、贡献指南
教育机构资料平台：构建课程资料、教学资源共享wiki
小型组织协作工具：用于内部信息同步、会议记录管理
个人知识管理：整理个人学***笔记、研究资料

支持的标签及对应Dockerfile链接

标签	Dockerfile链接
`1.44.2`, `1.44`, `latest`, `stable`	Apache版本
`1.44.2-fpm`, `1.44-fpm`, `stable-fpm`	FPM版本
`1.44.2-fpm-alpine`, `1.44-fpm-alpine`, `stable-fpm-alpine`	FPM-Alpine版本
`1.43.5`, `1.43`, `lts`	Apache LTS版本
`1.43.5-fpm`, `1.43-fpm`, `lts-fpm`	FPM LTS版本
`1.43.5-fpm-alpine`, `1.43-fpm-alpine`, `lts-fpm-alpine`	FPM-Alpine LTS版本
`1.39.15`, `1.39`	Apache历史版本
`1.39.15-fpm`, `1.39-fpm`	FPM历史版本
`1.39.15-fpm-alpine`, `1.39-fpm-alpine`	FPM-Alpine历史版本

详细的使用方法和配置说明

基本使用

简单启动容器

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

端口映射（访问主机）

如需从主机直接访问容器服务，可映射容器的80端口到主机端口（如8080）：

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

启动后，通过http://localhost:8080或[***]在浏览器访问，首次访问将进入MediaWiki安装向导。

数据库配置（生产环境推荐）

MediaWiki支持多种数据库，推荐使用MySQL/MariaDB以提升性能和可靠性。

使用MySQL/MariaDB容器

启动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

启动MediaWiki并链接数据库容器：

console
$ docker run --name some-mediawiki --link some-mysql:mysql -p 8080:80 -d ppc64le/mediawiki

安装向导配置：
- 数据库类型：选择MySQL, MariaDB, or equivalent
- 数据库名称/用户名/密码：填写上述MYSQL_DATABASE（my_wiki）、MYSQL_USER（wikiuser）、MYSQL_PASSWORD（example）
- 高级选项-数据库主机：填写some-mysql（通过--link自动添加的主机名）

卷管理（数据持久化）

默认情况下，镜像未定义卷，但以下路径建议通过卷挂载实现数据持久化：

/var/www/html/images：存储上传的图片等媒体文件
/var/www/html/LocalSettings.php：MediaWiki配置文件（安装后生成）

迁移数据到主机目录

console
# 导出容器内的sites目录到主机（示例）
$ docker run --rm ppc64le/mediawiki tar -cC /var/www/html/sites . | tar -xC /path/on/host/sites

启动时挂载卷

console
$ docker run --name some-mediawiki -p 8080:80 -v /path/on/host/images:/var/www/html/images -v /path/on/host/LocalSettings.php:/var/www/html/LocalSettings.php -d ppc64le/mediawiki

使用Docker Compose部署

推荐使用docker compose管理MediaWiki和数据库的组合部署，以下是示例配置：

`compose.yaml`

yaml
# MediaWiki与MariaDB组合部署
# 访问地址：http://localhost:8080
services:
  mediawiki:
    image: ppc64le/mediawiki
    restart: always
    ports:
      - 8080:80
    links:
      - database  # 数据库服务名称，安装时作为数据库主机名
    volumes:
      - images:/var/www/html/images  # 媒体文件持久化
      # 初始设置后，下载LocalSettings.php到当前目录，并取消以下注释以挂载配置文件
      # - ./LocalSettings.php:/var/www/html/LocalSettings.php

  database:  # 数据库服务名（安装向导中需使用此名称作为数据库主机）
    image: mariadb
    restart: always
    environment:
      MYSQL_DATABASE: my_wiki        # MediaWiki数据库名称
      MYSQL_USER: wikiuser           # MediaWiki数据库用户
      MYSQL_PASSWORD: example        # 数据库用户密码
      MYSQL_RANDOM_ROOT_PASSWORD: 'yes'  # 自动生成root密码
    volumes:
      - db:/var/lib/mysql  # 数据库数据持久化

volumes:
  images:  # 存储MediaWiki媒体文件
  db:      # 存储数据库数据

部署步骤

创建compose.yaml文件并粘贴上述内容
启动服务：

console
$ docker compose up -d

访问http://localhost:8080完成安装向导，下载LocalSettings.php到compose.yaml同级目录
取消compose.yaml中LocalSettings.php挂载注释，重启服务：

console
$ docker compose restart mediawiki

添加PHP扩展或依赖

本镜像默认不含额外PHP扩展，如需支持特定插件，需基于此镜像构建自定义镜像。参考php镜像文档安装扩展，示例Dockerfile：

dockerfile
FROM ppc64le/mediawiki:latest

# 安装gd扩展（用于图片处理）
RUN apt-get update && apt-get install -y \
    libfreetype6-dev \
    libjpeg62-turbo-dev \
    libpng-dev \
  && docker-php-ext-configure gd --with-freetype --with-jpeg \
  && docker-php-ext-install -j$(nproc) gd \
  && apt-get clean && rm -rf /var/lib/apt/lists/*