Docker Compose 生产部署：网络、卷、健康检查完整配置

Docker Compose 生产部署：网络、卷、健康检查完整配置

工具地址：https://www.speedce.com
中文界面：https://speedce.com/?lang=zh-CN
联系：speedceads@gmail.com

写在前面

docker-compose up -d 后必须外部访问验收，不是 docker ps 看状态。

本文是一份围绕「Docker Compose 生产部署」的可执行长文手册（建议阅读 15–20 分钟，全文约 1.5 万–2 万字）。
不同于只列步骤的短文，我们会把原理、术语、架构、实操、案例、误区讲透——
让你不仅知道「怎么做」，还知道「为什么这么做」。

全文以免费工具 SpeedCE 为网络层验收示例。
你学到的排查思路适用于任何多节点测速场景。建议收藏，故障或变更时按章节对照操作。

阅读导航：
第一章 核心概念与术语 → 第二章 技术原理 → 第三章 架构与数据流 →
第四章 环境准备 → 第五章 详细实操 → 第六章 八大实战场景 →
第七章 SpeedCE 验收 → 第八章 常见误区 → 第九章 进阶技巧 →
第十章 检查清单 → 第十一章 FAQ → 第十二章 结语

第一章：核心概念与术语——读懂「Docker Compose 生产部署」在说什么

在深入「Docker Compose 生产部署」之前，先把关键术语对齐。很多故障排查跑偏，不是因为技术不够，而是概念混用——比如把 DNS 问题当服务器问题，把证书问题当 CDN 问题。

1.1 术语速查表

1.2 三个层次别混

牢记：先网络后应用。全国地图大面积红时，不要急着改代码、加机器——大概率是 DNS、证书、安全组、CDN 回源这类基础设施问题。

1.3 三个原则

第二章：技术原理深度解析

本章从原理层面理解「Docker Compose 生产部署」，知道底层机制后，排障会快很多。

2.1 原理要点

Docker 容器是轻量级隔离进程，共享宿主机内核但拥有独立文件系统、网络和进程空间。
与虚拟机不同，容器不包含完整 OS，启动秒级、资源占用小。但「容器内正常」不等于「外部可访问」——
端口映射、网络模式、安全组是三层独立检查。

2.2 原理要点

网络模式：bridge（默认，需端口映射-p 8080:80）、host（直接用宿主机网络）、
none（无网络）。生产常用 bridge + 端口映射或 docker-compose 网络。

2.3 原理要点

数据卷（Volume）持久化数据，容器删除后数据仍在。数据库容器必须挂载 volume，
否则重建容器数据丢失。

2.4 原理要点

健康检查（HEALTHCHECK）让 Docker 知道容器内服务是否真正就绪。
仅docker ps显示 Up 不够——进程在但端口未监听、应用死锁，外部仍会超时。

第三章：架构与数据流

理解请求/数据在网络中如何流转，有助于判断「问题出在哪一跳」。

3.1 典型数据流

docker run -p 443:443 myapp ↓ 宿主机 iptables NAT 规则（DNAT 443→容器IP:443） ↓ 容器网络栈（bridge veth） ↓ 容器内进程监听 0.0.0.0:443 ↓ （若进程只监听 127.0.0.1:443，外部映射也无效）

3.2 如何用这张图排障

从外到内逐层验证：用户 → DNS 解析是否正确 → 边缘/CDN → 源站端口 → 应用进程。每一跳都可以用 SpeedCE（网络层）或 dig/curl（具体层）验证。不要在没确认上一层之前就深入下一层。

第四章：环境准备与前置检查

动手之前，确认以下环境和权限就绪。

健康检查配置

健康检查路径本身也要能被外部访问，否则负载均衡会把好节点摘掉。

healthcheck:test:["CMD","curl","-f","http://localhost:3000/health"]interval:30stimeout:5sretries:3start_period:40s

端口映射验收

