问题现象

在Docker容器内运行应用时，经常遇到域名解析失败的情况，例如无法通过域名访问外部服务，或者容器间无法通过服务名互相通信。典型错误包括ping: unknown host或Connection refused，即使宿主机网络正常，容器内仍无法解析。

原因分析

Docker容器默认使用宿主机的DNS配置，但容器内/etc/resolv.conf的生成逻辑受到多个因素影响。默认情况下，Docker会使用宿主机上的配置，但若宿主机使用systemd-resolved，或容器网络模式、DNS配置不当时，就会导致容器内无法正确解析域名。此外，容器重启、网络重建也可能会重置DNS配置。

解决方案

方法一：启动容器时指定DNS

使用--dns参数直接指定DNS服务器，适用于一次性启动容器的情况。

docker run --dns 8.8.8.8 --dns 114.114.114.114 -it nginx:alpine

可指定多个DNS，容器启动后，会优先使用这些服务器进行解析。

方法二：使用docker-compose配置DNS

在编写docker-compose.yml时，通过dns字段配置DNS，例如：

services:
  web:
    image: nginx
    dns:
      - 8.8.8.8
      - 114.114.114.114

该方式便于管理，适合多容器应用。

方法三：修改Docker守护进程全局配置

通过修改/etc/docker/daemon.json文件，为所有容器设置默认DNS。在文件中添加：

{
  "dns": ["8.8.8.8", "114.114.114.114"]
}

修改后需要重启Docker服务：systemctl restart docker。该方法对所有新创建的容器生效，但需注意，如果容器已指定DNS，则默认配置不会覆盖。

方法四：自定义Docker网络并设置DNS

创建自定义网络时，可以指定DNS参数：

docker network create --driver bridge --dns 8.8.8.8 mynet

启动容器时，将容器加入该网络：

docker run --network mynet --dns 8.8.8.8 -it nginx:alpine

自定义网络通常支持更灵活的DNS设置，也便于容器间的服务发现。

方法五：使用dnsmasq本地缓存DNS

对于复杂环境，可在宿主机运行dnsmasq，将容器DNS指向宿主机IP。这样可以统一管理DNS缓存和转发策略，减少外部DNS依赖。

验证DNS配置

检查容器内的DNS配置是否正确：

docker exec <容器ID> cat /etc/resolv.conf

也可以在容器内执行域名解析测试：

docker exec <容器ID> nslookup example.com

如果解析成功，说明配置生效；若仍失败，可进入容器检查网络配置，或尝试重启容器。

最佳实践建议

• 生产环境推荐使用docker-compose或daemon.json统一配置DNS，便于维护。
• 避免在容器内手动修改/etc/resolv.conf，因为容器重启后会被重置。
• 如果确定需要固定DNS，建议在部署脚本或编排配置中显式声明。
• 使用自定义网络时，注意与宿主机DNS的协调，防止出现解析冲突。
• 定期检查Docker日志，关注DNS相关错误，及时调整配置。

总结

Docker容器内域名解析失败通常由DNS配置不当引起，通过合理的自定义DNS设置，可以快速解决问题。根据实际场景选择启动参数、Compose配置或全局配置等方式，能够有效提升容器的网络健壮性，让业务运行更加稳定。