在香港服务器上用Docker Compose部署应用,怎样验证容器与服务正常?

发布人:A5数据发布时间:2026-10-19 09:38阅读量:80

香港服务器上使用 Docker Compose 部署应用后,不能只看 docker compose up -d 是否返回成功,也不能仅凭容器显示 Up 就判断应用正常。较完整的验证应覆盖 Docker 引擎、Compose 配置、容器进程、健康检查、容器内部通信、服务器本机访问和公网访问。

香港服务器还需要额外核对云平台安全组、系统防火墙、监听地址和公网 IP。服务器本机执行 curl 成功,只能说明端口映射和本机服务基本正常;从服务器外部网络访问成功,才说明外部链路也已打通。下面以 Ubuntu 22.04/24.04、Docker Engine 和 Compose Plugin 为例,使用一个包含 Nginx 与 Redis 的示例项目演示首次部署和验收方法。

Docker Compose 应用能否顺畅运行,离不开适配业务负载的服务器资源。A5数据提供中国香港物理服务器,涵盖 Xeon Gold、AMD EPYC 等平台,以及 SSD、NVMe 存储和不同线路方案,可为企业网站、业务后台、数据库与接口服务提供部署所需的计算、存储和网络资源,适合承载由多个容器组成的应用服务。

准备服务器与 Docker 环境

确认系统、架构和登录权限

先确认操作系统版本以及服务器架构:

cat /etc/os-release
uname -m

本文的安装命令适用于 Ubuntu 22.04 或 Ubuntu 24.04。常见架构包括:

  • x86_64:通常对应 Docker 的 amd64 镜像。
  • aarch64:通常对应 Docker 的 arm64 镜像。

如果服务器运行的是 Debian、Rocky Linux 或其他发行版,不要直接套用 Ubuntu 软件源命令,应根据对应发行版配置 Docker 软件源。

部署前还需要准备以下信息:

  • 服务器公网 IPv4 或 IPv6 地址。
  • SSH 登录账号及端口。
  • 云平台安全组的管理权限。
  • 应用项目目录和 Compose 配置文件。
  • 应用需要使用的域名、端口、环境变量和数据目录。
  • 数据库或持久化服务的备份方案。

首次验证可以使用高位端口,例如 8080,避免立即改动现有的 80 或 443 端口。如果服务器上已经运行其他服务,应先检查端口占用:

sudo ss -lntp

安装 Docker Engine 和 Compose Plugin

如果服务器还没有 Docker,可以在确认系统为 Ubuntu 后执行:

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/ubuntu/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/ubuntu $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$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

sudo systemctl enable --now docker

验证 Docker 服务和 Compose 命令:

sudo systemctl is-active docker
docker version
docker compose version

sudo systemctl is-active docker 正常应返回:

active

如果当前账号执行 docker version 报权限错误,可以暂时在 Docker 命令前加 sudo。也可以将当前账号加入 docker 用户组:

sudo usermod -aG docker "$USER"

执行后需要退出 SSH 再重新登录,或者使用新的登录会话。需要注意,docker 用户组通常拥有接近 root 的主机控制能力,不要把不可信账号加入该组。

最后运行测试容器:

docker run --rm hello-world

看到包含 Hello from Docker! 的提示,说明 Docker 引擎能够正常创建、启动和删除容器。这个测试不会验证你的 Compose 项目,但能先排除 Docker 服务未启动、权限不足或基础镜像无法拉取等问题。

准备 Compose 项目并做静态检查

创建示例项目

以下示例只用于演示验证流程。web 模拟应用前端,cache 模拟内部缓存服务。实际部署时,可以将镜像、环境变量、挂载目录和健康检查替换为你的应用内容。

mkdir -p ~/compose-demo/site
cd ~/compose-demo

创建一个用于验证 HTTP 服务的页面:

cat > site/index.html <<'EOF'
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>Compose Demo</title>
</head>
<body>
  <h1>Docker Compose service is running.</h1>
  <p>This page is used for deployment verification.</p>
</body>
</html>
EOF

创建 compose.yaml:

services:
  web:
    image: nginx:1.27-alpine
    ports:
      - "8080:80"
    volumes:
      - ./site:/usr/share/nginx/html:ro
    healthcheck:
      test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1/ || exit 1"]
      interval: 10s
      timeout: 3s
      retries: 3
      start_period: 5s
    restart: unless-stopped

  cache:
    image: redis:7.4-alpine
    command: ["redis-server", "--appendonly", "yes"]
    volumes:
      - redis-/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 3s
      retries: 3
      start_period: 5s
    restart: unless-stopped

volumes:
  redis-

