注意： 这是mediawiki官方镜像的amd64架构构建的“per-architecture”仓库——更多信息，请参见官方镜像文档中的“除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

快速参考（续）

-** 提交issues的位置：[*]

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

-** 已发布镜像工件详情：**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实例的基本命令模式如下：

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

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

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

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

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

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

MySQL

$ docker run --name some-mediawiki --link some-mysql:mysql -d amd64/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声明，因为卷无法删除。

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

... 通过docker compose

mediawiki的compose.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。

镜像变体

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

amd64/mediawiki:<version>

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

amd64/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/目录中找到一些能够自动检测到的额外许可证信息。

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