容器与云原生 / 系统课时

排查网络连接故障

排查网络连接故障

本课学习如何定位 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>
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查网络连接故障

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通