Docker 容器内 curl 通但宿主不通:端口映射与 iptables 排查

    发布时间: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 链,以及 端口映射的解析顺序。这篇文章按“容器内 → 容器到宿主 → 宿主本机 → 外部”的顺序,一层层验证,走到哪层断掉,问题就在哪层。

    先分清三种 bind 地址:127.0.0.1、0.0.0.0 与 ::

    容器内进程监听哪个地址,直接决定了端口映射能不能把流量送进去。如果应用只监听 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 即可,后者默认等价于监听所有地址。

    再看端口映射顺序与 iptables 链到底写了什么

    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