arm32v7/wordpress Docker镜像文档

镜像概述和主要用途

arm32v7/wordpress是官方WordPress镜像的arm32v7架构构建版本，用于在arm32v7架构设备（如树莓派等）上快速部署WordPress内容管理系统。WordPress是一款基于PHP和MySQL的免费开源博客工具及内容管理系统（CMS），具备插件架构和模板系统，广泛用于搭建博客、企业网站、电商平台等各类网站。

该镜像封装了WordPress核心程序及运行环境，提供多种PHP版本和服务器变体，支持通过环境变量、数据卷和Docker Secrets进行灵活配置，适用于开发、测试及生产环境的快速部署。

核心功能和特性

• 多PHP版本支持：兼容PHP 8.1、8.2、8.3、8.4等版本，满足不同插件对PHP版本的需求
• 多种镜像变体：提供apache（默认，集成Apache服务器）、fpm（FastCGI进程管理器）、fpm-alpine（基于Alpine Linux的轻量FPM版本）及cli（WP-CLI命令行工具）等变体
• 灵活配置：通过环境变量自定义数据库连接、安全密钥、调试模式等核心参数
• 安全强化：支持Docker Secrets管理敏感信息（如数据库密码），避免明文环境变量泄露
• 数据持久化：可通过数据卷挂载/var/www/html目录，实现网站数据（主题、插件、上传文件等）的持久化存储
• 架构适配：专为arm32v7架构优化，可在树莓派等低功耗设备上高效运行

使用场景和适用范围

• arm32v7设备建站：在树莓派、嵌入式设备等arm32v7架构硬件上部署WordPress网站
• 快速开发环境：通过Docker快速搭建隔离的WordPress开发/测试环境，支持版本切换和配置重置
• 轻量级生产部署：配合MySQL容器（如通过docker-compose）构建小型生产环境，适用于流量中等的个人博客或小型企业网站
• CI/CD集成：结合cli变体实现自动化部署、插件安装、数据库迁移等运维任务
• 教学演示：快速搭建WordPress教学环境，展示CMS功能及插件开发

详细使用方法和配置说明

支持的标签及对应Dockerfile链接

完整标签列表可参考官方仓库

环境变量配置

注意：所有数据库相关变量（WORDPRESS_DB_*）需与数据库服务配置匹配，且WORDPRESS_DB_NAME对应的数据库需预先存在。

Docker Secrets支持

可通过_FILE后缀的环境变量从文件加载敏感配置（适用于Docker Swarm等场景），支持的变量包括：WORDPRESS_DB_HOST_FILE, WORDPRESS_DB_USER_FILE, WORDPRESS_DB_PASSWORD_FILE, WORDPRESS_DB_NAME_FILE, WORDPRESS_AUTH_KEY_FILE等安全密钥相关变量。

示例：

$ docker run --name some-wordpress \
  -e WORDPRESS_DB_PASSWORD_FILE=/run/secrets/db-password \
  --secret db-password \
  -d arm32v7/wordpress

部署示例

1. 基础运行（需外部数据库）

# 启动WordPress并映射8080端口
$ docker run --name some-wordpress \
  -p 8080:80 \
  -e WORDPRESS_DB_HOST=db-host:3306 \
  -e WORDPRESS_DB_USER=db-user \
  -e WORDPRESS_DB_PASSWORD=db-pass \
  -e WORDPRESS_DB_NAME=db-name \
  -d arm32v7/wordpress

访问http://localhost:8080完成初始化配置。

2. 使用docker-compose（含MySQL）

创建compose.yaml：

services:
  wordpress:
    image: arm32v7/wordpress:latest
    restart: always
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppass
      WORDPRESS_DB_NAME: wpdb
    volumes:
      - wordpress_data:/var/www/html  # 持久化网站数据

  db:
    image: arm32v7/mysql:8.0  # 对应arm32v7架构的MySQL镜像
    restart: always
    environment:
      MYSQL_DATABASE: wpdb
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: wppass
      MYSQL_RANDOM_ROOT_PASSWORD: '1'  # 自动生成root密码
    volumes:
      - db_data:/var/lib/mysql  # 持久化数据库数据

volumes:
  wordpress_data:
  db_data:

启动服务：

$ docker compose up -d

3. FPM变体配合Nginx反向代理

创建compose.yaml：

services:
  wordpress:
    image: arm32v7/wordpress:fpm
    restart: always
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppass
      WORDPRESS_DB_NAME: wpdb
    volumes:
      - wordpress_data:/var/www/html

  db:
    image: arm32v7/mysql:8.0
    restart: always
    environment:
      MYSQL_DATABASE: wpdb
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: wppass
      MYSQL_RANDOM_ROOT_PASSWORD: '1'
    volumes:
      - db_data:/var/lib/mysql

  nginx:
    image: arm32v7/nginx:alpine
    restart: always
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
      - wordpress_data:/var/www/html
    depends_on:
      - wordpress

