excaliburpartners/wordpress

WordPress Docker镜像（含Postfix和日历模块）

基于官方WordPress镜像的自定义Docker镜像，增强功能包括：

• 带OpenDKIM签名的Postfix邮件中继支持
• PHP Calendar扩展
• 安全加固（禁用Apache/PHP版本暴露）

构建镜像

构建脚本使用Docker Buildx创建多平台镜像，支持Intel/AMD（x86_64）和ARM（Apple Silicon M1/M2/M3、ARM服务器）架构。

工作原理

1. 构建脚本拉取指定PHP版本的官方wordpress:php{VERSION}-apache镜像
2. 从基础镜像的/usr/src/wordpress/wp-includes/version.php自动检测WordPress版本
3. 构建包含Postfix和PHP日历的自定义镜像
4. 为镜像添加8个符合WordPress版本规范的标签

确保自定义镜像始终与官方镜像的WordPress版本保持一致。

注意：不同PHP版本可能对应不同的WordPress版本。例如：

• PHP 7.4可能使用WordPress 6.1.1（支持PHP 7.4的最后版本）
• PHP 8.3/8.4可能使用WordPress 6.8.3（最新版本）

前提条件

确保Docker Buildx可用（Docker Desktop和最新Docker Engine版本已包含）：

bash
docker buildx version

镜像标签方案

每个构建为每个PHP版本创建8个标签，遵循官方WordPress镜像命名规范。

WordPress版本从基础镜像wordpress:php{VERSION}-apache自动检测。

例如，构建PHP 8.3（使用wordpress:php8.3-apache作为基础镜像）会自动检测WordPress版本并创建：

• 6.8.3-php8.3-apache（完整版本带Apache）
• 6.8-php8.3-apache（次要版本带Apache）
• 6-php8.3-apache（主要版本带Apache）
• php8.3-apache（仅PHP版本带Apache）
• 6.8.3-php8.3（完整版本）
• 6.8-php8.3（次要版本）
• 6-php8.3（主要版本）
• php8.3（仅PHP版本）

构建单个版本

bash
# 使用默认设置构建（PHP 8.3，WordPress自动检测）
./build.sh 8.3

# 使用自定义镜像名称构建
./build.sh 8.3 myrepo/wordpress

# 构建并推送到Docker Hub或 registry
./build.sh 8.3 myrepo/wordpress --push

# 构建并本地加载（仅单平台）
./build.sh 8.3 myrepo/wordpress --load

构建所有版本

bash
# 构建所有PHP版本（每个版本自动检测WordPress版本）
./build.sh all myrepo/wordpress

# 构建所有版本并推送到 registry
./build.sh all myrepo/wordpress --push

这将为每个PHP版本（7.4、8.3、8.4）创建8个标签。每个镜像支持linux/amd64和linux/arm64平台。

构建选项

注意：多平台镜像无法直接加载到Docker。使用--push推送到registry，或--load进行本地测试（单平台）。

使用Makefile

bash
# 构建单个版本
make build
make build PHP_VERSION=8.3
make build IMAGE_NAME=myrepo/wordpress

# 构建并推送
make push IMAGE_NAME=myrepo/wordpress
make push-all IMAGE_NAME=myrepo/wordpress

# 构建并本地加载
make load PHP_VERSION=8.4

# 查看所有选项
make help

环境变量

Postfix配置

DKIM配置

注意：设置DKIM_SELECTOR后，DKIM签名自动启用。如果密钥不存在，将在首次启动时生成，并在日志中显示DNS记录。

WordPress配置

支持所有标准WordPress环境变量。参见https://hub.docker.com/_/wordpress%E3%80%82

首次运行 - DNS配置

启用DKIM的首次启动时，将自动生成密钥。DNS记录将显示在日志中：

bash
docker logs wordpress

# 输出将包含：
# ==========================================
# DKIM DNS记录
# ==========================================
# 添加此TXT记录到您的DNS：
#
# wordpress._domainkey IN TXT ( "v=DKIM1; h=sha256; k=rsa; "
#     "p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA..." )
#
# ==========================================

复制DNS记录并添加到域名的DNS设置中。

持久化DKIM密钥

要跨容器重启持久化DKIM密钥，挂载卷：

bash
docker run -d \
  -v dkim_keys:/etc/opendkim/keys \
  -e MAIL_FROM_DOMAIN=yourdomain.com \
  -e DKIM_SELECTOR=wordpress \
  docker.xuanyuan.run/myrepo/wordpress:php8.3-apache

使用示例

Docker Run

