容器与云原生 / 系统课时
排查网络连接故障
排查网络连接故障
本课学习如何定位 Docker 容器之间或容器与外部服务之间的网络异常。通过 inspect、exec、日志和网络工具,可以确认名称解析、端口监听、路由以及访问控制中的具体问题。
学习目标
- 掌握 Docker 网络故障的基础定位顺序。
- 使用常用命令检查容器网络状态和连接情况。
- 根据现象判断 DNS、端口或防火墙类问题。
建立网络排查路径
Docker 网络故障通常表现为“无法连接”“连接超时”或“服务不存在”。排查时不要直接修改配置,应先确认问题发生在哪一层:容器是否加入正确网络、名称是否能解析、目标端口是否监听、数据包是否被阻断。
排查顺序可以固定为:查看网络配置 → 进入容器验证 → 检查服务监听 → 分析日志和外部限制。这样可以快速缩小范围,避免在错误方向上反复调整。
检查容器与网络配置
docker inspect 可以查看容器绑定的网络、IP 地址和网关信息。首先确认容器是否连接到了预期网络。
bash
docker inspect <ID> --format '{{json .NetworkSettings.Networks}}'预期输出
text
{"app-net":{"IPAddress":"172.20.0.3","Gateway":"172.20.0.1"}}如果输出为空或没有目标网络,需要检查启动参数或 Compose 网络定义。容器名称解析依赖 Docker 网络内部 DNS,未加入同一网络时通常无法通过服务名访问。
进入容器验证连接
容器内部环境可能与宿主机不同,需要进入容器测试 DNS 和端口连通性。
bash
docker exec -it <ID> sh
getent hosts <SERVICE_NAME>预期输出
text
172.20.0.5 <SERVICE_NAME>如果名称无法解析,优先检查网络连接和服务名称。如果解析正常但连接失败,则继续检查目标服务端口和应用状态。
检查端口与服务状态
端口问题需要区分“没有监听”和“监听但无法访问”。在容器内可以使用基础网络工具确认监听状态。
bash
docker exec <ID> sh -c 'netstat -tln 2>/dev/null || ss -tln'预期结果
text
LISTEN 0 128 0.0.0.0:<PORT>如果应用只监听 127.0.0.1,其他容器无法通过网络访问,需要调整应用监听地址。
查看日志与访问限制
当网络配置正常但请求仍失败,应检查应用日志、宿主机防火墙和安全策略。Docker 本身负责网络连接,但不会修复应用拒绝连接、端口未开放等问题。
bash
docker logs --tail 50 <ID>预期输出
text
Application started and listening on port <PORT>按自己的节奏,确认真正理解。