发布时间:2026-09-29 04:30 更新时间:2026-09-29 04:30 阅读量:10
很多站长都会遇到这样一幕:容器里 curl 127.0.0.1:8080 返回正常,可一到宿主机执行 curl 127.0.0.1:8080 就是 connection refused 或者直接超时。第一反应往往是“端口没映射”,但把 docker ps 翻出来看,-p 8080:8080 明明写着。问题通常不在映射有没有写,而在三个东西的配合上:容器内进程的 bind 地址、Docker 写入的 iptables 链,以及 端口映射的解析顺序。这篇文章按“容器内 → 容器到宿主 → 宿主本机 → 外部”的顺序,一层层验证,走到哪层断掉,问题就在哪层。
容器内进程监听哪个地址,直接决定了端口映射能不能把流量送进去。如果应用只监听 127.0.0.1,那它只接受来自容器回环接口的连接;Docker 的端口映射是从容器的 eth0 网卡进来转发到容器内目标端口的,走的是容器内的非回环路径,因此连不上。这就是“容器内 curl 通、宿主不通”最常见的原因。应用应该监听 0.0.0.0(IPv4 全部地址)或 ::(IPv6 全部地址,通常也覆盖 IPv4)。
先在容器里确认实际监听地址。注意 ss 不一定存在于精简镜像里,可以用 netstat -lntp 或直接读 /proc/net/tcp 作为兜底。
# 进入容器
docker exec -it web sh
查看监听地址(-l 监听,-n 数字,-t TCP,-p 进程)
ss -lntp | grep 8080
或
netstat -lntp | grep 8080
预期看到 0.0.0.0:8080 或 :::8080
如果看到 127.0.0.1:8080,就是 bind 地址问题
如果是 bind 地址问题,改法有两种:一是改应用配置,让它监听 0.0.0.0;二是如果应用只允许监听回环,就在容器内再放一层反向代理把流量转到回环,但这种情况更适合直接改应用启动参数。以 Nginx 为例,listen 127.0.0.1:8080 改成 listen 8080 即可,后者默认等价于监听所有地址。
Docker 的端口发布靠的是 iptables 的 DNAT 规则,链路大致是:外部流量进入宿主机的 nat 表 PREROUTING 链,命中 DOCKER 链后被 DNAT 到容器 IP:端口,再经 FORWARD 链放行。如果宿主机上装了 firewalld、ufw 或手工写过的规则,FORWARD 链默认策略可能被改成 DROP,容器转发的包就被丢掉了;也可能有人在 DOCKER-USER 链里加了拒绝规则。这里要看的是“规则有没有、顺序对不对”,而不是猜。
# 查看 nat 表端口映射规则(重点关注 DOCKER 链)
sudo iptables -t nat -L DOCKER -n --line-numbers
查看 filter 表转发规则与 DOCKER-USER 链
sudo iptables -L DOCKER-USER -n -v --line-numbers
sudo iptables -L FORWARD -n -v --line-numbers
查看宿主机上该端口有没有被监听(映射成功后通常会有 docker-proxy 或内核转发)
sudo ss -lntp | grep 8080
一个容易忽略的点:端口映射顺序。如果你写了 -p 8080:80,容器内应用却监听在 8080,那映射的目标端口对不上,自然不通;反过来 -p 8080:8080 但应用监听 80 也一样。确认容器内监听端口和 -p 宿主端口:容器端口 的冒号右侧一致,是排查前必须做的一步。另外,同一宿主端口被两个容器或宿主进程同时占用时,Docker 会报错或后启动的容器映射失败,用 ss -lntp 看端口归属能立刻分辨。
还有一类情况是宿主机只监听在 IPv6 上。比如 ss 显示 :::8080,而客户端强制用 IPv4 访问,或反过来。这时要确认 /etc/docker/daemon.json 里的 ip 与 ip6tables 相关配置,以及内核 net.ipv6.bindv6only 的取值,具体行为以官方文档和实际环境为准。
排查顺序建议固定为四步,每一步只回答一个问题:容器内部通不通、容器到宿主通不通、宿主本机通不通、外部通不通。这样能快速收敛范围。
# 第 1 层:容器内部回环
docker exec -it web curl -sS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/
第 2 层:容器访问宿主机(Linux 上 172.17.0.1 通常是默认 bridge 网关)
docker exec -it web curl -sS -m 3 -o /dev/null -w "%{http_code}\n" http://172.17.0.1:8080/
第 3 层:宿主机本机访问映射端口
curl -sS -m 3 -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/
第 4 层:从局域网另一台机器或公网访问
curl -sS -m 3 -o /dev/null -w "%{http_code}\n" http://<宿主机IP>:8080/
读结果的方法很直接:第 1 层通、第 2 层不通,多半是容器内 bind 地址或容器网络问题;第 2 层通、第 3 层不通,重点查 iptables 的 DOCKER 链和端口占用;第 3 层通、第 4 层不通,则要看宿主机防火墙、云厂商安全组和监听地址是不是只绑了回环。第 2 层里的网关地址不一定都是 172.17.0.1,自定义网络下会变,用 docker network inspect <网络名> 查 Gateway 字段确认即可。
如果第 3 层不通,还可以临时抓包看包到底有没有到达容器:
# 在宿主机抓 docker0 网桥上的 8080 流量
sudo tcpdump -i docker0 -nn port 8080
同时在容器内抓(容器内需有 tcpdump,或用 nsenter 进入网络命名空间)
docker exec -it web tcpdump -i eth0 -nn port 8080
宿主机抓不到、容器也抓不到,说明 DNAT 前就被拦了;宿主机抓到、容器抓不到,说明转发路径被 FORWARD 或 DOCKER-USER 拦了;两边都抓到但应用没响应,问题就回到应用层,而不是网络层。这一招能把“网络问题”和“应用问题”彻底分开。
“容器内 curl 通、宿主不通”九成以上落在三个点上:应用只监听了 127.0.0.1、-p 的容器端口与监听端口不一致、宿主机的 FORWARD/DOCKER-USER 链把转发流量丢了。排查时按容器内回环、容器到宿主、宿主本机、外部访问四层走一遍,再用 iptables -t nat -L DOCKER -n 和 ss -lntp 交叉验证,基本能当场定位。修好之后建议把监听地址与端口映射写进部署清单,避免下次换镜像时又踩同一个坑;涉及防火墙与内核参数调整时,先备份现有规则再改,具体行为以官方文档和你的实际环境为准。
| 📑 | 📅 |
|---|---|
| Nginx 长连接被中间设备掐断排查:从抓包 RST 到 keepalive_timeout 调优 | 2026-09-29 |
| Linux SYN_RECV 堆积排查:半连接队列与 tcp_syncookies | 2026-09-29 |
| Docker容器DNS解析异常:127.0.0.11与自定义网络排查 | 2026-09-28 |
| Redis内存碎片率异常:used_memory与RSS差在哪 | 2026-09-28 |
| MySQL 8 临时表爆满排查:内存临时表与磁盘落盘定位 | 2026-09-28 |
| MySQL慢查询Rows_examined远大于Rows_sent:回表与覆盖索引优化 | 2026-09-29 |
| PostgreSQL备库查询被长事务阻塞排查与配置取舍 | 2026-09-29 |
| MySQL 8 表被锁等待排查:从 INNODB_TRX 到阻塞源头 | 2026-09-30 |
| Nginx 与后端 HTTP/2 与 HTTP/1.1 混用排查:协议协商与日志字段 | 2026-09-30 |
| Docker容器ulimit不生效排查:句柄继承链路与优先级 | 2026-09-30 |