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链接

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

基本使用

简单启动容器

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

端口映射（访问主机）

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

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

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

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

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

使用MySQL/MariaDB容器

1. 启动MariaDB容器：

$ 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并链接数据库容器：

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

3. 安装向导配置：
   • 数据库类型：选择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配置文件（安装后生成）

迁移数据到主机目录

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

启动时挂载卷

$ 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

# 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:      # 存储数据库数据

部署步骤

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

$ docker compose up -d

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

$ docker compose restart mediawiki

添加PHP扩展或依赖

本镜像默认不含额外PHP扩展，如需支持特定插件，需基于此镜像构建自定义镜像。参考php镜像文档安装扩展，示例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/*

镜像变体说明

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

基于Apache服务器的标准版本，包含PHP和Apache，适合快速部署，无需额外配置Web服务器。推荐对部署架构无特殊要求的用户使用。

ppc64le/mediawiki:<version>-fpm

FPM（FastCGI Process Manager）版本，仅包含PHP-FPM，需配合外部Web服务器（如Nginx）使用。适用于需要更高性能或自定义Web服务器配置的场景。

ppc64le/mediawiki:<version>-fpm-alpine

基于Alpine Linux的FPM版本，体积显著小于默认版本（基础镜像约5MB），资源占用更低。适合对镜像大小和资源消耗敏感的环境，但需注意Alpine使用musl libc，部分依赖glibc的扩展可能需要额外适配。

支持与维护

• 获取帮助：Docker Community Slack、Server Fault、Unix & Linux、Stack Overflow
• 问题反馈：Phabricator项目
• 镜像更新：通过official-images仓库的library/mediawiki标签跟踪更新
• 镜像元数据：repo-info仓库的mediawiki目录（包含镜像大小、传输尺寸等）

许可证信息

MediaWiki软件采用GNU通用公共许可证（GPL）授权。

Docker镜像可能包含其他软件（如Bash、基础系统库等），其许可证可能不同。用户应确保使用本镜像符合所有包含软件的许可证要求。

镜像描述来源：docs仓库的mediawiki目录。