当前位置：首页 > news >正文

第16篇实战：用 Docker Compose 编排 WordPress 与 MySQL

news 2026/5/30 2:08:59

IT策士 10余年一线大厂经验，专注 IT 思维、架构、职场进阶。我会在各个平台持续发布最新文章，助你少走弯路。

到目前为止，我们的贯穿案例一直是 Flask + Redis 计数器。它足够经典，但有些读者可能会觉得“太轻量”了——毕竟只有两个服务，依赖关系也很简单。在实际工作中，你编排的应用栈往往更复杂：有前端有数据库，数据库还需要初始化 root 密码，Web 服务器必须等待数据库完全就绪才能连接。

今天我们就来编排一个更真实的应用栈——WordPress + MySQL。这个案例涉及到了完整的环境变量管理、启动顺序控制、数据持久化，以及一个你在生产环境中必然会遇到的问题：数据库密码等敏感信息该如何处理。通过这个实战，你将看到前几篇学到的概念是如何在一个更复杂的场景中串联起来的。

一、为什么选 WordPress + MySQL？

WordPress 是全球使用最广泛的内容管理系统，它由两个核心组件构成：

WordPress：PHP 编写的 Web 应用，处理前端请求
MySQL：关系型数据库，存储文章、用户、配置等数据

这个组合是 Compose 教学中的经典案例，因为它天然涵盖了我们在第 11-15 篇学到的所有关键概念：WordPress 依赖 MySQL（启动顺序控制），MySQL 数据必须持久化（Volume），数据库密码等配置通过环境变量注入（敏感信息管理），以及服务间通过 DNS 解析互相发现（自定义网络）。可以说，掌握了 WordPress + MySQL 的编排，你就掌握了一般 Web 应用的编排范式。

二、Compose 文件完整配置

2.1 目录结构

wordpress/ ├── docker-compose.yml ├── .env# 环境变量（不提交到 Git）└── .gitignore

2.2 docker-compose.yml

services: db: image: mysql:8.0 restart: unless-stopped environment: -MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}-MYSQL_DATABASE=${MYSQL_DATABASE:-wordpress}-MYSQL_USER=${MYSQL_USER:-wordpress}-MYSQL_PASSWORD=${MYSQL_PASSWORD}volumes: - db-data:/var/lib/mysql networks: - wp-net healthcheck: test:["CMD","mysqladmin","ping","-h","localhost","-u","root","-p${MYSQL_ROOT_PASSWORD}"]interval: 10s timeout: 5s retries:5start_period: 30s wordpress: image: wordpress:6.7-php8.3-apache restart: unless-stopped ports: -"${WORDPRESS_PORT:-8080}:80"environment: -WORDPRESS_DB_HOST=db -WORDPRESS_DB_USER=${MYSQL_USER:-wordpress}-WORDPRESS_DB_PASSWORD=${MYSQL_PASSWORD}-WORDPRESS_DB_NAME=${MYSQL_DATABASE:-wordpress}volumes: - wp-data:/var/www/html networks: - wp-net depends_on: db: condition: service_healthy healthcheck: test:["CMD","curl","-f","http://localhost:80/wp-admin/install.php"]interval: 30s timeout: 10s retries:3start_period: 15s volumes: db-data: wp-data: networks: wp-net: driver: bridge

2.3 .env 文件

MYSQL_ROOT_PASSWORD=ChangeMeRoot123!MYSQL_DATABASE=wordpressMYSQL_USER=wpuserMYSQL_PASSWORD=ChangeMeUser456!WORDPRESS_PORT=8080

安全警告：以上密码仅为示例。在生产环境中，请使用强随机密码，不要将.env提交到版本控制系统，可考虑使用 Docker Secrets（Swarm 模式）或 Kubernetes Secrets 来管理。这里.env文件必须加入.gitignore，否则密码会被提交到 Git 历史。

三、关键配置解析

3.1 数据库服务（db）

MySQL 容器使用了几个关键环境变量：

MYSQL_ROOT_PASSWORD：MySQL root 用户密码，必须设置。MySQL 8.0 镜像在没有此变量时会报错退出。
MYSQL_DATABASE：容器启动时自动创建的数据库名。如果未指定，WordPress 将无法找到它的数据库。
MYSQL_USER/MYSQL_PASSWORD：创建一个普通用户并授予该数据库的全部权限（而不是直接用 root 连接，这是安全最佳实践）。

Volume 挂载db-data:/var/lib/mysql确保所有数据库文件持久化到命名卷中。即使容器被删除重建，数据也不会丢失。