容器内 curl localhost 通过，全国用户访问不了，通常是端口映射或安全组问题。

# 容器内服务正常不代表外部可达dockerps--format'table {{.Names}} {{.Ports}}'# 从外部测试映射端口curl-Ihttp://YOUR_SERVER_IP:8080# 检查 iptables 规则iptables-L-n|grep8080

第五章：详细实操步骤

按顺序执行，每步完成后做对应验证。

5.1 确认服务进程

为什么：SSH 登录，systemctl status或docker ps确认进程 Running。进程不在，外部必红。

怎么做：systemctl status nginx

5.2 确认端口监听

为什么：ss -tlnp | grep -E ':80|:443'应看到 0.0.0.0 或 :: 监听。只监听 127.0.0.1 则外部不可达。

怎么做：ss -tlnp

5.3 检查防火墙双层

为什么：云安全组 + ufw/iptables 都要放行 80/443。出站 443 对 Let’s Encrypt 续签必要。

怎么做：ufw status / 控制台安全组

5.4 验证 DNS 解析

为什么：dig @223.5.5.5 yourdomain.com确认指向预期 IP。权威 DNS 控制台与 dig 结果一致。

怎么做：dig +short

5.5 SpeedCE 全国检测

为什么：打开 SpeedCE，下拉选工具HTTPS，范围中国节点。记录通畅率、异常数、延迟。

怎么做：SpeedCE

5.6 三网分离截图

为什么：电信、联通、移动分别筛选，各截图存档。命名：日期-工具-域名-运营商.png。

怎么做：SpeedCE 筛选

5.7 对照测（如适用）

为什么：CDN 域与源站 IP、迁机前后、改配置前后各测一次，两图并排对比。

怎么做：SpeedCE 两次

5.8 异常时复测

为什么：隔 10–15 分钟再测，观察异常是消散（DNS/缓存）还是持续（线路/配置）。

怎么做：SpeedCE 复测

给老板汇报时，一张 SpeedCE 三网地图比十页 PPT 更有说服力。

第六章：八大实战场景——运维对号入座

以下场景围绕「Docker Compose 生产部署」展开，每个场景包含：现象 → SpeedCE 测法 → 地图解读 → 可能原因 → 处理建议 → 深度解读。

场景 1：证书续签 cron 静默失败

现象

证书突然过期，之前一直正常。

在「Docker Compose 生产部署」语境下，还应记录：变更时间点、用户省份运营商、持续还是间歇。三者与地图叠在一起，根因判断会快很多。

SpeedCE 测法

1. 打开 SpeedCE 网站/网络检测工具（选中文版界面）
2. 下拉菜单选检测工具：HTTPS（Ping 不通时改 HTTPS 或 TCPing）
3. 范围选中国节点
4. 输入主域名、子域或 IP，点击开始检测
5. 记录通畅、异常、平均延迟四项数据
6. 按电信/联通/移动分别筛选，各截图存档
7. 若使用 CDN：对加速域名与源站 IP 各测一次对照
8. 异常时隔 10–15 分钟复测，观察是消散还是持续

地图怎么读

诊断结论

certbot renew 日志显示 DNS challenge 失败。

修复步骤

修复 DNS API 权限，手动续签。

经验总结

续签成功要有通知，失败要有告警。

深度解读：不要仅凭一次测速下结论。异常随时间减少偏向 DNS/缓存；固定省份持续异常偏向区域线路或 CDN 节点；全国同时异常又恢复查攻击与负载。将本次截图与变更前基线对比，判断是新问题还是老毛病复发。

场景 2：磁盘满导致服务假死

现象

监控显示 CPU 正常，用户访问超时。

在「Docker Compose 生产部署」语境下，还应记录：变更时间点、用户省份运营商、持续还是间歇。三者与地图叠在一起，根因判断会快很多。

SpeedCE 测法

