Linux服务器用Docker Compose部署多容器应用,如何配置服务依赖与数据卷?

发布人:A5数据发布时间:2026-10-18 16:07阅读量:104

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_

这里有几项配置需要区分:

配置服务依赖与数据卷 / 编写 Compose 配置配图

  • 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

相关推荐