cyberpearuk/wp-nginx-docker

WordPress Nginx Docker镜像

镜像概述和主要用途

本镜像为运行WordPress量身定制，集成PHP-FPM和Nginx，内置安全措施。适用于需要便捷部署、版本控制和灵活配置的WordPress应用场景，提供稳定高效的运行环境。

核心功能和特性

• 集成PHP-FPM和Nginx，优化WordPress运行环境
• 内置安全加固措施，提升应用安全性
• 预装WordPress，无需首次运行时安装
• 支持通过外部.env文件加载环境变量，便于配置管理
• 环境变量可动态更新，修改后重启容器即可生效
• 包含Sendmail测试工具，方便邮件功能调试

环境变量配置

可挂载的环境变量

本镜像支持在启动时从预定义位置加载环境变量，允许通过挂载外部.env文件加载共享/通用设置。需将外部.env文件挂载至容器内路径/var/common/.env，这些变量将在容器启动时由入口脚本加载。

邮件设置

• EMAIL_SMTP_HOST - 远程SMTP服务器主机名
• EMAIL_SMTP_PORT - 远程SMTP端口
• EMAIL_AUTH_USER - 远程SMTP用户名
• EMAIL_AUTH_PASS - 远程SMTP用户密码
• EMAIL_HOST - 邮件发送主机

默认启用TLS，且不支持开箱即改配置。

Web服务器设置

• VIRTUAL_HOST - 服务器主机名（用于ServerName配置）

使用说明和注意事项

临时WordPress安装

官方WordPress镜像在首次运行时才安装WordPress（即仅当安装目录中不存在WordPress时才复制文件）。本镜像已预装WordPress，其安装为临时性——仅将wp-content目录设为卷，而非整个WordPress安装目录。这意味着镜像本身控制WordPress版本，便于精确控制运行环境（Docker的主要优势之一）。

动态环境变量

官方镜像仅在首次运行时使用环境变量（因此首次运行后环境变量失效）。本镜像持续引用环境变量，例如若需更改数据库凭据，只需更新环境变量并重启容器（官方WordPress镜像需在运行中的容器内修改）。

实现方式：wp-config.php为临时文件，直接从PHP引用环境变量；安装特定内容（如WordPress安全密钥）存储在单独卷中。

Sendmail测试

本容器最初为支持邮件发送创建，包含bash脚本test-sendmail <email-address>，可通过PHP和bash CLI直接发送测试邮件。

bash
docker exec -it <container> test-sendmail me@mail.com

维护者

本仓库由[***]