Linux服务器用Docker Compose部署多容器应用,如何配置服务依赖与数据卷?
Docker Compose 中的服务依赖和数据卷解决的是两个不同问题:依赖关系控制容器按什么条件启动,数据卷负责让需要保留的数据不随容器重建而丢失。下面以 Linux 服务器上的 WordPress 与 MariaDB 为例,配置数据库健康检查、服务依赖和持久化存储,并验证首次启动结果。
示例适用于使用 systemd 的 Ubuntu 或 Debian 服务器,Docker Engine 使用 Compose V2 插件。服务器需要能够访问镜像仓库,并预留可用磁盘空间。示例将 Web 服务的 8080 端口映射到主机,访问前还需确认云平台安全组及主机防火墙允许该端口。
准备环境
检查系统与 Docker
先确认发行版信息以及是否已安装 Docker:
cat /etc/os-release
docker --version
docker compose version
如果后两条命令能显示版本,且 docker compose version 正常返回,可跳过安装。若 Docker 已安装但没有 Compose V2 插件,应按当前发行版对应的 Docker 软件源安装 docker-compose-plugin,不要把旧版独立命令 docker-compose 与 V2 插件混用。
Ubuntu 或 Debian 可按 Docker 软件源的安装方式添加仓库,再安装 Engine 和 Compose 插件。以下命令适用于使用 apt 的系统;执行前确认服务器架构和系统代号正确:
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL "https://download.docker.com/linux/$(. /etc/os-release && echo "$ID")/gpg" \
-o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/$(. /etc/os-release && echo "$ID") $(. /etc/os-release && echo "$VERSION_CODENAME") stable" \
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
确认服务运行并检查 Compose 插件:
sudo systemctl enable --now docker
sudo systemctl status docker --no-pager
docker compose version
预期能看到 Docker 服务处于 active (running),Compose 命令显示 V2 版本号。若使用非 Ubuntu、Debian 系统,应先核对 Docker 软件源与安装包名称,不要直接照搬上述仓库配置。
当前用户如果尚不能直接运行 docker,可以先使用 sudo docker compose ...。将用户加入 docker 组会赋予较高的主机管理权限,不应把它当作普通的低权限授权操作;确有需要时,按组织的权限管理要求执行。
创建部署目录与密码文件
建立独立目录存放 Compose 配置:
sudo mkdir -p /opt/wp-stack
sudo chown "$USER":"$(id -gn)" /opt/wp-stack
cd /opt/wp-stack
创建 .env 文件,填入仅用于本次部署的强密码:
umask 077
cat > .env <<'EOF'
MARIADB_ROOT_PASSWORD=请替换为随机生成的高强度密码
MARIADB_DATABASE=wordpress
MARIADB_USER=wpuser
MARIADB_PASSWORD=请替换为另一组随机生成的高强度密码
EOF
chmod 600 .env
这里的占位文本必须替换,不能直接用于部署。.env 含有明文凭据,应限制文件权限,并确保不会提交到代码仓库、公开目录或备份日志中。更严格的环境可使用受控的密钥管理方案。
验证文件存在且权限受限:
ls -l .env
预期权限类似 -rw-------。不要通过把完整 .env 内容贴到工单或终端截图中来排查问题。
配置服务依赖与数据卷
编写 Compose 配置
在 /opt/wp-stack/compose.yaml 中写入以下配置:
services:
db:
image: mariadb:11.4
restart: unless-stopped
environment:
MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD:?请在.env中设置MARIADB_ROOT_PASSWORD}
MARIADB_DATABASE: ${MARIADB_DATABASE:-wordpress}
MARIADB_USER: ${MARIADB_USER:-wpuser}
MARIADB_PASSWORD: ${MARIADB_PASSWORD:?请在.env中设置MARIADB_PASSWORD}
volumes:
- db_/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 10
start_period: 30s
wordpress:
image: wordpress:6.8-apache
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_NAME: ${MARIADB_DATABASE:-wordpress}
WORDPRESS_DB_USER: ${MARIADB_USER:-wpuser}
WORDPRESS_DB_PASSWORD: ${MARIADB_PASSWORD:?请在.env中设置MARIADB_PASSWORD}
ports:
- "8080:80"
volumes:
- wp_/var/www/html
volumes:
db_
wp_
这里有几项配置需要区分:

