Docker容器DNS解析失败怎么查?如何区分容器配置、宿主机与上游DNS问题
容器内访问域名失败,常见表现是 ping 或应用报“Name or service not known”,但访问同一服务的 IP 地址正常;也可能是宿主机能解析,容器却超时,或者只有加入某个 Docker 网络的容器出现问题。排查时先确认失败的是 DNS 解析,而不是容器网络、目标端口或应用自身,再沿着“容器实际使用的解析配置—Docker 网络与转发—宿主机解析器—上游 DNS”逐层定位。

Docker DNS 的处理方式与网络模式有关:自定义网络中的容器通常通过 Docker 内置 DNS 127.0.0.11 查询;默认 bridge 等场景则可能直接使用容器的 resolv.conf 中列出的解析器。127.0.0.11 是容器内部地址,不应直接配置成宿主机的 DNS。以下命令以 Linux 上使用 Docker Engine 的环境为例;Docker Desktop、rootless Docker 及不同网络模式的细节可能不同,应结合实际配置判断。
先确认故障范围
记录失败的域名、容器、Docker 网络和发生时间,并区分以下情况:
- 只有某个域名失败,还是所有外部域名都失败。
- 只有一个容器失败,还是同网络的多个容器都失败。
- 容器访问 IP 是否正常,宿主机解析同一域名是否正常。
- 故障是否在容器重建、网络变更、宿主机 DNS 更新或网络切换后出现。
如果应用访问 IP 也失败,先不要把问题归到 DNS:需要检查路由、网络隔离、防火墙、目标端口及应用监听状态。反过来,IP 可达但域名解析失败,才更适合按 DNS 路径排查。
由外到内逐层排查
1. 在容器内查看实际解析配置并发起查询
先检查发生故障的容器,而不是只查看宿主机配置:
docker exec <容器名或ID> cat /etc/resolv.conf
常见结果可能如下:
nameserver 127.0.0.11
options ndots:0
也可能是一个或多个实际 DNS 服务器地址。这里显示的是容器当前看到的配置,是重要证据,但不能单凭它判断上游 DNS 一定可用。
接着使用容器中已有的工具查询。getent 更接近许多应用通过系统名称解析库进行查询的方式;nslookup 或 dig 可用于直接观察 DNS 查询结果。

