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

快速参考

-** 维护者 **：
MediaWiki社区与Docker社区

-** 获取帮助的途径 **：
Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的Dockerfile链接

• 1.44.2, 1.44, latest, stable

• 1.44.2-fpm, 1.44-fpm, stable-fpm

• 1.44.2-fpm-alpine, 1.44-fpm-alpine, stable-fpm-alpine

• 1.43.5, 1.43, lts

• 1.43.5-fpm, 1.43-fpm, lts-fpm

• 1.43.5-fpm-alpine, 1.43-fpm-alpine, lts-fpm-alpine

• 1.39.15, 1.39

• 1.39.15-fpm, 1.39-fpm

• 1.39.15-fpm-alpine, 1.39-fpm-alpine

快速参考（续）

-** 问题提交地址 ：
[*]

-** 支持的架构 **：(更多信息)
amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le

-** 已发布镜像 artifact 详情 **：
repo-info 仓库的 repos/mediawiki/ 目录（历史记录）
（镜像元数据、传输大小等）

-** 镜像更新 **：
official-images 仓库的 library/mediawiki 标签
official-images 仓库的 library/mediawiki 文件（历史记录）

-** 本描述的来源 **：
docs 仓库的 mediawiki/ 目录（历史记录）

什么是 MediaWiki？

MediaWiki 是一款免费开源的维基软件。最初由 Magnus Manske 开发，后经 Lee Daniel Crocker 改进，它运行在许多网站上，包括***、维基词典和维基共享资源。它使用 PHP 编程语言编写，并将内容存储在数据库中。与基于类似许可和架构的 WordPress 一样，它已成为其类别中的主流软件。

***.org/wiki/MediaWiki

!logo

如何使用本镜像

启动 mediawiki 实例的基本命令模式如下：

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

如果希望从主机访问实例而无需使用容器的 IP，可以使用标准端口映射：

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

然后，在浏览器中通过 http://localhost:8080 或 [***] 访问。

此镜像支持多种数据库类型，最容易通过标准容器链接使用。在默认配置中，可以使用 SQLite 来避免使用第二个容器并写入平面文件。以下是不同（更适合生产环境的）数据库类型的详细说明。

首次访问此镜像提供的 Web 服务器时，会进行简短的设置过程。以下详细信息专门针对该配置过程中的“设置数据库”步骤。

MySQL

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

• 数据库类型：MySQL、MariaDB 或等效数据库
• 数据库名称/用户名/密码：<访问 MySQL 实例的详细信息>（MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE；参见 mariadb 描述中的环境变量）
• 高级选项；数据库主机：some-mysql（用于通过 --link 添加的 /etc/hosts 条目访问链接容器的 MySQL 实例）

卷

默认情况下，此镜像不包含任何卷。

路径 /var/www/html/images 和 /var/www/html/LocalSettings.php 通常应作为卷，但由于卷无法删除，因此本镜像中未明确声明 VOLUME。

console
$ docker run --rm arm64v8/mediawiki tar -cC /var/www/html/sites . | tar -xC /path/on/host/sites

... 通过 docker compose

mediawiki 的 compose.yaml 示例：

yaml
# MediaWiki 与 MariaDB
#
# 通过 "http://localhost:8080" 访问
services:
  mediawiki:
    image: mediawiki
    restart: always
    ports:
      - 8080:80
    links:
      - database
    volumes:
      - images:/var/www/html/images
      # 初始设置后，将 LocalSettings.php 下载到与此 yaml 相同的目录，取消以下行的注释并使用 compose 重启 mediawiki 服务
      # - ./LocalSettings.php:/var/www/html/LocalSettings.php
  database: # <- 此键定义设置过程中的数据库名称
    image: mariadb
    restart: always
    environment:
      # @see [***]
      MYSQL_DATABASE: my_wiki
      MYSQL_USER: wikiuser
      MYSQL_PASSWORD: example
      MYSQL_RANDOM_ROOT_PASSWORD: 'yes'
    volumes:
      - db:/var/lib/mysql

volumes:
  images:
  db:

运行 docker compose up，等待其完全初始化，然后访问 http://localhost:8080 或 [***]（视情况而定）。

添加额外的库/扩展

此镜像不提供任何额外的 PHP 扩展或其他库，即使它们是流行插件所必需的。可能的插件数量无穷无尽，它们可能需要 PHP 支持的任何扩展。包含所有存在的 PHP 扩展会显著增加镜像大小。

如果需要额外的 PHP 扩展，需要基于此镜像创建自己的镜像。php 镜像的文档 解释了如何编译额外的扩展。

以下 Docker Hub 功能可帮助保持依赖镜像的更新：

• 自动构建 使 Docker Hub 能够在您将更改推送到 Dockerfile 时自动构建它。

镜像变体

arm64v8/mediawiki 镜像有多种版本，每种版本设计用于特定用例。

arm64v8/mediawiki:<version>

这是默认镜像。如果不确定自己的需求，可能需要使用此版本。它既可用作临时容器（挂载源代码并启动容器以启动应用），也可用作构建其他镜像的基础。

arm64v8/mediawiki:<version>-alpine

此镜像基于流行的 Alpine Linux 项目，可在 alpine ***镜像 中获取。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此通常会生成更精简的镜像。

当最终镜像大小尽可能小是主要关注点时，此变体非常有用。需要注意的主要问题是它使用 musl libc 而非 glibc 及类似库，因此软件可能会因对 libc 要求/假设的深度而经常遇到问题。有关可能出现的问题以及使用 Alpine 基础镜像的优缺点比较，请参见 此 Hacker News 评论线程。

为了最小化镜像大小，基于 Alpine 的镜像中通常不包含额外的相关工具（如 git 或 bash）。以此镜像为基础，可在自己的 Dockerfile 中添加所需的工具（如果不熟悉如何安装包，请参见 alpine 镜像描述 中的示例）。

许可证

查看此镜像中包含的软件的 许可证信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可证（如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）约束。

可能在 repo-info 仓库的 mediawiki/ 目录 中找到一些能够自动检测到的额外许可证信息。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。