WordPress Docker镜像（amd64架构）文档

镜像概述

关于本镜像

本镜像为官方WordPress镜像的amd64架构专用仓库。有关多架构支持的更多信息，请参见官方镜像文档中的“非amd64架构”说明及官方镜像FAQ中的“镜像源变更处理”。

维护与支持

• 维护者：Docker社区
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow
• ** issue提交**：GitHub Issues

核心功能与特性

WordPress是一款基于PHP和MySQL的免费开源博客工具及内容管理系统（CMS），支持插件架构和模板系统，被广泛用于搭建各类网站。本Docker镜像具备以下特性：

• 多版本支持：集成WordPress 6.8.3及PHP 8.1~8.4版本组合
• 灵活部署选项：提供Apache、FPM、FPM-Alpine三种服务器变体
• 轻量级选择：Alpine Linux基础镜像版本减少镜像体积
• 安全配置：支持Docker Secrets管理敏感信息，避免环境变量明文暴露
• 可扩展性：支持自定义PHP扩展、预装主题/插件及静态部署模式
• 兼容性：支持非特权用户运行，符合容器安全最佳实践

支持的标签与架构

支持的标签

以下为主要标签及其对应的Dockerfile链接（按PHP版本分组）：

PHP 8.1

• Apache：6.8.3-php8.1-apache, 6.8-php8.1-apache, 6-php8.1-apache, php8.1-apache, 6.8.3-php8.1, 6.8-php8.1, 6-php8.1, php8.1 Dockerfile
• FPM：6.8.3-php8.1-fpm, 6.8-php8.1-fpm, 6-php8.1-fpm, php8.1-fpm Dockerfile
• FPM-Alpine：6.8.3-php8.1-fpm-alpine, 6.8-php8.1-fpm-alpine, 6-php8.1-fpm-alpine, php8.1-fpm-alpine Dockerfile

PHP 8.2

• Apache：6.8.3-php8.2-apache, 6.8-php8.2-apache, 6-php8.2-apache, php8.2-apache, 6.8.3-php8.2, 6.8-php8.2, 6-php8.2, php8.2 Dockerfile
• FPM：6.8.3-php8.2-fpm, 6.8-php8.2-fpm, 6-php8.2-fpm, php8.2-fpm Dockerfile
• FPM-Alpine：6.8.3-php8.2-fpm-alpine, 6.8-php8.2-fpm-alpine, 6-php8.2-fpm-alpine, php8.2-fpm-alpine Dockerfile

PHP 8.3（默认版本）

• Apache：6.8.3-apache, 6.8-apache, 6-apache, apache, 6.8.3, 6.8, 6, latest, 6.8.3-php8.3-apache, 6.8-php8.3-apache, 6-php8.3-apache, php8.3-apache, 6.8.3-php8.3, 6.8-php8.3, 6-php8.3, php8.3 Dockerfile
• FPM：6.8.3-fpm, 6.8-fpm, 6-fpm, fpm, 6.8.3-php8.3-fpm, 6.8-php8.3-fpm, 6-php8.3-fpm, php8.3-fpm Dockerfile
• 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 Dockerfile

PHP 8.4

• Apache：6.8.3-php8.4-apache, 6.8-php8.4-apache, 6-php8.4-apache, php8.4-apache, 6.8.3-php8.4, 6.8-php8.4, 6-php8.4, php8.4 Dockerfile
• FPM：6.8.3-php8.4-fpm, 6.8-php8.4-fpm, 6-php8.4-fpm, php8.4-fpm Dockerfile
• FPM-Alpine：6.8.3-php8.4-fpm-alpine, 6.8-php8.4-fpm-alpine, 6-php8.4-fpm-alpine, php8.4-fpm-alpine Dockerfile

CLI工具

• cli-2.12.0-php8.1, cli-2.12-php8.1, cli-2-php8.1, cli-php8.1 Dockerfile
• cli-2.12.0-php8.2, cli-2.12-php8.2, cli-2-php8.2, cli-php8.2 Dockerfile
• 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 Dockerfile
• cli-2.12.0-php8.4, cli-2.12-php8.4, cli-2-php8.4, cli-php8.4 Dockerfile

支持的架构

除amd64外，官方WordPress镜像还支持：arm32v5, arm32v6, arm32v7, arm64v8, i386, ppc64le, riscv64, s390x（需使用对应架构仓库，如arm64v8/wordpress）

使用场景与适用范围

本镜像适用于以下场景：

• 个人博客/自媒体：快速搭建具备丰富主题和插件的博客系统
• 企业官网：通过CMS功能管理产品信息、新闻动态等内容
• 电商网站：配合WooCommerce等插件构建在线商店
• 开发测试：隔离开发环境，确保不同项目依赖兼容性
• 生产部署：通过Docker Compose或容器编排工具实现高可用部署

使用方法与配置说明

快速启动（基础命令）

基本运行

$ docker run --name some-wordpress --network some-network -d amd64/wordpress

端口映射（主机访问）

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

启动后通过http://localhost:8080或[***]访问。

环境变量配置

通过环境变量可配置WordPress实例，所有变量支持_FILE后缀（从文件读取值，用于Docker Secrets）：

注意：WORDPRESS_DB_NAME需提前在数据库中创建，容器不会自动创建数据库。

Docker Secrets使用

通过_FILE后缀从Docker Secrets读取敏感信息：

$ docker run --name some-wordpress \
  -e WORDPRESS_DB_PASSWORD_FILE=/run/secrets/mysql-password \
  -e WORDPRESS_AUTH_KEY_FILE=/run/secrets/wp-auth-key \
  --secret mysql-password \
  --secret wp-auth-key \
  -d amd64/wordpress

Docker Compose部署示例

创建compose.yaml文件：

services:
  wordpress:
    image: amd64/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_data:/var/www/html  # 持久化WordPress数据

  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_DATABASE: exampledb
      MYSQL_USER: exampleuser
      MYSQL_PASSWORD: examplepass
      MYSQL_RANDOM_ROOT_PASSWORD: "1"  # 自动生成root密码
    volumes:
      - db_data:/var/lib/mysql  # 持久化数据库数据

volumes:
  wordpress_data:
  db_data:

启动服务：

$ docker compose up -d

高级配置

添加PHP扩展

基于本镜像构建自定义镜像以添加扩展（示例：安装GD库）：

FROM amd64/wordpress:apache
RUN set -eux; \
    apt-get update; \
    apt-get install -y --no-install-recommends libpng-dev; \
    docker-php-ext-install gd; \
    apt-get clean; \
    rm -rf /var/lib/apt/lists/*

预装主题/插件

• 运行时挂载：将主题/插件目录挂载到/var/www/html/wp-content/themes/或/var/www/html/wp-content/plugins/
• 构建时集成：在自定义镜像中复制到/usr/src/wordpress/wp-content/（容器首次启动时复制到/var/www/html/）

静态部署模式（更新通过重新部署）

构建只读镜像（禁止容器内更新）：

FROM amd64/wordpress:apache
WORKDIR /usr/src/wordpress
RUN set -eux; \
    # 修改Apache配置指向源码目录
    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/

启动只读容器：

$ docker run --read-only \
  --tmpfs /tmp \
  --tmpfs /run \
  -v wp_uploads:/usr/src/wordpress/wp-content/uploads \  # 仅上传目录