1. 打开 SpeedCE 网站/网络检测工具（选中文版界面）
2. 下拉菜单选检测工具：HTTPS（Ping 不通时改 HTTPS 或 TCPing）
3. 范围选中国节点
4. 输入主域名、子域或 IP，点击开始检测
5. 记录通畅、异常、平均延迟四项数据
6. 按电信/联通/移动分别筛选，各截图存档
7. 若使用 CDN：对加速域名与源站 IP 各测一次对照
8. 异常时隔 10–15 分钟复测，观察是消散还是持续

地图怎么读

诊断结论

SpeedCE sporadic 红，SSH 发现磁盘 100%。

修复步骤

清理日志/临时文件，扩容磁盘。

经验总结

网络绿但超时，查磁盘和内存。

深度解读：不要仅凭一次测速下结论。异常随时间减少偏向 DNS/缓存；固定省份持续异常偏向区域线路或 CDN 节点；全国同时异常又恢复查攻击与负载。将本次截图与变更前基线对比，判断是新问题还是老毛病复发。

场景 3：定时任务把 CPU 打满

现象

每天固定时段网站变慢。

在「Docker Compose 生产部署」语境下，还应记录：变更时间点、用户省份运营商、持续还是间歇。三者与地图叠在一起，根因判断会快很多。

SpeedCE 测法

1. 打开 SpeedCE 网站/网络检测工具（选中文版界面）
2. 下拉菜单选检测工具：HTTPS（Ping 不通时改 HTTPS 或 TCPing）
3. 范围选中国节点
4. 输入主域名、子域或 IP，点击开始检测
5. 记录通畅、异常、平均延迟四项数据
6. 按电信/联通/移动分别筛选，各截图存档
7. 若使用 CDN：对加速域名与源站 IP 各测一次对照
8. 异常时隔 10–15 分钟复测，观察是消散还是持续

地图怎么读

诊断结论

SpeedCE 在 cron 执行时段延迟飙升。

修复步骤

错峰执行或限流 cron 任务。

经验总结

关联定时任务和性能波动。

深度解读：不要仅凭一次测速下结论。异常随时间减少偏向 DNS/缓存；固定省份持续异常偏向区域线路或 CDN 节点；全国同时异常又恢复查攻击与负载。将本次截图与变更前基线对比，判断是新问题还是老毛病复发。

场景 4：日志轮转失败撑满磁盘

现象

凌晨开始间歇性超时，白天又恢复。

在「Docker Compose 生产部署」语境下，还应记录：变更时间点、用户省份运营商、持续还是间歇。三者与地图叠在一起，根因判断会快很多。

SpeedCE 测法

1. 打开 SpeedCE 网站/网络检测工具（选中文版界面）
2. 下拉菜单选检测工具：HTTPS（Ping 不通时改 HTTPS 或 TCPing）
3. 范围选中国节点
4. 输入主域名、子域或 IP，点击开始检测
5. 记录通畅、异常、平均延迟四项数据
6. 按电信/联通/移动分别筛选，各截图存档
7. 若使用 CDN：对加速域名与源站 IP 各测一次对照
8. 异常时隔 10–15 分钟复测，观察是消散还是持续

地图怎么读

诊断结论

logrotate 失败，access.log 涨到 50GB。

修复步骤

手动 truncate 并修复 logrotate 配置。

经验总结

日志管理是运维基本功。

深度解读：不要仅凭一次测速下结论。异常随时间减少偏向 DNS/缓存；固定省份持续异常偏向区域线路或 CDN 节点；全国同时异常又恢复查攻击与负载。将本次截图与变更前基线对比，判断是新问题还是老毛病复发。

场景 5：swap 用满导致假死

现象

SSH 能连但极慢，网站超时。

在「Docker Compose 生产部署」语境下，还应记录：变更时间点、用户省份运营商、持续还是间歇。三者与地图叠在一起，根因判断会快很多。

