oorabona/wordpress

WordPress

基于PHP-FPM构建的生产就绪WordPress容器，集成WP-CLI、性能优化和安全强化功能。


快速开始

Docker Compose

yaml
services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - wordpress_data:/var/www/html:ro
    depends_on:
      - wordpress

  wordpress:
    image: ghcr.io/oorabona/wordpress:latest
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_NAME: ${WORDPRESS_DB_NAME}
      WORDPRESS_DB_USER: ${WORDPRESS_DB_USER}
      WORDPRESS_DB_PASSWORD: ${WORDPRESS_DB_PASSWORD}
    volumes:
      - wordpress_data:/var/www/html

  db:
    image: mysql:8.0
    environment:
      MYSQL_DATABASE: ${WORDPRESS_DB_NAME}
      MYSQL_USER: ${WORDPRESS_DB_USER}
      MYSQL_PASSWORD: ${WORDPRESS_DB_PASSWORD}
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql

volumes:
  wordpress_data:
  db_data:

Docker Run

bash
# 启动数据库
docker run -d --name wordpress-db \
  -e MYSQL_DATABASE=wordpress \
  -e MYSQL_USER=wordpress \
  -e MYSQL_PASSWORD=secret \
  -e MYSQL_ROOT_PASSWORD=rootsecret \
  mysql:8.0

# 启动WordPress
docker run -d --name wordpress \
  --link wordpress-db:mysql \
  -e WORDPRESS_DB_HOST=mysql \
  -e WORDPRESS_DB_NAME=wordpress \
  -e WORDPRESS_DB_USER=wordpress \
  -e WORDPRESS_DB_PASSWORD=secret \
  -v wordpress_data:/var/www/html \
  ghcr.io/oorabona/wordpress:latest

# 启动Web服务器（Nginx示例）
docker run -d --name nginx \
  --link wordpress:wordpress \
  -p 80:80 \
  -v wordpress_data:/var/www/html:ro \
  -v ./nginx.conf:/etc/nginx/nginx.conf:ro \
  nginx:alpine

重要提示： 此容器在9000端口运行PHP-FPM，而非Web服务器。必须配合Nginx、Apache或其他反向代理来处理HTTP流量。

特性

• 基于PHP镜像 - 继承自https://github.com/oorabona/docker-containers/tree/master/php%E7%9A%84%E6%89%80%E6%9C%89PHP%E6%89%A9%E5%B1%95%EF%BC%88gd%E3%80%81mysqli%E3%80%81opcache%E3%80%81zip%E7%AD%89%EF%BC%89
• 内置WP-CLI - WordPress管理命令行工具
• 性能优化 - 针对WordPress优化的OPcache设置，提升性能
• 安全强化 - 非root用户运行、有限sudo权限、最小化依赖
• 基于Alpine - 镜像体积小，启动速度快
• MariaDB客户端 - 包含数据库调试工具

构建参数

环境变量

继承自基础PHP镜像的其他PHP-FPM环境变量。

卷

对于插件/主题开发，可挂载特定目录：

yaml
volumes:
  - wordpress_data:/var/www/html
  - ./my-theme:/var/www/html/wp-content/themes/my-theme
  - ./my-plugin:/var/www/html/wp-content/plugins/my-plugin

端口

注意： 此容器不暴露80/443端口。必须使用反向代理（Nginx、Apache、Caddy）来处理HTTP流量。参见Nginx配置示例。

WP-CLI使用

在运行中的容器内执行WP-CLI命令：

bash
# 检查WP-CLI信息
docker exec wordpress wp --info

# 安装插件
docker exec wordpress wp plugin install contact-form-7 --activate

# 更新核心
docker exec wordpress wp core update

# 列出用户
docker exec wordpress wp user list

# 数据库操作
docker exec wordpress wp db check
docker exec wordpress wp db optimize

Nginx配置

通过FastCGI服务WordPress的Nginx配置示例：

nginx
upstream php {
    server wordpress:9000;
}

