news 2026/5/30 13:01:16

Docker容器网络不通排查指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Docker容器网络不通排查指南

前言

容器跑起来了,但是网络不通——ping不通外网、容器间互相访问不了、端口映射不生效…

这类问题排查比较麻烦,涉及容器网络、宿主机网络、iptables规则等多个层面。这篇整理一套系统的排查流程,覆盖常见的网络问题场景。


一、容器访问不了外网

症状:

dockerexec-it myappping8.8.8.8# 卡住或者 Network is unreachable

第一反应:检查宿主机的IP转发有没有开。

cat/proc/sys/net/ipv4/ip_forward

如果是0,容器的包出不去。开一下:

echo1>/proc/sys/net/ipv4/ip_forward# 永久生效要写到sysctl.conf

还是不通?看下iptables的NAT规则:

iptables -t nat -L -n|grepMASQUERADE

应该有条类似这样的规则:

MASQUERADE all -- 172.17.0.0/16 0.0.0.0/0

没有的话Docker的NAT可能被清掉了,重启Docker一般能恢复:

systemctl restartdocker

还有一个大坑:firewalld。CentOS默认开着,它和Docker的iptables规则会打架。

# 先关了试试systemctl stop firewalld

如果关了就好了,说明是防火墙的问题。正式解决要配置firewalld的docker zone,或者干脆用iptables。

二、容器间网络不通

在同一台机器上,两个容器互相访问不了。

先确认它们在不在同一个网络:

dockerinspect 容器A --format'{{.NetworkSettings.Networks}}'dockerinspect 容器B --format'{{.NetworkSettings.Networks}}'

如果都在默认的bridge网络,有个坑:默认bridge不支持通过容器名访问

dockerexec容器Aping容器B# ping: 容器B: Name or service not known

只能用IP:

# 先拿到IPdockerinspect 容器B --format'{{.NetworkSettings.IPAddress}}'# 172.17.0.3dockerexec容器Aping172.17.0.3# 这样就通了

嫌麻烦的话,用自定义网络:

dockernetwork create mynetdockernetwork connect mynet 容器Adockernetwork connect mynet 容器B# 现在可以用名字了dockerexec容器Aping容器B

自定义网络有内置DNS,会自动解析容器名。

三、端口映射不生效

dockerrun -p8080:80 nginxcurlhttp://localhost:8080# 不通

先确认服务在容器里跑起来没:

dockerexec容器curllocalhost:80

如果容器里能访问说明服务没问题,那问题在外面。

检查点:

1、服务监听的地址对不对:

dockerexec容器netstat-tlnp

如果显示127.0.0.1:80,那外面肯定访问不了,要改成0.0.0.0:80

2、宿主机端口有没有被占:

netstat-tlnp|grep8080

3、防火墙/安全组:

# 本地防火墙firewall-cmd --list-ports# 云服务器别忘了安全组

云服务器安全组没开端口是个常见的坑。

四、DNS解析失败

能ping通IP,但ping域名不行:

dockerexec容器ping8.8.8.8# 通dockerexec容器pingbaidu.com# 不通

看下容器的DNS配置:

dockerexec容器cat/etc/resolv.conf

如果DNS服务器不可达,最简单的办法是启动时指定:

dockerrun --dns8.8.8.8 nginx

或者全局配置,改/etc/docker/daemon.json

{"dns":["8.8.8.8","114.114.114.114"]}

五、跨主机容器通信

这个稍微复杂点。两台机器上的容器默认是不通的,因为各自的bridge网络是隔离的。

最简单的方案:用端口映射,通过宿主机IP访问。

# 机器B上dockerrun -p8080:80 nginx# 机器A上访问curlhttp://机器B的IP:8080

想让容器直接互通的话,要用overlay网络或者第三方方案(Flannel、Calico这些)。

还有个偏门办法:如果两台主机已经通过WireGuard或者其他组网工具连在一起了,可以配静态路由让容器网段互通。不过这个配置比较麻烦,一般不推荐。

六、一键诊断脚本

懒得一个个查,写了个脚本:

#!/bin/bash# 用法: ./check.sh 容器名C=$1echo"=== 检查$C==="echo-e"\n[网络模式]"dockerinspect$C--format'{{.HostConfig.NetworkMode}}'echo-e"\n[IP地址]"dockerinspect$C--format'{{.NetworkSettings.IPAddress}}'echo-e"\n[路由]"dockerexec$Ciproute2>/dev/null||echo"无ip命令"echo-e"\n[DNS]"dockerexec$Ccat/etc/resolv.conf2>/dev/nullecho-e"\n[外网连通性]"dockerexec$Cping-c1-W28.8.8.82>/dev/null&&echo"OK"||echo"不通"echo-e"\n[宿主机IP转发]"cat/proc/sys/net/ipv4/ip_forward

跑一下基本能看出问题在哪。


总结

Docker网络问题90%出在这几个地方:

问题原因解决
容器出不了外网ip_forward没开echo 1 > /proc/sys/net/ipv4/ip_forward
容器出不了外网防火墙拦截检查firewalld/iptables
容器间不通不在同一网络使用自定义网络
端口映射失败服务监听127.0.0.1改成监听0.0.0.0
DNS解析失败DNS服务器不可达指定DNS服务器

排查顺序:网络配置IP转发防火墙规则服务监听地址DNS配置


有问题评论区交流。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/29 6:29:26

STM32 USART多机通信与RS485协同工作原理

STM32 RS485:当硬件地址识别撞上半双工总线,工业串行组网才真正开始可靠你有没有遇到过这样的现场?一台STM32控制着十几台温控模块,用RS485连成一串,跑着Modbus RTU——某天产线突然报“从机无响应”,排查…

作者头像 李华
网站建设 2026/5/29 16:20:18

小白必看:Qwen3-ASR-1.7B语音转文字保姆级教程

小白必看:Qwen3-ASR-1.7B语音转文字保姆级教程 1. 这不是“又一个语音识别工具”,而是你会议记录、视频字幕的本地安心之选 你有没有过这些时刻—— 录完一场两小时的技术分享,想整理成文字稿,却卡在“听不清”“中英文混着说”…

作者头像 李华
网站建设 2026/5/29 21:33:28

基于运放的精密LED灯电流控制电路示例

运放恒流驱动LED:一个老工程师的实战手记 去年调试一款车载仪表盘背光时,我连续烧了三颗LED灯珠——不是过流,而是电流“悄悄”飘高了18%。示波器抓到的不是尖峰,是一条缓慢上爬的斜线:环境温度从25C升到45C&#xff0…

作者头像 李华
网站建设 2026/5/29 12:03:40

nodejs+vue二手电子产品回收系统

文章目录系统概述核心功能技术亮点应用场景--nodejs技术栈--结论源码文档获取/同行可拿货,招校园代理 :文章底部获取博主联系方式!系统概述 Node.js与Vue.js结合的二手电子产品回收系统是一个基于现代Web技术的全栈应用,旨在为用户提供便捷的…

作者头像 李华
网站建设 2026/5/25 14:52:15

/usr/bin/ld: 找不到 -xx如何处理

usr/bin/ld: 找不到 -lbrotlidec /usr/bin/ld: 找不到 -lharfbuzz collect2: error: ld returned 1 exit status 这些错误表示缺少 libbrotlidec 和 libharfbuzz 库。你需要安装这些库的开发版本。以下是根据不同系统的解决方案: 1. Ubuntu/Debian 系统 # Ubuntu 20.04 及更…

作者头像 李华