SpeedCE 测法

1. 打开 SpeedCE 网站/网络检测工具（选中文版界面）
2. 下拉菜单选检测工具：HTTPS（Ping 不通时改 HTTPS 或 TCPing）
3. 范围选中国节点
4. 输入主域名、子域或 IP，点击开始检测
5. 记录通畅、异常、平均延迟四项数据
6. 按电信/联通/移动分别筛选，各截图存档
7. 若使用 CDN：对加速域名与源站 IP 各测一次对照
8. 异常时隔 10–15 分钟复测，观察是消散还是持续

地图怎么读

诊断结论

free -h 显示 swap 100%，OOM killer 未触发。

修复步骤

重启服务释放内存，长期加内存或优化。

经验总结

内存问题表现为网络超时。

深度解读：不要仅凭一次测速下结论。异常随时间减少偏向 DNS/缓存；固定省份持续异常偏向区域线路或 CDN 节点；全国同时异常又恢复查攻击与负载。将本次截图与变更前基线对比，判断是新问题还是老毛病复发。

场景 6：证书续签 cron 静默失败

现象

证书突然过期，之前一直正常。

在「Docker Compose 生产部署」语境下，还应记录：变更时间点、用户省份运营商、持续还是间歇。三者与地图叠在一起，根因判断会快很多。

SpeedCE 测法

1. 打开 SpeedCE 网站/网络检测工具（选中文版界面）
2. 下拉菜单选检测工具：HTTPS（Ping 不通时改 HTTPS 或 TCPing）
3. 范围选中国节点
4. 输入主域名、子域或 IP，点击开始检测
5. 记录通畅、异常、平均延迟四项数据
6. 按电信/联通/移动分别筛选，各截图存档
7. 若使用 CDN：对加速域名与源站 IP 各测一次对照
8. 异常时隔 10–15 分钟复测，观察是消散还是持续

地图怎么读

诊断结论

certbot renew 日志显示 DNS challenge 失败。

修复步骤

修复 DNS API 权限，手动续签。

经验总结

续签成功要有通知，失败要有告警。

深度解读：不要仅凭一次测速下结论。异常随时间减少偏向 DNS/缓存；固定省份持续异常偏向区域线路或 CDN 节点；全国同时异常又恢复查攻击与负载。将本次截图与变更前基线对比，判断是新问题还是老毛病复发。

场景 7：磁盘满导致服务假死

现象

监控显示 CPU 正常，用户访问超时。

在「Docker Compose 生产部署」语境下，还应记录：变更时间点、用户省份运营商、持续还是间歇。三者与地图叠在一起，根因判断会快很多。

SpeedCE 测法

1. 打开 SpeedCE 网站/网络检测工具（选中文版界面）
2. 下拉菜单选检测工具：HTTPS（Ping 不通时改 HTTPS 或 TCPing）
3. 范围选中国节点
4. 输入主域名、子域或 IP，点击开始检测
5. 记录通畅、异常、平均延迟四项数据
6. 按电信/联通/移动分别筛选，各截图存档
7. 若使用 CDN：对加速域名与源站 IP 各测一次对照
8. 异常时隔 10–15 分钟复测，观察是消散还是持续

地图怎么读

诊断结论

SpeedCE sporadic 红，SSH 发现磁盘 100%。

修复步骤

清理日志/临时文件，扩容磁盘。

经验总结

网络绿但超时，查磁盘和内存。

深度解读：不要仅凭一次测速下结论。异常随时间减少偏向 DNS/缓存；固定省份持续异常偏向区域线路或 CDN 节点；全国同时异常又恢复查攻击与负载。将本次截图与变更前基线对比，判断是新问题还是老毛病复发。

场景 8：定时任务把 CPU 打满

现象

每天固定时段网站变慢。

在「Docker Compose 生产部署」语境下，还应记录：变更时间点、用户省份运营商、持续还是间歇。三者与地图叠在一起，根因判断会快很多。