这个文件有几个与验证直接相关的配置:

  • ports 将宿主机的 8080 映射到 web 容器的 80 端口。
  • healthcheck 用命令判断服务是否能够响应,而不是只判断容器进程是否存在。
  • restart: unless-stopped 表示容器异常退出后允许 Docker 自动拉起。
  • Redis 没有配置 ports,因此不会直接暴露到公网,应用应通过 Compose 内部网络使用服务名访问它。
  • redis-data 是命名卷,容器重建时不会因为普通的 docker compose down 自动删除。

如果实际应用使用数据库、消息队列或其他依赖服务,应为每个关键服务定义适合自身的健康检查。例如 HTTP 应用应检查一个轻量接口,Redis 可以执行 redis-cli ping,数据库则使用对应客户端进行只读连接测试。健康检查命令必须存在于镜像中,不能直接复制不兼容的命令。

检查 Compose 配置

在启动前先执行配置解析:

docker compose config -q

该命令没有输出通常表示 YAML 语法和 Compose 结构通过检查。如果出现错误,应先修正缩进、变量引用、端口格式或挂载路径,不要直接启动。

查看 Compose 实际识别到的服务和卷:

docker compose config --services
docker compose config --volumes

预期输出类似:

web
cache

以及:

redis-data

还可以生成展开后的配置用于人工检查:

docker compose config > /tmp/compose.rendered.yaml

展开配置可能包含环境变量中的敏感信息,不要直接上传到公开位置。重点检查以下内容:

  • 镜像名称和标签是否为项目允许使用的版本。
  • 主机端口是否与现有服务冲突。
  • 环境变量是否已填写,尤其是数据库地址、账号和密码。
  • 卷挂载路径是否存在,是否具有正确的读写权限。
  • 是否意外把数据库或缓存端口暴露到了公网。
  • 生产配置是否误用了开发模式或调试模式。

启动服务并逐层验证

拉取镜像并启动容器

先拉取 Compose 文件中声明的镜像:

docker compose pull

拉取成功后启动服务:

docker compose up -d

如果项目包含 build: 配置,而不是直接使用镜像,则可以使用:

docker compose build
docker compose up -d

启动后先查看所有容器,包括已经退出的容器:

docker compose ps --all

正常情况下,示例项目会看到类似状态:

NAME                 SERVICE   STATUS                  PORTS
compose-demo-web-1   web       Up (healthy)            0.0.0.0:8080->80/tcp
compose-demo-cache-1 cache     Up (healthy)

项目目录、Compose 版本或项目名称不同,容器名称可能不一样,不要把示例名称当成固定值。

验证容器状态和健康检查

Up 只说明容器主进程仍在运行,Up (healthy) 才表示健康检查命令连续通过。可以单独查看容器健康状态:

docker inspect "$(docker compose ps -q web)" \
  --format '{{json .State.Health}}'

Redis 使用同样方式检查:

docker inspect "$(docker compose ps -q cache)" \
  --format '{{json .State.Health}}'

健康检查正常时,输出中的 Status 应为:

"healthy"

查看服务日志:

docker compose logs --tail=100 web cache

首次启动时出现 Nginx 启动提示、Redis 加载数据等信息通常正常。需要重点关注以下持续性错误:

  • permission denied:挂载目录或配置文件权限不匹配。
  • address already in use:宿主机端口已经被其他程序占用。
  • connection refused:应用依赖服务尚未启动,或连接地址、端口错误。
  • no such file or directory:配置文件、证书或挂载路径不存在。
  • 容器不断重启:主进程启动后立即退出,通常需要结合退出码和完整日志判断。

查看退出容器和退出码:

docker compose ps --all
docker inspect "$(docker compose ps -q web)" \
  --format 'status={{.State.Status}} exit_code={{.State.ExitCode}} restart_count={{.RestartCount}}'

验证容器内部服务

先验证 Nginx 容器内部是否能返回页面:

docker compose exec -T web wget -qO- http://127.0.0.1/

预期可以看到之前创建的 HTML 内容。如果容器内部访问失败,问题在应用进程、容器内配置或健康检查命令,不需要先排查香港服务器的公网线路。

验证 Redis:

docker compose exec -T cache redis-cli ping

预期输出:

PONG

这说明 Redis 进程已启动,并能够接受本地客户端连接。

对于实际业务应用,还应验证应用到依赖服务的真实连接。例如应用连接数据库时,单独执行数据库容器的客户端测试,并不能证明应用账号、连接池和数据库名称都正确。更可靠的方式是访问应用提供的健康接口或只读业务接口,让应用自身完成一次依赖调用。

如果 Compose 中的服务相互通信,应使用服务名而不是 127.0.0.1。例如应用容器连接 Redis 时,地址通常应为:

cache:6379

容器中的 127.0.0.1 指向当前应用容器本身,不是 Redis 容器。

