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

快速参考

• 维护者：
  Docker社区

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

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

• 6.8.3-php8.1-fpm-alpine, 6.8-php8.1-fpm-alpine, 6-php8.1-fpm-alpine, php8.1-fpm-alpine

• 6.8.3-php8.2-fpm-alpine, 6.8-php8.2-fpm-alpine, 6-php8.2-fpm-alpine, php8.2-fpm-alpine

• 6.8.3-fpm-alpine, 6.8-fpm-alpine, 6-fpm-alpine, fpm-alpine, 6.8.3-php8.3-fpm-alpine, 6.8-php8.3-fpm-alpine, 6-php8.3-fpm-alpine, php8.3-fpm-alpine

• 6.8.3-php8.4-fpm-alpine, 6.8-php8.4-fpm-alpine, 6-php8.4-fpm-alpine, php8.4-fpm-alpine

• cli-2.12.0-php8.1, cli-2.12-php8.1, cli-2-php8.1, cli-php8.1

• cli-2.12.0-php8.2, cli-2.12-php8.2, cli-2-php8.2, cli-php8.2

• cli-2.12.0, cli-2.12, cli-2, cli, cli-2.12.0-php8.3, cli-2.12-php8.3, cli-2-php8.3, cli-php8.3

• cli-2.12.0-php8.4, cli-2.12-php8.4, cli-2-php8.4, cli-php8.4

快速参考（续）

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

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

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

• 镜像更新：
  official-images 仓库的 library/wordpress 标签
  official-images 仓库的 library/wordpress 文件 (历史记录)

• 本描述的来源：
  docs 仓库的 wordpress/ 目录 (历史记录)

什么是 WordPress？

WordPress 是一款免费开源的博客工具和内容管理系统（CMS），基于 PHP 和 MySQL，运行在 Web 托管服务上。其特性包括插件架构和模板系统。截至 2013 年 8 月，WordPress 被超过 22.0% 的 top 1000 万网站使用，是 Web 上最流行的博客系统，应用于超过 6000 万个网站。最常用的语言包括英语、西班牙语和印尼语。

***.org/wiki/WordPress

!logo

如何使用本镜像

console
$ docker run --name some-wordpress --network some-network -d arm32v6/wordpress

以下环境变量也可用于配置 WordPress 实例（通过 自定义的 wp-config.php 实现）：

• -e WORDPRESS_DB_HOST=...：数据库主机地址
• -e WORDPRESS_DB_USER=...：数据库用户名
• -e WORDPRESS_DB_PASSWORD=...：数据库密码
• -e WORDPRESS_DB_NAME=...：数据库名称（需预先存在于 MySQL 服务器中，容器不会自动创建）
• -e WORDPRESS_TABLE_PREFIX=...：数据库表前缀
• -e WORDPRESS_AUTH_KEY=...、-e WORDPRESS_SECURE_AUTH_KEY=...、-e WORDPRESS_LOGGED_IN_KEY=...、-e WORDPRESS_NONCE_KEY=...、-e WORDPRESS_AUTH_SALT=...、-e WORDPRESS_SECURE_AUTH_SALT=...、-e WORDPRESS_LOGGED_IN_SALT=...、-e WORDPRESS_NONCE_SALT=...：安全密钥（默认使用唯一随机 SHA1 值，但仅在提供其他环境变量配置时生效）
• -e WORDPRESS_DEBUG=1：启用调试模式（默认禁用，非空值将在 wp-config.php 中启用 WP_DEBUG）
• -e WORDPRESS_CONFIG_EXTRA=...：额外配置（默认为空，值将通过 wp-config.php 中的 eval() 函数评估，特别适用于添加默认不提供的配置，如 WP_ALLOW_MULTISITE；详见 docker-library/wordpress#142）

若需从主机访问实例而不使用容器 IP，可使用标准端口映射：

console
$ docker run --name some-wordpress -p 8080:80 -d arm32v6/wordpress

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

当 WordPress 与 TLS 一起在反向代理（如 NGINX）后运行（由反向代理负责 TLS 终止）时，需确保正确设置 X-Forwarded-Proto（参见上游文档中“Administration Over SSL”的“使用反向代理”部分）。无需额外环境变量或配置（若指定了上述任一环境变量，本镜像会自动将 HTTP_X_FORWARDED_PROTO 相关代码添加到 wp-config.php）。

若数据库需要 SSL，WordPress ticket #28625 包含上游支持相关详情。作为解决方法，可将 “Secure DB Connection”插件 提取到 WordPress 目录，并在 wp-config.php 中添加该插件配置中描述的适当值。

Docker Secrets

