首页/云/Docker 容器速查/容器内域名解析失败排查
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条Compose 编排55 条资源与安全50 条
容器排障52 条

容器内域名解析失败排查

Temporary failure in name resolution 类报错的排查链:容器 resolv.conf → --dns 显式指定 → daemon 级 DNS 配置 → 自定义网络的内嵌 DNS(127.0.0.11)。

Docker 容器速查云更新于 2026-10-12
步骤一cat /etc/resolv.conf 看实际 DNS
步骤二--dns 指定公共 DNS 复测
背景自定义网络由内置 DNS 解析服务名

示例

示例
docker exec web cat /etc/resolv.conf
docker run --rm --dns 223.5.5.5 alpine nslookup example.com
docker run --rm alpine cat /etc/resolv.conf
宿主改 resolv.conf 后已创建的容器不会自动更新,重建容器或改 daemon 配置。

易错点

  • 公司内网域名要配内部 DNS:公共 DNS 解析不出来属正常,别误判容器网络故障
  • 网络工具的 nslookup/dig 有 DNS 旁路行为,测试解析更准的是 getent hosts

数据来源与参考

  • Docker 官方文档:Container DNS 与自定义网络(docs.docker.com/network)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