volumes:
  wordpress_data:
  db_data:

创建nginx.conf（Nginx配置）：

server {
    listen 80;
    server_name localhost;
    root /var/www/html;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        fastcgi_pass wordpress:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

启动服务：

$ docker compose up -d

安全提示：FPM变体不建议直接暴露端口（-p），需通过反向代理（如Nginx）转发请求。

4. WP-CLI命令行工具使用

# 列出已安装插件（需与WordPress容器共享数据卷）
$ docker run --rm -it \
  --volumes-from some-wordpress \
  -e WORDPRESS_DB_HOST=db-host:3306 \
  -e WORDPRESS_DB_USER=db-user \
  -e WORDPRESS_DB_PASSWORD=db-pass \
  -e WORDPRESS_DB_NAME=db-name \
  arm32v7/wordpress:cli \
  plugin list

高级配置

1. 添加PHP扩展

创建自定义Dockerfile：

FROM arm32v7/wordpress:php8.3-apache

# 安装GD扩展（用于图片处理）
RUN set -eux; \
    apt-get update; \
    apt-get install -y --no-install-recommends \
        libfreetype6-dev \
        libjpeg62-turbo-dev \
        libpng-dev \
    ; \
    docker-php-ext-configure gd --with-freetype --with-jpeg; \
    docker-php-ext-install -j$(nproc) gd; \
    apt-get clean; \
    rm -rf /var/lib/apt/lists/*

构建并运行：

$ docker build -t custom-wordpress .
$ docker run --name some-wordpress -d custom-wordpress

2. 预安装主题/插件

通过数据卷挂载或构建自定义镜像添加主题/插件：

• 运行时挂载：

  $ docker run --name some-wordpress \
    -v ./custom-theme:/var/www/html/wp-content/themes/custom-theme \
    -v ./custom-plugin:/var/www/html/wp-content/plugins/custom-plugin \
    -d arm32v7/wordpress
  

• 构建时集成（适用于静态部署）：

  FROM arm32v7/wordpress:apache
  WORKDIR /usr/src/wordpress
  COPY custom-theme/ ./wp-content/themes/custom-theme/
  COPY custom-plugin/ ./wp-content/plugins/custom-plugin/
  RUN cp -s wp-config-docker.php wp-config.php
  

3. 静态部署（禁止自动更新）

通过构建自定义镜像实现"更新即重新部署"模式：

FROM arm32v7/wordpress:apache
WORKDIR /usr/src/wordpress
# 修改Apache配置以指向/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/

以只读模式运行：

$ docker run --name static-wordpress \
  --read-only \
  --tmpfs /tmp \
  --tmpfs /run \
  -v wp-uploads:/usr/src/wordpress/wp-content/uploads \  # 仅上传目录可写
  -e WORDPRESS_DB_HOST=db:3306 \
  -e WORDPRESS_DB_USER=wpuser \
  -e WORDPRESS_DB_PASSWORD=wppass \
  -e WORDPRESS_DB_NAME=wpdb \
  -d custom-wordpress:static

镜像变体说明

arm32v7/wordpress:<version>（Apache变体）

默认变体，集成Apache Web服务器和PHP模块，开箱即用，无需额外配置Web服务器。适用于快速部署和对性能要求不高的场景。

arm32v7/wordpress:<version>-fpm（FPM变体）

包含PHP-FPM（FastCGI Process Manager），需配合反向代理（如Nginx、Apache）使用。性能优于Apache变体，适用于生产环境，但需额外配置代理服务。

arm32v7/wordpress:<version>-fpm-alpine（Alpine FPM变体）

基于Alpine Linux构建的轻量级FPM版本，镜像体积更小，资源占用更低，适用于资源受限的arm32v7设备。

arm32v7/wordpress:cli（WP-CLI变体）

包含WP-CLI命令行工具，用于管理WordPress（如安装插件、导出数据、执行数据库操作等），不包含Web服务器和WordPress前端。

维护与支持

• 维护者：Docker社区
• 问题反馈：官方仓库Issues
• 支持架构：arm32v7（本文档对应架构）、amd64、arm64v8等（完整列表见官方文档）
• 镜像更新：通过official-images仓库的library/wordpress标签跟踪更新

许可证

WordPress本身遵循GPLv2+许可证。镜像中包含的其他软件（如Apache、PHP等）可能遵循不同许可证，具体请参考repo-info仓库。

使用本镜像即表示您同意遵守所有包含软件的许可证条款。