作为通过环境变量传递敏感信息的替代方案，可在上述环境变量后附加 _FILE，使初始化脚本从容器内的文件加载这些变量的值。特别是，这可用于从存储在 /run/secrets/<secret_name> 文件中的 Docker secrets 加载密码。例如：

console
$ docker run --name some-wordpress -e WORDPRESS_DB_PASSWORD_FILE=/run/secrets/mysql-root ... -d arm32v6/wordpress:tag

目前支持的变量包括：WORDPRESS_DB_HOST、WORDPRESS_DB_USER、WORDPRESS_DB_PASSWORD、WORDPRESS_DB_NAME、WORDPRESS_AUTH_KEY、WORDPRESS_SECURE_AUTH_KEY、WORDPRESS_LOGGED_IN_KEY、WORDPRESS_NONCE_KEY、WORDPRESS_AUTH_SALT、WORDPRESS_SECURE_AUTH_SALT、WORDPRESS_LOGGED_IN_SALT、WORDPRESS_NONCE_SALT、WORDPRESS_TABLE_PREFIX 和 WORDPRESS_DEBUG。

... 通过 docker compose

wordpress 的 compose.yaml 示例：

yaml
services:
  wordpress:
    image: wordpress
    restart: always
    ports:
      - 8080:80
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: exampleuser
      WORDPRESS_DB_PASSWORD: examplepass
      WORDPRESS_DB_NAME: exampledb
    volumes:
      - wordpress:/var/www/html

  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_DATABASE: exampledb
      MYSQL_USER: exampleuser
      MYSQL_PASSWORD: examplepass
      MYSQL_RANDOM_ROOT_PASSWORD: '1'
    volumes:
      - db:/var/lib/mysql

volumes:
  wordpress:
  db:

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

添加额外库 / 扩展

本镜像不提供任何额外的 PHP 扩展或其他库，即使是流行插件可能需要的（例如，无法发送电子邮件）。插件数量众多，可能需要 PHP 支持的任何扩展，包含所有 PHP 扩展会显著增加镜像大小。

若需额外 PHP 扩展，需基于本镜像创建自己的镜像。php 镜像文档 解释了如何编译额外扩展。此外，旧版 arm32v6/wordpress 的 Dockerfile 有简化示例，同一 Dockerfile 的新版 有更详细示例。

包含预安装的主题 / 插件

将包含主题或插件的卷挂载到适当目录，并通过“wp-admin”界面应用。确保用户具有读写执行权限：

• 主题放在 /var/www/html/wp-content/themes/ 的子目录中
• 插件放在 /var/www/html/wp-content/plugins/ 的子目录中

若需在镜像中提供额外内容以部署到多个实例，可将内容放在 /usr/src/wordpress/ 下的相同目录中（容器初始启动时会复制到 /var/www/html/）。

静态镜像 / 通过重新部署更新

本镜像的默认配置与*** WordPress 一致，启用自动更新（初始安装来自镜像，之后通过 /var/www/html 数据卷自我管理）。

若需更静态的部署（类似于其他容器化应用）并通过部署新容器更新 WordPress + 主题/插件，可使用以下方法（并以只读方式运行生成的镜像）：

dockerfile
FROM arm32v6/wordpress:apache
WORKDIR /usr/src/wordpress
RUN set -eux; \
	find /etc/apache2 -name '*.conf' -type f -exec sed -ri -e "s!/var/www/html!$PWD!g" -e "s!Directory /var/www/!Directory $PWD!g" '{}' +; \
	cp -s wp-config-docker.php wp-config.php
COPY custom-theme/ ./wp-content/themes/custom-theme/
COPY custom-plugin/ ./wp-content/plugins/custom-plugin/

对于基于 FPM 的镜像，删除 find 指令，并将反向代理中的 SCRIPT_FILENAME 路径从 /var/www/html 调整为 /usr/src/wordpress。

以只读方式运行结果镜像，为 /tmp、/run 和（可选）wp-content/uploads 提供可写存储：

console
$ docker run ... \
	--read-only \
	--tmpfs /tmp \
	--tmpfs /run \
	--mount type=...,src=...,dst=/usr/src/wordpress/wp-content/uploads \
	... \
	--env WORDPRESS_DB_HOST=... \
	--env WORDPRESS_AUTH_KEY=... \
	--env ... \
	custom-wordpress:tag

注意： 需定期重建和重新部署以确保获取所有最新的 WordPress 安全更新。

以任意用户运行

参见 php 镜像文档的“以任意用户运行”部分。

通过本镜像的 cli 变体运行 WP-CLI 时，需注意它们基于 Alpine，默认 USER 是 Alpine 的 www-data（UID 为 82），而基于 Debian 的 WordPress 变体的默认有效 U