Docker容器DNS解析失败怎么查?如何区分容器配置、宿主机与上游DNS问题

发布人:A5数据发布时间:2026-10-22 17:46阅读量:195

容器内访问域名失败,常见表现是 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 地址,则容器可能直接向这些地址查询。下一步是在宿主机验证对应解析器是否可用。

由外到内逐层排查:检查 Docker 转发和上游 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

相关推荐