server {
    listen 80;
    server_name example.com;

    root /var/www/html;
    index index.php;

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

    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass php;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }

    location ~ /\.ht {
        deny all;
    }
}

安全

基础安全

• Alpine Linux - 最小化***面，精选软件包
• 非root用户 - 容器以wordpress用户运行（非root）
• 有限sudo权限 - sudo访问仅限于/usr/local/bin/wp
• 定期更新 - 上游变更时自动重建

运行时强化

yaml
services:
  wordpress:
    image: ghcr.io/oorabona/wordpress:latest
    read_only: true
    tmpfs:
      - /tmp
      - /run
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETGID
      - SETUID
    security_opt:
      - no-new-privileges:true
    volumes:
      - wordpress_data:/var/www/html
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_NAME: ${WORDPRESS_DB_NAME}
      WORDPRESS_DB_USER: ${WORDPRESS_DB_USER}
      WORDPRESS_DB_PASSWORD: ${WORDPRESS_DB_PASSWORD}

###凭证管理切勿硬编码密码：```yaml

错误示例

environment: WORDPRESS_DB_PASSWORD: mysecretpassword

良好示例 - 环境变量

environment: WORDPRESS_DB_PASSWORD: ${WORDPRESS_DB_PASSWORD}

更佳示例 - Docker secrets

secrets: db_password: file: ./secrets/db_password.txt environment: WORDPRESS_DB_PASSWORD_FILE: /run/secrets/db_password

## 性能调优

### WordPress优化的OPcache设置

容器包含优化的OPcache配置：

```ini
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000
opcache.revalidate_freq=2
opcache.fast_shutdown=1
opcache.enable_cli=1

PHP资源限制

继承自基础PHP镜像：

• 内存限制：512M
• 上传限制：64M
• 执行时间：300s

可通过环境变量或自定义PHP配置文件覆盖。

依赖项

依赖版本通过CI/CD自动监控和更新。

健康检查

内置健康检查验证PHP-FPM状态：

bash
# 手动健康检查
docker exec wordpress php-fpm -t

# Docker健康状态
docker inspect --format='{{.State.Health.Status}}' wordpress

备份与恢复

数据库备份

bash
# 通过WP-CLI备份
docker exec wordpress wp db export /tmp/backup.sql

# 将备份复制出容器
docker cp wordpress:/tmp/backup.sql ./backup.sql

文件备份

bash
# 备份WordPress文件
docker exec wordpress tar -czf /tmp/wp-files.tar.gz /var/www/html

# 复制备份文件
docker cp wordpress:/tmp/wp-files.tar.gz ./wp-files.tar.gz

恢复

bash
# 恢复数据库
docker exec -i wordpress wp db import - < backup.sql

# 恢复文件
docker cp wp-files.tar.gz wordpress:/tmp/
docker exec wordpress tar -xzf /tmp/wp-files.tar.gz -C /

本地构建

bash
# 使用默认版本构建
./make build wordpress

# 使用特定PHP版本构建
docker build \
  --build-arg PHP_IMAGE=ghcr.io/oorabona/php:8.2-fpm-alpine \
  --build-arg WPCLI_VERSION=2.12.0 \
  -t wordpress:custom .

# 检查当前版本
./version.sh current

# 检查最新上游版本
./version.sh latest

架构

wordpress/
├── Dockerfile              # 基于PHP镜像的多阶段构建
├── config.yaml             # WP-CLI版本和依赖配置
├── docker-compose.yml      # 示例compose文件
├── docker-entrypoint.sh    # 容器入口脚本
├── version.sh              # 版本发现脚本
└── README.md               # 本文档

容器层

Alpine Linux
  └── PHP-FPM (来自oorabona/php)
      └── WordPress附加组件
          ├── WP-CLI
          ├── MariaDB客户端
          ├── WordPress优化的OPcache
          └── 安全强化

链接

• https://hub.docker.com/r/oorabona/wordpress
• GitHub容器注册表
• https://github.com/oorabona/docker-containers/tree/master/wordpress
• https://github.com/oorabona/docker-containers/tree/master/php
• WP-CLI文档
• WordPress文档