bash
docker run -d \
  --name wordpress \
  -p 8080:80 \
  -v dkim_keys:/etc/opendkim/keys \
  -e MAIL_FROM_DOMAIN='yourdomain.com' \
  -e POSTFIX_RELAYHOST='[smtp.gmail.com]:587' \
  -e POSTFIX_SMTP_USERNAME='your-email@gmail.com' \
  -e POSTFIX_SMTP_PASSWORD='your-app-password' \
  -e DKIM_SELECTOR='wordpress' \
  -e WORDPRESS_DB_HOST=mysql:3306 \
  -e WORDPRESS_DB_USER=wordpress \
  -e WORDPRESS_DB_PASSWORD=wordpress \
  -e WORDPRESS_DB_NAME=wordpress \
  docker.xuanyuan.run/myrepo/wordpress:6.8.3-php8.3-apache

# 可用标签：
# myrepo/wordpress:6.8-php8.3-apache
# myrepo/wordpress:6-php8.3-apache
# myrepo/wordpress:php8.3-apache
# myrepo/wordpress:6.8.3-php8.3
# myrepo/wordpress:php8.3

Docker Compose

yaml
services:
  wordpress:
    image: docker.xuanyuan.run/myrepo/wordpress:6.8.3-php8.3-apache
    # 或使用其他标签：6.8-php8.3-apache, 6-php8.3-apache, php8.3-apache等
    ports:
      - "8080:80"
    environment:
      # WordPress数据库配置
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress_db_password
      WORDPRESS_DB_NAME: wordpress

      # 邮件配置
      MAIL_FROM_DOMAIN: 'yourdomain.com'

      # DKIM配置（可选）
      DKIM_SELECTOR: 'wordpress'

      # Postfix中继配置
      POSTFIX_RELAYHOST: '[smtp.gmail.com]:587'
      POSTFIX_SMTP_USERNAME: 'your-email@gmail.com'
      POSTFIX_SMTP_PASSWORD: 'your-app-password'
    volumes:
      - wordpress_data:/var/www/html
      - dkim_keys:/etc/opendkim/keys
    depends_on:
      - db

  db:
    image: docker.xuanyuan.run/mysql:8.0
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress_db_password
      MYSQL_ROOT_PASSWORD: mysql_root_password
    volumes:
      - db_data:/var/lib/mysql

volumes:
  wordpress_data:
  dkim_keys:
  db_data:

Postfix中继配置示例

Gmail

bash
POSTFIX_RELAYHOST='[smtp.gmail.com]:587'
POSTFIX_SMTP_USERNAME='your-email@gmail.com'
POSTFIX_SMTP_PASSWORD='your-app-password'

注意：Gmail需使用https://support.google.com/accounts/answer/***%E3%80%82

SendGrid

bash
POSTFIX_RELAYHOST='[smtp.sendgrid.net]:587'
POSTFIX_SMTP_USERNAME='apikey'
POSTFIX_SMTP_PASSWORD='your-sendgrid-api-key'

Amazon SES

bash
POSTFIX_RELAYHOST='[email-smtp.us-east-1.amazonaws.com]:587'
POSTFIX_SMTP_USERNAME='your-smtp-username'
POSTFIX_SMTP_PASSWORD='your-smtp-password'

Mailgun

bash
POSTFIX_RELAYHOST='[smtp.mailgun.org]:587'
POSTFIX_SMTP_USERNAME='postmaster@your-domain.mailgun.org'
POSTFIX_SMTP_PASSWORD='your-mailgun-smtp-password'

查看日志

bash
# 查看所有日志（Apache + Postfix）
docker logs wordpress

# 实时跟踪日志
docker logs -f wordpress

# 查看最后100行
docker logs --tail 100 wordpress

# 仅过滤Postfix日志
docker logs wordpress 2>&1 | grep postfix

测试邮件

PHP已配置为使用Postfix的mail()函数。

命令行测试

bash
# 进入容器
docker exec -it wordpress bash

# 通过命令行发送测试邮件
echo "测试邮件正文" | mail -s "测试主题" recipient@example.com

# 测试PHP邮件函数
php -r "mail('recipient@example.com', '测试主题', '来自PHP的测试消息');"

# 退出并从容器外查看日志
exit
docker logs -f wordpress
# 会看到Postfix处理邮件的日志

WordPress邮件测试

WordPress将自动使用PHP的mail()函数，该函数现在通过Postfix路由：

1. 安装WordPress插件如"WP Mail SMTP"或"Check Email"
2. 从WordPress管理界面发送测试邮件
3. 检查Docker日志查看Postfix处理邮件的情况：

   bash
   docker logs -f wordpress | grep postfix
   

许可证

本项目遵循与官方WordPress Docker镜像相同的许可证。