Docker 容器网络故障排查怎么解

胖丽小哥_4623

胖丽小哥_4623

2026-08-12

651人浏览

原创

容器网络不通需分层定位:先验证连通性(如ping 8.8.8.8),再检查端口与服务(如监听地址、dns解析),最后排查防火墙或iptables策略拦截;常见原因包括ip转发未开启、nat规则缺失、firewalld干扰、容器不在同一网络、docker-user链限制、dns配置错误及端口冲突等。

docker 容器网络故障排查怎么解

容器网络不通,不是“修一个地方就行”,而是要分层定位:先看通不通(连通性),再看能不能用(端口和服务),最后看有没有被拦(防火墙或策略)。下面按常见故障场景拆解,每一步都带验证和操作建议。

容器访问不了外网

典型表现是 docker exec -it 容器 ping 8.8.8.8 卡住或提示 Network is unreachable

  • 检查宿主机 IP 转发是否开启:cat /proc/sys/net/ipv4/ip_forward,输出为 0 就得打开:echo 1 > /proc/sys/net/ipv4/ip_forward(永久生效需写入 /etc/sysctl.conf
  • 确认 Docker 的 NAT 规则是否存在:iptables -t nat -L -n | grep MASQUERADE。正常应有类似 MASQUERADE all -- 172.17.0.0/16 0.0.0.0/0 的规则;没有就重启 Docker:systemctl restart docker
  • 如果是 CentOS/RHEL 系统,firewalld 很可能在干扰:临时停掉试试 systemctl stop firewalld。如果网络立刻恢复,说明问题出在这,后续应配置 firewalld 的 docker zone 或改用 iptables 管理。

容器之间 ping 不通或无法访问服务

比如前端容器 curl 后端容器地址超时,但 ping 容器名ping IP 都能通——这说明网络层可达,但应用层被拦了。

Docker Ctl
Docker Ctl

使用 podman 检查容器、日志和镜像

下载
  • 先确认两个容器是否在同一个网络:docker inspect 容器A --format '{{.NetworkSettings.Networks}}',对比输出。不在同一网络就用 docker network connect 加入
  • 默认 bridge 网络不支持容器名解析,只能靠 IP 访问;如需通过名字通信,必须使用 自定义 bridge 网络(创建时加 --driver bridge
  • 重点查宿主机 DOCKER-USER 链:很多情况下 ping 通但 curl 不通,是因为 iptables 拦了 TCP 流量。执行 sudo iptables -L DOCKER-USER -n,看是否有放行对应子网和端口的规则。缺的话补一条,例如:
    sudo iptables -I DOCKER-USER 1 -s 172.23.0.0/16 -p tcp --dport 8080 -j ACCEPT

DNS 解析失败或无法拉取镜像

现象是 ping 8.8.8.8 成功,但 ping google.com 失败,或者 docker pull 卡住、报 TLS timeout。

  • 进容器看 /etc/resolv.conf,如果 DNS 是 127.0.0.11 但 dockerd 的内置 DNS(dnsmasq)没起来,就会解析失败。可临时重启 docker:systemctl restart docker
  • 更稳妥的做法是在 /etc/docker/daemon.json 里指定可靠 DNS:
    {"dns": ["8.8.8.8", "1.1.1.1"]},然后重启 docker
  • 企业或校园网环境下,注意检查是否被 DNS 劫持或代理拦截。用 nslookup registry-1.docker.io 看返回 IP 是否合理;若异常,换 DNS 或配代理(如 QNAP NAS 需在控制面板中设置系统代理)

端口映射不生效或容器启动失败

比如 docker run -p 8080:80 后宿主机访问不到,或直接报 failed to create endpoint

  • 先查端口是否被占:netstat -tulnp | grep :8080lsof -i :8080。有冲突就换映射端口,或杀掉占用进程
  • 检查虚拟网桥状态:ip link show docker0brctl show(需装 bridge-utils)。如果 docker0 不存在或 down 了,可能是网络被重置过,重启 docker 通常能恢复
  • 极端情况可清理重建网络:docker network prune -fsystemctl restart docker,但会断开所有正在运行的容器网络连接,慎用

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

625

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

4359

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5237

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

1953

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

219

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

391

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

360

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

265

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

365

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习