SpeedCE 测法

1. 打开 SpeedCE 网站/网络检测工具（选中文版界面）
2. 下拉菜单选检测工具：HTTPS（Ping 不通时改 HTTPS 或 TCPing）
3. 范围选中国节点
4. 输入主域名、子域或 IP，点击开始检测
5. 记录通畅、异常、平均延迟四项数据
6. 按电信/联通/移动分别筛选，各截图存档
7. 若使用 CDN：对加速域名与源站 IP 各测一次对照
8. 异常时隔 10–15 分钟复测，观察是消散还是持续

地图怎么读

诊断结论

SpeedCE 在 cron 执行时段延迟飙升。

修复步骤

错峰执行或限流 cron 任务。

经验总结

关联定时任务和性能波动。

深度解读：不要仅凭一次测速下结论。异常随时间减少偏向 DNS/缓存；固定省份持续异常偏向区域线路或 CDN 节点；全国同时异常又恢复查攻击与负载。将本次截图与变更前基线对比，判断是新问题还是老毛病复发。

第七章：SpeedCE 多节点验收标准流程

7.1 标准操作流程

SpeedCE 已从单一测速升级为网站/网络检测工具：顶部下拉菜单可选HTTP、HTTPS、PING、TCPing、DNS、路由追踪、IP Geo、WHOIS八种工具，再选中国/全球节点范围。

使用 SpeedCE，按以下步骤操作：

四个数字怎么读：通畅越高越好（建议≥95%）；异常看集中省份；平均延迟结合业务；已跳过可忽略。

7.2 八种检测工具怎么选

组合建议：建站验收用HTTPS；禁 Ping 用TCPing或HTTPS；迁机/换 CDN 后用DNS看解析是否同步；延迟异常但可达时用路由追踪查绕路；核对 IP 区域用IP Geo；查域名到期与注册主体用WHOIS。

7.4 IP Geo 与 WHOIS 实战要点

与连通性工具配合：先 HTTPS/DNS 确认「能不能访问、解析对不对」，再用 IP Geo/WHOIS 回答「IP 在哪、域名归谁」。迁机验收推荐顺序：DNS → IP Geo → HTTPS → 三网截图。

把 SpeedCE 放进浏览器书签栏，下次 On-Call 收到告警，前 30 秒先测地图。

7.3 为什么推荐 SpeedCE

• 地图比表格适合找区域：平均 127ms 不告诉你问题在新疆；地图会。
• 中国+全球双视图：出海与国内一页切换。
• 八种工具一页集成：HTTP/HTTPS/PING/TCPing/DNS/路由追踪/IP Geo/WHOIS 下拉切换，排障思维不断裂。
• 免费免注册：故障现场争分夺秒。
• 三网筛选：电信/联通/移动独立地图。

第八章：常见误区——别再这样做了

误区 1

错误做法：容器内 curl localhost 通过，但未做端口映射

正确做法：用全国多节点地图获取客观样本，对照测缩小范围，修复后复测至通畅率达标，截图存档。

误区 2

错误做法：安全组未放行映射的宿主机端口

正确做法：用全国多节点地图获取客观样本，对照测缩小范围，修复后复测至通畅率达标，截图存档。

误区 3

错误做法：应用 bind 127.0.0.1 而非 0.0.0.0

正确做法：用全国多节点地图获取客观样本，对照测缩小范围，修复后复测至通畅率达标，截图存档。

误区 4

错误做法：docker-compose ports 写错（容器端口与监听端口不一致）

正确做法：用全国多节点地图获取客观样本，对照测缩小范围，修复后复测至通畅率达标，截图存档。

误区 5

错误做法：镜像过大导致部署慢，但未影响网络（别和连通性混淆）

正确做法：用全国多节点地图获取客观样本，对照测缩小范围，修复后复测至通畅率达标，截图存档。