docker exec <容器名或ID> getent hosts example.com
docker exec <容器名或ID> nslookup example.com
如果容器没有这些工具,不必为了排错修改业务镜像。可使用本机已有的诊断镜像,但前提是镜像已经缓存,或环境允许拉取镜像:
docker run --rm --network <容器所在网络> busybox:1.36 nslookup example.com
这条命令测试的是新建诊断容器在指定网络中的解析能力,不完全等同于故障容器本身;若结果与业务容器不同,应回到业务容器检查网络、容器级 DNS 设置及其运行环境。
结果可这样判断:
- 返回 IP:该次查询成功。若应用仍报错,继续核对应用运行时、容器内缓存、域名拼写和应用使用的解析路径。
- 返回
NXDOMAIN:DNS 服务器已响应,但认为该名称不存在。检查域名、搜索域、记录是否存在,以及内外网 DNS 是否使用了不同视图。 - 超时或
SERVFAIL:可能是解析器不可达、上游故障、转发失败或 DNS 被网络策略拦截;继续测试宿主机和指定解析器。 getent与nslookup结果不同:检查/etc/nsswitch.conf、搜索域及应用使用的解析库。某些程序还会缓存结果或采用自身的解析设置。
2. 比较宿主机与容器的解析结果
在宿主机上查询同一个域名,尽量使用与容器相同的时间窗口:
getent hosts example.com
在启用 systemd-resolved 的 Linux 系统上,也可查询:
resolvectl query example.com
如果宿主机查询成功而容器失败,问题范围更可能在容器使用的 DNS 配置、Docker 网络或 Docker 的 DNS 转发路径。若两边都失败,应先检查宿主机配置和上游,不要急着改容器。
宿主机的 /etc/resolv.conf 可能是软链接,也可能由网络管理服务动态生成:
readlink -f /etc/resolv.conf
cat /etc/resolv.conf
如果文件中只有 127.0.0.53,通常表示宿主机通过本地 systemd-resolved stub 继续查询,并不代表上游 DNS 就是这个地址。容器与宿主机的网络命名空间不同,容器不能把宿主机上的环回地址当成可直接访问的解析器。还要检查 Docker 实际生成的容器配置,而不是只根据宿主机文件推断。
3. 核对网络模式和 Docker 网络
先查看容器使用的网络模式及已连接网络:
docker inspect <容器名或ID> --format '{{.HostConfig.NetworkMode}}'
docker inspect <容器名或ID> --format '{{json .NetworkSettings.Networks}}'
再检查对应网络:
docker network inspect <网络名>
重点确认容器是否连接到预期网络、网络是否仍存在,以及其他同网络容器是否也有相同故障。自定义网络中,容器常通过 Docker 内置 DNS 查询外部名称,并使用服务名发现同网络容器;默认 bridge、自定义 bridge 和 host 网络的解析路径并不完全相同。
若只有某个自定义网络中的容器失败,可用该网络启动诊断容器进行对照。如果诊断容器也失败,优先检查该网络、Docker DNS 转发及宿主机上游;如果诊断容器正常,则重点比较故障容器的网络连接、容器级 DNS 设置和 /etc/resolv.conf。
4. 查看容器级和 Compose DNS 设置
容器级配置可能覆盖 Docker 默认行为。检查创建容器时是否指定了 DNS:
docker inspect <容器名或ID> --format '{{json .HostConfig.Dns}}'
docker inspect <容器名或ID> --format '{{json .HostConfig.DnsSearch}}'
docker inspect <容器名或ID> --format '{{json .HostConfig.DnsOptions}}'
在 Compose 配置中,留意服务下的 dns、dns_search 和 dns_opt,以及网络设置是否与预期一致。修改 Compose 文件后,已有容器不会仅因文件变化自动采用新配置,需按维护流程重建相关服务容器。
搜索域和 ndots 也可能造成“短名称”查询行为与预期不同。例如,容器访问 db 时,解析器可能会按搜索域依次尝试多个名称;访问带点的域名时,查询顺序也可能受 ndots 影响。这类问题常表现为短名称失败、查询延迟或访问到非预期记录。先用完整域名测试,再核对搜索域与应用配置,避免把搜索域问题误判为上游宕机。
5. 检查 Docker 转发和上游 DNS
如果容器配置显示 127.0.0.11,容器通过 Docker 内置 DNS 处理查询;若显示实际 DNS 地址,则容器可能直接向这些地址查询。下一步是在宿主机验证对应解析器是否可用。

