Docker容器DNS解析异常:127.0.0.11与自定义网络排查

    发布时间:2026-09-28 12:31 更新时间:2026-09-28 12:31 阅读量:16

    很多站长在容器里遇到过这种怪事:从宿主机能正常 curl 的外部域名,进到容器里就报 Could not resolve host;更迷惑的是,装好 dig 想查一下,敲完 dig example.com 却什么输出都没有,卡几秒直接退出。这类问题八成不是网络不通,而是容器里的 DNS 走了另一套机制。本文把 Docker 自定义网络下的解析顺序、127.0.0.11 的真实身份、以及 dns 配置的优先级讲清楚,最后给出一套可照做的排查步骤。

    先认清 127.0.0.11:它不是你的 DNS 服务器

    在默认 bridge 网络下,容器如果拿不到宿主机的 DNS 配置,Docker 会把宿主机的 /etc/resolv.conf 内容复制进容器,此时容器里的 nameserver 通常是真实 DNS 地址。但只要你用 docker network create 建了自定义网络(Compose 默认就会建),容器起来后 /etc/resolv.conf 里大概率只有一行:

    nameserver 127.0.0.11
    options ndots:0

    127.0.0.11 是 Docker 在每个容器网络命名空间里注入的嵌入式 DNS 解析器,它监听在回环地址上,只有容器自己能看到。所有容器的域名查询会先到它这里,由它决定是自己回答,还是转发给上游 DNS。

    它自己回答的部分,就是自定义网络里的服务名/容器名解析:同一个 network 下的容器,可以用服务名互相访问,Docker 会返回对应容器的 IP。这部分流量根本不会出宿主机,所以你在宿主机上抓包看不到,在容器里 dig 一个外部域名时也可能因为链路不同而表现诡异。

    要验证容器当前用的是谁,最直接的办法是进容器看配置,再分别测内外部域名:

    docker exec -it web cat /etc/resolv.conf
    docker exec -it web getent hosts db          # 同网络服务名,应由 127.0.0.11 回答
    docker exec -it web getent hosts example.com # 外部域名,需要转发上游

    如果第一条能解析、第二条失败,问题基本锁定在嵌入式 DNS 向上游转发这一环,而不是容器网络本身。

    解析顺序与 dns 配置优先级

    容器内一次域名查询的完整顺序,可以按下面这条链路理解:应用调用 glibc/musl 的解析器,读取 /etc/resolv.conf,按 nameserver 顺序尝试;自定义网络下第一个就是 127.0.0.11;嵌入式 DNS 先查内置的服务发现记录,未命中再按 Docker 的配置转发给上游。

    上游 DNS 从哪来,优先级大致是:docker run 的 --dns 参数 > 自定义网络创建时的 --dns(部分版本支持) > 守护进程 daemon.json 里的 dns 配置 > 宿主机 /etc/resolv.conf。其中 daemon.json 的配置会覆盖宿主机 resolv.conf,这一点常被忽略。修改 daemon.json 后需要重载或重启 Docker 才生效,具体行为以官方文档和你的 Docker 版本为准。

    一个常见坑是:宿主机用 systemd-resolved,/etc/resolv.conf 指向 127.0.0.53。这个地址在宿主机有效,但被复制进容器后,容器里的 127.0.0.53 是它自己的回环,指向不到宿主机的解析服务,于是外部域名全部解析失败。解决办法是显式给 Docker 指定一个可达的上游 DNS:

    # 方式一:单次运行指定
    docker run -d --name web --dns 223.5.5.5 --dns 119.29.29.29 nginx
    
    

    方式二:写入 /etc/docker/daemon.json 后重载

    { "dns": ["223.5.5.5", "119.29.29.29"] } systemctl reload docker # 或 systemctl restart docker,以实际环境为准

    另外注意 options ndots:0:它表示域名里只要有一个点就按绝对域名查询,避免先拼接 search 域再查一遍,能减少无谓的解析延迟。Compose 场景下还可以用 dns: 和 dns_search: 字段覆盖,优先级同样高于宿主机配置。

    dig 没输出、解析失败怎么一步步查

    dig 在容器里没输出,通常有两类原因:一是镜像来自精简基础镜像(如 alpine),压根没装 dig,命令直接 command not found,但你只看到一片安静;二是 dig 查询发给了 127.0.0.11,而嵌入式 DNS 对某些查询类型或超时处理不返回内容,进程静默退出。排查时不要只盯 dig,先用系统自带工具确认链路哪一段断了。

    推荐顺序如下,每步都有明确的判断依据:

    # 1. 确认容器内解析顺序与上游
    docker exec -it web cat /etc/resolv.conf
    
    

    2. 用不依赖 DNS 的方式确认网络可达(换成一个真实 IP 测试)

    docker exec -it web ping -c1 223.5.5.5

    3. 直接向嵌入式 DNS 查询,看它是否响应

    docker exec -it web nslookup example.com 127.0.0.11

    4. 做一次解析过程追踪,看请求停在哪一步

    docker exec -it web getent hosts example.com

    5. 在宿主机抓容器网卡上的 53 端口流量(网卡名以实际为准)

    tcpdump -i docker0 -n port 53

    判读思路是:第 2 步不通说明容器出网就有问题,先去查路由、NAT、防火墙;第 2 步通、第 3 步没响应,说明嵌入式 DNS 到上游的转发被拦或上游不可达,重点看 daemon.json/host 的 DNS 是否写成了容器内不可达的地址;第 3 步能解析、应用却报错,多半是应用用了自己的 DNS 库(部分语言运行时绕过 resolv.conf 或做了缓存),需要看应用侧配置或重启容器清缓存。

    还有一个容易被忽略的方向:如果容器同时加入了多个自定义网络,服务名解析可能命中的是另一个网络的记录,出现「解析到错误 IP」的现象。此时用 docker inspect 容器名 看 Networks 字段,确认目标服务名属于哪个网络,必要时用全限定名或在同一网络内通信。

    小结一下:容器 DNS 出问题,先分清是「内置服务发现」还是「向上游转发」两条路。看到 127.0.0.11 不要慌,它是 Docker 的嵌入式解析器;外部域名解析失败时,优先检查上游 DNS 是否被写成容器内不可达的回环地址,再用 getent、nslookup 指定 127.0.0.11 逐段验证,最后才上 tcpdump。把这套顺序固定下来,下次遇到 dig 静默退出,几分钟就能定位到具体环节。

    继续阅读

    📑 📅
    Redis内存碎片率异常:used_memory与RSS差在哪 2026-09-28
    MySQL 8 临时表爆满排查:内存临时表与磁盘落盘定位 2026-09-28
    Nginx 缓存代理写满磁盘:max_size 与缓存目录清理实战 2026-09-28
    Linux TCP backlog 溢出排查:ss -lnt 的 Send-Q 怎么看 2026-09-28
    Docker 容器内 cron 与宿主 crontab 取舍:重复执行与时区错乱排查 2026-09-28
    Linux SYN_RECV 堆积排查:半连接队列与 tcp_syncookies 2026-09-29
    Nginx 长连接被中间设备掐断排查:从抓包 RST 到 keepalive_timeout 调优 2026-09-29
    Docker 容器内 curl 通但宿主不通:端口映射与 iptables 排查 2026-09-29
    MySQL慢查询Rows_examined远大于Rows_sent:回表与覆盖索引优化 2026-09-29
    PostgreSQL备库查询被长事务阻塞排查与配置取舍 2026-09-29