在香港服务器上用Docker Compose部署应用,怎样验证容器与服务正常?
香港服务器上使用 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
然后再启动,不建议连续执行多次重启掩盖错误。
本机成功,外部超时
按照由近到远的顺序检查:
docker compose ps是否为Up (healthy)。sudo ss -lntp | grep ':8080'是否存在监听。- 云安全组是否放行实际端口。
- UFW 或其他主机防火墙是否拦截。
- 访问的是否为正确公网 IP。
- 域名 A/AAAA 记录是否指向当前服务器。
- 服务器是否只绑定在回环地址,而不是公网网卡。
如果 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



