arm32v6/wordpress

注意： 这是 https://hub.docker.com/_/wordpress 的 arm32v6 构建的“每个架构”仓库——更多信息，请参见官方镜像文档中的“https://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%E3%80%82

快速参考

• 维护者：
  https://github.com/docker-library/wordpress

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

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

• https://github.com/docker-library/wordpress/blob/f143dd4b24dcefc3b633e4a10ed3534d92b91c23/latest/php8.1/fpm-alpine/Dockerfile

• https://github.com/docker-library/wordpress/blob/f143dd4b24dcefc3b633e4a10ed3534d92b91c23/latest/php8.2/fpm-alpine/Dockerfile

• https://github.com/docker-library/wordpress/blob/f143dd4b24dcefc3b633e4a10ed3534d92b91c23/latest/php8.3/fpm-alpine/Dockerfile

• https://github.com/docker-library/wordpress/blob/f143dd4b24dcefc3b633e4a10ed3534d92b91c23/latest/php8.4/fpm-alpine/Dockerfile

• https://github.com/docker-library/wordpress/blob/50da133eabc137fa07c620c77788c1237cf55c8b/cli/php8.1/alpine/Dockerfile

• https://github.com/docker-library/wordpress/blob/50da133eabc137fa07c620c77788c1237cf55c8b/cli/php8.2/alpine/Dockerfile

• https://github.com/docker-library/wordpress/blob/50da133eabc137fa07c620c77788c1237cf55c8b/cli/php8.3/alpine/Dockerfile

• https://github.com/docker-library/wordpress/blob/50da133eabc137fa07c620c77788c1237cf55c8b/cli/php8.4/alpine/Dockerfile

快速参考（续）

• 问题提交地址：
  https://github.com/docker-library/wordpress/issues?q=

• 支持的架构： (https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/wordpress/%E3%80%81https://hub.docker.com/r/arm32v5/wordpress/%E3%80%81https://hub.docker.com/r/arm32v6/wordpress/%E3%80%81https://hub.docker.com/r/arm32v7/wordpress/%E3%80%81https://hub.docker.com/r/arm64v8/wordpress/%E3%80%81https://hub.docker.com/r/i386/wordpress/%E3%80%81https://hub.docker.com/r/ppc64le/wordpress/%E3%80%81https://hub.docker.com/r/riscv64/wordpress/%E3%80%81https://hub.docker.com/r/s390x/wordpress/

• 已发布的镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/wordpress (https://github.com/docker-library/repo-info/commits/master/repos/wordpress)
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fwordpress
  https://github.com/docker-library/official-images/blob/master/library/wordpress (https://github.com/docker-library/official-images/commits/master/library/wordpress)

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/wordpress (https://github.com/docker-library/docs/commits/master/wordpress)

什么是 WordPress？

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

***.org/wiki/WordPress

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/wordpress/logo.png

如何使用本镜像

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

以下环境变量也可用于配置 WordPress 实例（通过 https://github.com/docker-library/wordpress/blob/master/wp-config-docker.php%EF%BC%89%EF%BC%9A

• -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；详见 https://github.com/docker-library/wordpress/pull/142%EF%BC%89

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

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

然后通过浏览器访问 http://localhost:8080 或 http://主机IP: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。

... 通过 https://github.com/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 或 http://主机IP:8080（视情况而定）。

添加额外库 / 扩展

本镜像不提供任何额外的 PHP 扩展或其他库，即使是流行插件可能需要的（例如，https://github.com/docker-library/wordpress/issues/30%EF%BC%89%E3%80%82%E6%8F%92%E4%BB%B6%E6%95%B0%E9%87%8F%E4%BC%97%E5%A4%9A%EF%BC%8C%E5%8F%AF%E8%83%BD%E9%9C%80%E8%A6%81 PHP 支持的任何扩展，包含所有 PHP 扩展会显著增加镜像大小。

若需额外 PHP 扩展，需基于本镜像创建自己的镜像。https://github.com/docker-library/docs/blob/master/php/README.md#how-to-install-more-php-extensions 解释了如何编译额外扩展。此外，https://github.com/docker-library/wordpress/blob/618490d4bdff6c5774b84b717979bfe3d6ba8ad1/apache/Dockerfile#L5-L9 有简化示例，https://github.com/docker-library/wordpress/blob/5bbbfa8909232af10ea3fea8b80302a6041a2d04/latest/php7.4/apache/Dockerfile#L18-L62 有更详细示例。

包含预安装的主题 / 插件

将包含主题或插件的卷挂载到适当目录，并通过“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 安全更新。

以任意用户运行

参见 https://github.com/docker-library/docs/blob/master/php/README.md#running-as-an-arbitrary-user%E3%80%82

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