
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
这是一个基于apache2和composer构建的最小化WordPress镜像。可通过已安装的https://github.com/wp-cli/wp-cli/%E7%AE%A1%E7%90%86%E5%AE%89%E8%A3%85%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E8%B6%B3%E4%BB%A5%E5%9C%A8%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E8%BF%90%E8%A1%8C%EF%BC%8C%E6%88%96%E5%9C%A8%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E4%B8%AD%E9%85%8D%E5%90%88%E4%BB%A3%E7%90%86%E4%BD%BF%E7%94%A8%E3%80%82%E9%BB%98%E8%AE%A4%E5%86%85%E7%BD%AESSL%E6%94%AF%E6%8C%81%EF%BC%8C%E5%B9%B6%E5%AF%B9%60/wp-admin/%60%E8%B7%AF%E5%BE%84%E5%BC%BA%E5%88%B6HTTPS%E9%87%8D%E5%AE%9A%E5%90%91%E3%80%82
开发时,可将本地/wp-content文件夹挂载到容器内的/var/www/html/wp-content目录,本地更改将在刷新页面时即时生效。
bashdocker run -h docker.example.com \ -p 80:80 \ --name wordpress \ --link mysql:mysql \ -v `pwd`/wp-content:/var/www/html/wp-content \ wordpress:vanilla
可通过环境变量调整多项WordPress设置以适应开发环境,支持的参数如下表:
| 变量 | 类型 | 描述 |
|---|---|---|
| DB_PREFIX | string | 数据库表前缀 |
| FORCE_SSL_ADMIN | boolean | 是否强制WordPress管理区域使用SSL,默认:true |
| DISALLOW_FILE_EDIT | boolean | 是否允许在管理区域编辑插件和主题文件,默认:true |
| WP_MEMORY_LIMIT | string | 前端请求最大内存,格式为([\d]+[M |
| WP_MAX_MEMORY_LIMIT | string | 管理区域请求最大内存,格式为([\d]+[M |
| WP_DEBUG | boolean | 是否启用WordPress调试模式,默认:true |
| WP_DEBUG_DISPLAY | boolean | 是否显示调试警告,默认:false |
| SAVEQUERIES | boolean | 是否存储数据库查询用于调试分析,默认:true |
| SCRIPT_DEBUG | boolean | 是否加载未压缩的JavaScript和CSS,默认:true |
| WP_HTTP_BLOCK_EXTERNAL | boolean | 是否禁用所有外部站点HTTP请求,默认:true |
| WP_ACCESSIBLE_HOSTS | string:csv | 当WP_HTTP_BLOCK_EXTERNAL=true时允许访问的主机名或IP列表,默认:* |
可通过标准方式使用wp-cli导入图片、管理内容等。关于wp-cli的使用,Smashing Magazine上有一篇详细文章可供参考。
如需扩展镜像,应手动将插件、主题等添加到wp-content目录。不要在镜像中添加敏感信息,数据库连接、邮件中继等配置可通过环境变量指定。
生产环境中,访问日志和错误日志默认输出到标准输出,可通过Docker日志工具查看。
建议使用插件将上传的媒体文件同步到商业云存储服务,并通过外部任务备份数据库。该仓库提供的docker-compose.yml文件包含备份解决方案示例。
bashdocker run -h docker.example.com \ -p 80:80 \ -p 443:443 \ --name wordpress \ --link mysql:db \ deardooley/wordpress:vanilla
容器内未包含Unix cron守护进程。为确保WordPress计划任务按时运行,需使用外部cron解决方案,如基于Web的cron服务,或使用deardooley/curl Docker镜像定期请求站点。该仓库的docker-compose.yml文件包含cron解决方案示例。
默认情况下,每次页面请求时会检查WordPress cron,这可能导致生产环境性能问题并拖慢开发周期。可通过设置DISABLE_WP_CRON环境变量为false,强制WordPress cron仅在GET请求访问http://<hostname>/wp-cron.php时运行。
| 变量 | 类型 | 描述 |
|---|---|---|
| DISABLE_WP_CRON | boolean | 是否禁用WordPress cron。若为true,cron仍启用,但需手动触发wp-cron.php脚本才能运行,默认:false |
要可靠实现cron,建议使用第三方服务(如主机crontab或Pingdom),只需向
http://<hostname>/wp-cron.php发送HTTP GET请求即可。
对象缓存的有无会显著影响管理面板速度。该镜像支持通过环境变量配置Redis Object Cache插件(基于Redis的持久对象缓存后端)。插件的所有标准连接参数均可通过环境变量配置。
使用缓存需访问Redis数据库,该仓库的docker-compose.yml文件默认会启动一个Redis实例。常用配置选项如下,使用提供的docker-compose.yml时仅需配置WP_REDIS_HOST。
| 变量 | 类型 | 描述 |
|---|---|---|
| WP_REDIS_HOST | string | Redis数据库主机名,默认:localhost |
| WP_REDIS_PORT | integer | Redis数据库端口,默认:6379 |
| WP_REDIS_DATABASE | integer | 使用的Redis数据库编号,默认:0 |
| WP_REDIS_PASSWORD | string | 用于Redis认证的密码,默认:null |
如需为域名添加自定义SSL密钥,可挂载SSL证书、密钥、CA证书和CA链文件,并通过以下环境变量指定文件路径:
| 变量 | 描述 |
|---|---|
| SSL_CERT | 服务器SSL证书 |
| SSL_KEY | 服务器SSL私钥 |
| SSL_CA_CERT | 服务器CA证书 |
以下示例将包含必要文件的文件夹挂载到容器内的/ssl目录:
bashdocker run -h docker.example.com \ -p 80:80 \ -p 443:443 \ --name wordpress \ --link mysql:db \ -v `pwd`/ssl:/ssl:ro \ -e SSL_CERT=/ssl/docker_example_com_cert.cer \ -e SSL_KEY=/ssl/docker.example.com.key \ -e SSL_CA_CERT=/ssl/docker_example_com.cer \ deardooley/wordpress:vanilla
镜像中未内置邮件服务器。要使WordPress发送邮件,需安装邮件插件(如SendGrid)或通过环境变量配置SMTP中继服务器,具体如下:
| 变量 | 描述 |
|---|---|
| SMTP_HUB | SMTP中继服务器的主机名和端口,例如:"smtp.sendgrid.net:587" |
| SMTP_USER | 用于SMTP中继认证的账户用户名 |
| SMTP_PASSWORD | 用于SMTP中继认证的账户密码 |
| SMTP_FROM_ADDRESS | 发件人***地址,例如:noreply@example.com |
| SMTP_TLS | 是否使用TLS,1启用,0禁用,默认:1 |
示例命令:
bashdocker run -h docker.example.com \ -p 80:80 \ -p 443:443 \ --name wordpress \ --link mysql:db \ -v `pwd`/ssl:/ssl:ro \ -e SMTP_HUB="smtp.example.com:25" \ -e SMTP_USER=username \ -e SMTP_PASSWORD=password \ -e SMTP_FROM_ADDRESS="***" \ -e SMTP_TLS=1 \ -e SSL_CERT=/ssl/docker_example_com_cert.cer \ -e SSL_KEY=/ssl/docker.example.com.key \ -e SSL_CA_CERT=/ssl/docker_example_com.cer \ deardooley/wordpress:vanilla
以下是 deardooley/wordpress 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。


来自真实用户的反馈,见证轩辕镜像的优质服务