验证宿主机端口和本机访问

确认宿主机已经监听 8080:

sudo ss -lntp | grep ':8080'

然后在香港服务器本机访问映射端口:

curl -fsS --max-time 10 http://127.0.0.1:8080/

如果返回 HTML 页面,说明以下链路基本正常:

宿主机端口 8080
→ Docker 端口映射
→ web 容器 80 端口
→ Nginx 进程
→ 挂载的站点文件

也可以检查 HTTP 状态码和响应头:

curl -i --max-time 10 http://127.0.0.1:8080/

普通静态页面通常应返回 HTTP/1.1 200 OK。如果应用设计为登录跳转或接口返回 JSON,则应按应用预期判断,不能机械要求所有接口都返回 200。

从外部网络验证公网访问

使用个人电脑、办公网络或其他服务器执行以下命令,不要只在香港服务器本机执行:

curl -i --max-time 10 http://服务器公网IP:8080/

如果已配置域名,则同时验证域名:

curl -i --max-time 10 http://app.example.com:8080/

外部访问的验证结果可以这样判断:

启动服务并逐层验证|从外部网络验证公网访问配图

现象通常说明
本机访问成功,外部连接超时云安全组、UFW、防火墙或运营商入口规则未放行
本机访问失败,外部也失败容器、端口映射或应用进程存在问题
外部返回连接被拒绝端口未监听、映射错误,或防火墙主动拒绝
IP 访问成功,域名失败DNS 记录、AAAA 记录或域名解析缓存需要检查
返回 502 或 504反向代理已接通,但后端应用未正常响应
返回 403 或 404服务已到达,重点检查站点目录、路由和权限

如果域名同时配置了 IPv4 和 IPv6,建议分别验证 A 和 AAAA 记录对应的访问链路。某一协议栈配置不完整时,部分网络可能表现为访问缓慢或超时。

检查云安全组和 UFW

云厂商安全组需要允许实际使用的 TCP 端口。首次测试可以仅对自己的公网 IP 放行 8080,不要直接对所有来源开放数据库或缓存端口。

如果服务器使用 UFW,先查看当前规则:

sudo ufw status verbose

确认 SSH 已经放行后,再添加应用端口。SSH 不是 22 端口时,应替换为实际端口:

sudo ufw allow 22/tcp
sudo ufw allow 8080/tcp
sudo ufw status numbered

如果 UFW 当前处于未启用状态,不要在不了解现有远程访问规则时直接执行 sudo ufw enable。启用防火墙前必须先放行当前 SSH 端口,否则可能中断远程管理。

验证完成后,如果不再需要直接暴露 8080,可以删除规则:

sudo ufw delete allow 8080/tcp

生产环境通常使用 80/443 接入反向代理,并将应用端口限制在本机或内部网络。Redis、数据库等服务不应为了方便验证而增加公网端口映射。

验证重启、挂载和持久化边界

检查重启策略

查看容器配置的重启策略:

docker inspect "$(docker compose ps -q web)" \
  --format '{{.HostConfig.RestartPolicy.Name}}'

预期为:

unless-stopped

验证重启前,需要确认当前服务已经通过本机和外部访问测试。然后执行受控重启:

docker compose restart web cache

该操作会造成短暂服务中断,生产环境应安排在可接受的维护窗口。重启后再次执行:

docker compose ps
curl -fsS --max-time 10 http://127.0.0.1:8080/
docker compose exec -T cache redis-cli ping

如果服务重启后自动恢复且健康检查重新变为 healthy,说明基础重启流程正常。它不能替代真实的主机故障演练,也不能证明数据恢复能力。

检查卷挂载

查看 Redis 的挂载信息:

docker inspect "$(docker compose ps -q cache)" \
  --format '{{range .Mounts}}{{println .Type .Name .Destination}}{{end}}'

预期可以看到类似:

volume compose-demo_redis-data /data

这表示 Redis 数据目录使用了命名卷。需要注意,挂载存在不等于备份有效。生产数据库和缓存中的重要数据仍应通过应用对应的备份工具、云硬盘快照或导出流程进行保护。

如需进行写入后重启验证,只应在测试或预发布环境使用以下方式:

docker compose exec -T cache redis-cli SET compose_validation_key ok
docker compose restart cache
docker compose exec -T cache redis-cli GET compose_validation_key

预期返回:

ok

该测试会向 Redis 写入数据,不应直接在生产缓存中执行。生产环境应使用专用测试键、事务或应用提供的安全检查接口,并事先确认写入影响、备份状态和清理方式。

常见异常的处理顺序

容器处于 unhealthy

先查看健康检查日志和应用日志:

docker compose ps
docker compose logs --tail=200 web
docker compose logs --tail=200 cache