健康检查使用mysqladmin ping，这是 MySQL 自带的轻量级探测工具，比mysql -e "SELECT 1"更高效。由于 MySQL 首次启动需要初始化数据目录（包括创建数据库和用户），start_period: 30s给了足够的时间窗口，避免在初始化期间被误判为 unhealthy。

3.2 WordPress 服务

WordPress 容器通过以下环境变量连接数据库：

WORDPRESS_DB_HOST：数据库主机名。这里写db，即 MySQL 服务的名称，Docker 内嵌 DNS 自动解析为 MySQL 容器的 IP。
WORDPRESS_DB_USER/WORDPRESS_DB_PASSWORD：连接数据库的凭证，与 MySQL 容器中创建的MYSQL_USER和MYSQL_PASSWORD对应。
WORDPRESS_DB_NAME：要使用的数据库名，与MYSQL_DATABASE对应。

WordPress 在启动时会自动检测WORDPRESS_DB_HOST指定的数据库是否可用。如果数据库不存在或凭证错误，WordPress 会进入安装引导页面而不是正常运行。因此depends_on+service_healthy确保了它启动时 MySQL 已经接受连接。

3.3 启动顺序：depends_on + service_healthy

第 15 篇讲过的知识点在此完美落地：

depends_on: db: condition: service_healthy

Compose 会先启动db容器，然后每 10 秒执行一次mysqladmin ping，直到返回成功。只有 MySQL 健康检查通过后，wordpress容器才会被创建和启动。这避免了 WordPress 启动时 MySQL 还没准备好的竞态条件。

3.4 敏感信息管理

你可能会问：MySQL 密码直接写在.env文件里安全吗？

在单机 Compose 场景中，这是常用的折中方案——比硬编码在 YAML 中好，但仍然需要把.env加入.gitignore。生产环境中的更安全做法包括：使用 Docker Swarm 的 Secrets 功能，通过/run/secrets/挂载；在 Kubernetes 中使用 Secret 对象，并通过 Sealed Secrets 或 External Secrets Operator 加密后存入 Git。

.gitignore文件内容：

四、启动与验证

4.1 一键启动

# 在 wordpress 目录下执行dockercompose up-d

输出：

[+]Running4/4 ✔ Network wordpress_wp-net Created0.1s ✔ Volume"wordpress_db-data"Created0.0s ✔ Volume"wordpress_wp-data"Created0.0s ✔ Container db Started0.5s

注意，此时wordpress容器还没有启动。因为db容器虽然在运行，但健康检查还没有通过。等待约 30-40 秒，MySQL 完成首次初始化（创建数据库、用户、设置 root 密码），mysqladmin ping返回成功，Compose 才会启动 WordPress 容器。

dockercompose logs-fdb

观察 MySQL 初始化日志，当看到ready for connections时，表示 MySQL 已经就绪。

4.2 验证服务状态

输出：

NAME IMAGE STATUS wordpress-db-1 mysql:8.0 Up2minutes(healthy)wordpress-wordpress-1 wordpress:6.7-php8.3-apache Up1minute(healthy)

两个服务都标记为(healthy)。

4.3 访问 WordPress

打开浏览器，访问http://localhost:8080。你会看到 WordPress 的安装向导页面，选择语言，设置站点标题、管理员用户名和密码，然后登录即可。

4.4 验证数据持久化

我们来模拟一次灾难恢复演练：

# 1. 先确认可以正常访问 WordPress 并完成初始化安装# 在浏览器中完成安装向导，设置管理员账号密码，登录后写一篇测试文章# 2. 模拟灾难：删除所有容器dockercompose down# 3. 检查数据卷仍然存在dockervolumels|grepwordpress# wordpress_db-data# wordpress_wp-data# 4. 重新启动（必须使用同一个 docker-compose.yml 和 .env）dockercompose up-d# 5. 检查日志dockercompose logs wordpress|grep"complete"# 不会出现安装向导，直接可以访问

访问http://localhost:8080，你之前写的测试文章仍然存在。数据卷确保了数据在容器销毁后不会丢失。

五、常见踩坑与解决

坑 1：MySQL 启动后 WordPress 连接报错

现象：WordPress 显示“建立数据库连接时出错”。

排查：

# 查看 WordPress 日志dockercompose logs wordpress# 检查环境变量是否正确注入dockercomposeexecwordpressenv|grepWORDPRESS_DB# 确认 MySQL 确实在运行且健康dockercomposeexecdb mysqladminping-hlocalhost-uroot -p${MYSQL_ROOT_PASSWORD}