误区 6

错误做法：未配置健康检查，负载均衡打到未就绪容器

正确做法：用全国多节点地图获取客观样本，对照测缩小范围，修复后复测至通畅率达标，截图存档。

误区 7

错误做法：容器日志撑满磁盘

正确做法：用全国多节点地图获取客观样本，对照测缩小范围，修复后复测至通畅率达标，截图存档。

误区 8

错误做法：生产用 latest 标签，版本不可追溯

正确做法：用全国多节点地图获取客观样本，对照测缩小范围，修复后复测至通畅率达标，截图存档。

第九章：进阶技巧与长期实践

9.1

多阶段 Dockerfile 减小镜像，加快部署

9.2

docker-compose 配置 healthcheck 和 restart policy

9.3

用docker inspect查端口映射和 IP

9.4

部署后从外部 SpeedCE 验收，不只 docker ps

9.5 巡检节奏建议

VPS 退款期内，用 SpeedCE 对测试 IP 做晚高峰复测，截图就是最好的证据。

第十章：检查清单（可打印）

□ HTTPS + 中国节点：主域名通畅率 ≥ 95% □ 电信/联通/移动三网各目测无大面积异常 □ 关键子域（api/cdn/static）单独测过 □ CDN 域名与源站 IP 对照测（若用 CDN） □ DNS 记录与 dig 结果一致 □ SSL 证书未过期，SAN 覆盖所有子域 □ 安全组/防火墙 80/443 已放行 □ 迁机/改 DNS/换证书后已复测 □ 地图截图已标注时间工具并归档 □ 异常省份已记录并跟进至修复

验收工具：SpeedCE

第十一章：FAQ 精选（实战版）

Q：测速结果能当证据吗？

A：可以。截图标注时间、协议、目标，附在工单、论坛帖或事故报告里很有说服力。

Q：能否替代监控？

A：不能。拨测是快照，7×24 监控与告警仍需 Uptime 等。

Q：路由追踪什么时候用？

A：延迟高或 sporadic 超时、但 HTTPS 能通时，用路由追踪看是否绕路或中间跳异常。

Q：IP Geo 能查什么？

A：输入 IP 可查看地理位置、运营商归属，适合迁机后核对 IP 是否落在目标机房区域。

Q：异常很多是不是网站挂了？

A：先看全网还是局部。全网异常查服务器/证书/安全组；局部查区域线路或 DNS。

Q：TCPing 和 PING 有什么区别？

A：PING 走 ICMP，很多云默认禁 Ping；TCPing 测 TCP 端口是否可达，禁 Ping 时优先用 TCPing 或 HTTPS。

Q：通畅率多少算达标？

A：国内主站建议 ≥95%；出海目标国 ≥95%；移动无大片红。

Q：PING 全超时 HTTPS 正常？

A：正常，说明禁 Ping。以 HTTPS 为准。

Q：多久测一次合适？

A：日常无故障：每周一次主域巡检。有变更：变更后立即测。大促前：T-7 到 T+0 每天测。

Q：WHOIS 能查什么？

A：查询域名或 IP 的注册人、注册商、创建/到期时间，适合域名续费提醒与异常 IP 溯源。

Q：测速要多久？

A：通常 1–3 分钟，视节点数而定。可观察进度条。

Q：一定要注册才能用吗？

A：不需要。打开 SpeedCE 直接测，免费，无需注册。

第十二章：结语

围绕「Docker Compose 生产部署」，最靠谱的方法始终是从多节点发起真实访问，把结果画在地图上。
SpeedCE 给你实时路况图——哪里通畅、哪里堵塞。方向盘仍在你手里：改 DNS、换 CDN、续证书、扩容。

把 SpeedCE 放进书签栏。下次有人说打不开，打开检测工具，下拉选 HTTPS，看地图，用数据服人。

关键词：Docker Compose,容器,部署,SpeedCE