如果容器进程正常但健康检查失败,可能是以下原因:

  • 健康检查使用的 wget、curl 或客户端命令不在镜像中。
  • 检查地址写错,容器内服务没有监听 127.0.0.1。
  • 应用启动时间超过 start_period。
  • 应用返回了非预期状态码。
  • 健康检查依赖环境变量或配置文件,但容器内没有对应配置。

可以进入容器确认命令是否存在:

docker compose exec -T web sh -c 'command -v wget || command -v curl'

不要为了让状态变成 healthy 而简单删除健康检查。应让检查命令反映真正的服务可用条件。

容器不断退出或重启

执行:

docker compose ps --all
docker compose logs --tail=200 服务名

如果退出码为非零,优先检查环境变量、配置文件、文件权限和启动参数。配置修改后先重新执行:

docker compose config -q

然后再启动,不建议连续执行多次重启掩盖错误。

本机成功,外部超时

按照由近到远的顺序检查:

  1. docker compose ps 是否为 Up (healthy)。
  2. sudo ss -lntp | grep ':8080' 是否存在监听。
  3. 云安全组是否放行实际端口。
  4. UFW 或其他主机防火墙是否拦截。
  5. 访问的是否为正确公网 IP。
  6. 域名 A/AAAA 记录是否指向当前服务器。
  7. 服务器是否只绑定在回环地址,而不是公网网卡。

如果 Compose 中写成了以下形式:

ports:
  - "127.0.0.1:8080:80"

则该端口只能从服务器本机访问,外部访问失败是预期结果。需要公网访问时,应根据安全要求绑定公网地址或由反向代理接入,而不是盲目开放所有端口。

端口已被占用

检查占用进程:

sudo ss -lntp | grep ':8080'

确认占用者后,再决定停止旧服务、调整 Compose 的宿主机端口,或改用现有反向代理。端口调整后要同步更新安全组、防火墙和外部验证命令。不要在不了解进程用途的情况下直接执行 kill -9。

部署失败时的回滚方法

首次修改 Compose 文件或镜像版本前,先备份配置和站点文件:

cd ~/compose-demo

BACKUP_ID=$(date +%F-%H%M%S)
cp compose.yaml "compose.yaml.bak.${BACKUP_ID}"
cp -a site "site.bak.${BACKUP_ID}"

如果新配置启动失败,先保留日志:

docker compose logs --no-color > "compose-failed-${BACKUP_ID}.log"

确认需要回滚后,恢复旧配置:

cp "compose.yaml.bak.${BACKUP_ID}" compose.yaml
rm -rf site
cp -a "site.bak.${BACKUP_ID}" site

docker compose config -q
docker compose down
docker compose up -d

docker compose down 会停止并删除当前项目的容器和网络,但默认不会删除命名卷。不要在普通回滚中使用:

docker compose down -v

-v 会删除 Compose 管理的命名卷,可能造成 Redis、数据库或其他持久化服务的数据丢失。只有已经确认数据不再需要、完成备份并明确接受删除影响时,才考虑使用该参数。

如果回滚涉及数据库结构变更,不能只恢复旧的 Compose 文件。数据库迁移可能已经改变表结构,必须根据应用的迁移工具、备份和兼容策略处理。对于生产环境,镜像版本也应使用明确的版本标签或已记录的镜像摘要,避免使用可变标签后无法准确恢复原版本。

验收与回滚检查项

部署完成后,可以按下面的顺序记录验收结果:

  • [ ] Docker 服务状态为 active。
  • [ ] docker compose config -q 无报错。
  • [ ] 所有必要服务均为 Up,关键服务为 Up (healthy)。
  • [ ] docker compose logs 没有持续性的启动错误或重启循环。
  • [ ] 应用容器内部接口返回预期内容。
  • [ ] 数据库、缓存或消息服务的内部连接测试通过。
  • [ ] 宿主机监听了预期端口,且没有误占用。
  • [ ] 香港服务器本机访问返回预期状态码和内容。
  • [ ] 从外部网络通过公网 IP 或域名访问成功。
  • [ ] 云安全组和 UFW 仅放行必要端口。
  • [ ] 数据卷、配置文件和应用目录的挂载路径正确。
  • [ ] 重启服务后能够恢复,健康检查重新通过。
  • [ ] 已保存 Compose 文件、镜像版本、日志和回滚备份。
  • [ ] 回滚时不会误执行 docker compose down -v。
  • [ ] 如果涉及数据库迁移,已单独确认备份和结构回退方案。

当容器状态、内部服务检查、本机访问和外部访问四层结果都符合预期时,才可以认为这次 Docker Compose 首次部署已完成基本验收。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4505.html

相关推荐