depends_on配合condition: service_healthy,表示 Compose 等待数据库健康检查通过后再启动 WordPress。单独写depends_on: - db通常只表达启动顺序,并不表示数据库已经可以接受连接。- 数据库健康检查调用 MariaDB 镜像内的
healthcheck.sh,检查数据库连接及 InnoDB 初始化情况。健康检查连续失败时,依赖服务不会按上述条件启动。 - Compose 会把服务名
db注册到项目网络中,WordPress 使用db:3306连接数据库,不需要填写容器 IP。容器 IP 可能变化,不宜写死在应用配置中。 db_data和wp_data是 Docker 管理的命名卷。数据库文件保存在db_data,WordPress 文件保存在wp_data;删除或重建容器通常不会删除这两个卷。restart: unless-stopped用于 Docker 服务重启后恢复容器,不会替代健康检查,也不意味着应用已经完成初始化。
depends_on 不能保证应用在运行期间永远不会遇到数据库断连。应用仍应具备连接重试能力;数据库或主机重启后,也应通过日志和状态检查确认恢复情况。
检查配置文件和变量替换结果:
cd /opt/wp-stack
docker compose config
预期输出中包含两个服务、对应的卷以及 db 到 wordpress 的健康条件依赖。该命令可能展示配置中的密码值;执行时注意终端录屏、日志收集和共享输出。若配置校验报缺少变量或 YAML 错误,应先修正 .env 或缩进,再启动容器。
选择命名卷还是主机目录
本例使用命名卷,适合由 Docker 管理存储位置的场景。卷名由项目名和定义名组合;默认情况下,/opt/wp-stack 目录对应的项目可能生成类似 wp-stack_db_data 的卷名。实际名称可用 docker volume ls 查看。
如果需要将文件放在指定主机路径,也可以将卷定义改为绑定挂载,例如:
volumes:
- /srv/wp-stack/mariadb:/var/lib/mysql
绑定挂载便于直接对接主机备份工具,但要提前创建目录,并确保容器进程有权限读写;权限不匹配可能导致数据库启动失败。不要同时把同一数据目录既挂载为命名卷又挂载为主机目录。首次部署建议先采用一种明确的存储方式,避免迁移时误判数据所在位置。
Docker Compose 多容器应用的运行基础,不仅包括服务依赖与数据卷,也包括承载容器的计算、存储和网络资源。A5数据提供香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器,产品覆盖常规建站、数据库和多任务运行所需的不同 CPU、内存、SSD 或 NVMe 配置,也有大容量存储方案,可为网站、业务后台及容器化应用提供部署资源。
启动并逐项验证
拉取镜像并启动
在 Compose 文件所在目录执行:
cd /opt/wp-stack
docker compose pull
docker compose up -d
pull 用于提前拉取镜像,便于把网络或镜像标签问题与应用启动问题区分开。启动后查看容器和健康状态:
docker compose ps
数据库初始化期间,状态可能先显示 health: starting;等待健康检查后,数据库应显示 healthy,WordPress 容器应处于运行状态。第一次启动需要初始化数据库,所需时间会受磁盘性能和镜像拉取速度影响。
查看服务日志:
docker compose logs --tail=100 db wordpress
日志中不应持续出现数据库连接失败、初始化失败或容器反复退出的情况。日志内容可能包含环境信息,公开前应检查是否暴露凭据。
验证访问与持久化
在服务器本机检查 Web 服务是否响应:
curl -I http://127.0.0.1:8080/
若返回 HTTP 响应头,说明主机端口已转发到容器内的 Web 服务;首次访问可能进入 WordPress 安装页面。若本机可访问但外部不可访问,优先检查云平台安全组和服务器防火墙,而不是修改容器内端口。
查看实际创建的卷:
docker volume ls
docker inspect "$(docker compose ps -q db)" \
--format '{{range .Mounts}}{{println .Name .Destination}}{{end}}'
预期能看到数据库容器将一个 Docker 卷挂载到 /var/lib/mysql。WordPress 容器也应有卷挂载到 /var/www/html。如果输出为空或挂载目标不符,检查 Compose 文件的 volumes 定义及服务名称。
可以用重建容器的方式验证卷仍在,但这会中断访问,不要在有用户流量时随意执行。测试前先确认这是可中断的首次部署,并检查当前卷名:
docker compose stop
docker compose up -d
docker compose ps
该操作停止并重新启动容器,不删除卷。验证完成后再次访问页面,并确认数据库仍为 healthy。生产环境还应另行制定数据库备份与恢复流程;持久化卷不等于备份。
常见异常处理
数据库一直未通过健康检查
先查看数据库日志和状态:
docker compose ps
docker compose logs --tail=150 db
若日志显示初始化正在进行,可等待后重新检查。若出现密码、文件权限、磁盘空间或数据库文件错误,按日志定位具体原因;绑定挂载场景需额外核对主机目录权限:
df -h /opt/wp-stack
不要因为容器不健康就立即删除数据库卷。卷中可能已有数据,删除会造成数据丢失。
WordPress 提示无法连接数据库
确认数据库已经 healthy,并检查两侧使用的库名、用户名和密码变量是否一致:
docker compose config
docker compose logs --tail=100 wordpress db
WORDPRESS_DB_HOST 应使用 db:3306,其中 db 必须与 Compose 服务名一致。若修改 .env 后仍无法连接,需考虑数据库卷中已经存在初始化数据:MariaDB 镜像的初始化环境变量通常只在数据目录为空时用于首次建库、建用户,不会因修改 .env 自动重置已有账户或密码。生产数据应通过数据库管理方式调整凭据,而不是清空卷重来。
端口无法访问或端口已占用
若 docker compose up 报告主机端口已被占用,可先检查监听进程:
sudo ss -ltnp | grep ':8080'
确认占用服务后,再决定停止该服务,或将 Compose 端口映射改为其他未占用端口,例如 "8081:80",随后重新应用配置:
docker compose up -d
外部无法访问而本机 curl 正常时,检查安全组与主机防火墙规则。修改防火墙可能影响现有远程管理连接,操作前应确认管理端口仍被允许,并准备控制台访问或回退规则。
回滚与验收
保留数据的回滚方式
若新配置启动失败,先保留卷并停止本项目容器:
docker compose down
该命令默认不删除命名卷。修正 Compose 文件后可重新启动:
docker compose up -d
docker compose ps
如果修改了镜像标签或配置,应记录修改前的文件和镜像版本,必要时恢复原配置后再次启动。涉及数据库版本升级时,不要仅靠切回旧镜像标签判断可安全回退;数据库文件可能已被新版本修改,应先有可恢复的备份,并遵循数据库版本迁移要求。
需要删除整个项目数据时,docker compose down -v 会删除 Compose 管理的命名卷,可能永久删除数据库和 WordPress 文件。只有确认数据无需保留,或已完成备份并验证可恢复后,才执行:
docker compose down -v
删除前先记录卷名并核对备份;若误删且没有有效备份,通常无法通过重新创建空卷恢复原数据。
首次部署验收清单
docker compose config能成功解析,变量未缺失,依赖条件指向正确服务。docker compose ps显示数据库健康,WordPress 容器正常运行。- 本机访问
http://127.0.0.1:8080/能收到 HTTP 响应;外部访问所需端口已按实际网络策略放行。 - 数据库与 WordPress 的挂载目标分别为
/var/lib/mysql和/var/www/html,卷名及存储方式已记录。 .env权限受限,凭据未写入公开仓库或可共享日志。- 回滚时使用
docker compose down保留数据;删除卷前已明确数据影响并核对备份。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4450.html