有 dig 时,可指定解析器测试:
dig @<DNS服务器地址> example.com A +time=2 +tries=1
正常情况下应收到 DNS 响应;若超时,检查宿主机到该 DNS 的路由、防火墙和网络策略。若返回 NXDOMAIN 或 SERVFAIL,则请求已到达解析器,但名称解析或解析器转发仍有问题。使用该命令前,先确认地址来自可信、适用于当前网络的 DNS 配置;不要随意把公共 DNS 写入生产环境,内网域名可能只由企业解析器提供。
可用以下命令辅助检查路由:
ip route get <DNS服务器地址>
该结果显示宿主机访问目标地址时选择的路由和出口接口,不代表容器内的路由或 DNS 端口一定畅通。若宿主机能查询上游而容器不能,继续检查 Docker 网络、防火墙规则及主机的转发策略;不要直接清空防火墙规则作为测试,这可能影响其他业务。
按结果确定故障位置
| 观测结果 | 优先检查位置 | 下一步验证 |
|---|---|---|
| 宿主机和容器都无法解析 | 宿主机解析器、上游 DNS、网络出口 | 查询宿主机当前解析器,并指定该解析器执行 dig |
| 宿主机正常,多个 Docker 网络中的容器都失败 | Docker DNS 转发、宿主机网络或防火墙 | 对比容器 /etc/resolv.conf,在不同网络启动诊断容器 |
| 只有一个 Docker 网络中的容器失败 | 该网络的配置、连接和转发路径 | 检查 docker network inspect,用同网络诊断容器对照 |
| 只有一个业务容器失败 | 容器级 DNS、网络连接、镜像内解析配置或应用行为 | 对比同网络容器,并检查 Compose 与 docker inspect |
| 只有内网域名失败 | 搜索域、企业 DNS、分流解析或记录 | 使用完整域名,并向指定内网 DNS 查询 |
| DNS 查询成功,但应用仍失败 | 应用缓存、名称格式、连接配置或目标服务 | 在容器内检查解析结果,再独立验证目标 IP 和端口 |
注意:能解析域名只说明 DNS 查询成功,不代表目标服务可达。解析到 IP 后,还应按业务协议检查端口和服务状态,避免将连接拒绝、超时或证书问题归为 DNS 故障。
修复时先做最小范围变更
若确认是容器 DNS 配置不正确,优先在单个服务或容器范围修正,并使用该业务环境认可的解析器。例如 Compose 服务配置可写为:
services:
app:
image: example/app:latest
dns:
- 192.0.2.53
dns_search:
- internal.example
示例中的 192.0.2.53 是文档示例地址,不可直接当作可用解析器。应替换为当前网络中实际可达、且能解析所需内外网域名的 DNS 地址。仅在确实需要搜索域时配置 dns_search,避免短名称被扩展到错误的域。
也可通过 docker run --dns <地址> 为单个容器指定解析器。改动后,已有容器通常需要重新创建才能采用新设置;先保存原有 Compose 文件或启动参数,按业务维护流程只重建受影响服务,并确认其卷、环境变量和网络配置没有遗漏。若结果变差,恢复原配置并重新创建该服务。
只有确认多个容器都受到 Docker 默认 DNS 配置影响,且有经过验证的上游地址时,才考虑调整 Docker daemon 的 DNS 配置。Linux Docker Engine 常见配置文件为 /etc/docker/daemon.json,但修改前应先备份并检查 JSON 格式及现有配置:
sudo cp -a /etc/docker/daemon.json /etc/docker/daemon.json.bak
sudo cat /etc/docker/daemon.json
配置示例:
{
"dns": ["192.0.2.53"]
}
不要直接用示例内容覆盖已有文件;应合并现有配置,并确保文件仍为合法 JSON。重启 Docker daemon 可能影响该主机上的容器,尤其是未配置自动重启的服务。变更前应确认维护窗口、容器恢复方式和回滚步骤。若需要应用 daemon 配置,先使用适用于当前系统的配置校验方式;无法确认服务管理方式时,先检查:
docker info
systemctl status docker
Linux 系统若由 systemd 管理 Docker,可在获批的维护窗口重启服务;如解析故障加重,恢复备份配置并重新加载服务。不要为了修复 DNS 而随意编辑 Docker 自动生成的容器 resolv.conf,该文件可能在容器重建时被重新生成,手工改动也容易掩盖真实配置来源。
修复后复测并持续观察
变更后至少验证三项:容器内 /etc/resolv.conf 是否符合预期;故障域名和一个正常外部域名是否均能解析;应用是否能通过解析得到的地址完成实际连接。内网服务还应测试其完整域名和服务名,确认搜索域没有造成误解析。
可保存一组简短的复测记录,包括容器名、网络、查询域名、返回结果和时间。若 DNS 间歇性失败,观察一段覆盖业务高峰的时间,并对比失败时段的解析超时、容器重建记录和宿主机上游查询结果。只有在复测结果稳定且业务连接恢复后,才关闭故障;若问题复发,这些记录能帮助区分容器配置漂移、宿主机解析器变化与上游 DNS 异常。
Docker容器及其承载的业务服务,需要稳定的服务器硬件与网络资源作为运行基础。A5数据(A5IDC)提供香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,涵盖不同CPU、内存、SSD或NVMe存储及网络线路配置,可用于部署容器应用、数据库和业务后台。多地区资源与不同网络方案,也为面向不同区域的业务部署提供了选择空间。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5172.html



