Docker 28.0版本DNS解析问题分析与解决方案

在Docker 28.0版本发布后，部分用户在升级后发现容器内无法进行DNS解析的问题。本文将深入分析这一问题的成因，并提供多种解决方案。

问题现象

用户升级到Docker 28.0后，容器内执行ping命令时出现"bad address"错误，表明DNS解析失败。典型表现为：

• 容器内无法解析域名（如google.com）
• 直接ping IP地址可以成功
• 影响所有容器和所有网络

根本原因

Docker 28.0版本对DNS处理机制进行了重要变更。在之前的版本中，当宿主机缺少/etc/resolv.conf文件时，Docker会默认使用Google的公共DNS服务器（8.8.8.8和8.8.4.4）作为后备方案。但在28.0版本中，这一后备机制被移除，导致在以下情况下会出现DNS解析问题：

1. 宿主机缺少有效的/etc/resolv.conf文件
2. 使用systemd-resolved但未正确配置
3. 使用其他DNS服务（如Pi-hole）但未正确设置

解决方案

方案一：修复宿主机DNS配置

对于使用systemd-resolved的系统：

sudo ln -sf ../run/systemd/resolve/stub-resolv.conf /etc/resolv.conf

如果同时使用Pi-hole等本地DNS服务，需要按照以下步骤配置：

1. 重新启用systemd-resolved
2. 仅禁用stub解析器
3. 确保Pi-hole容器正确配置

方案二：配置Docker守护进程DNS

编辑Docker守护进程配置（通常在/etc/docker/daemon.json），添加：

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

或直接在dockerd命令行添加参数：

--dns 8.8.8.8 --dns 8.8.4.4

方案三：为单个容器指定DNS

在docker-compose文件中为特定服务添加DNS配置：

services:
  myservice:
    dns:
      - 8.8.8.8
      - 8.8.4.4

或者为整个网络设置DNS：

networks:
  mynetwork:
    driver: bridge
    driver_opts:
      com.docker.network.driver.mtu: "1500"
    ipam:
      config:
        - subnet: 172.20.0.0/16
          gateway: 172.20.0.1
          aux_addresses:
            dns: 172.20.0.2

最佳实践建议

1. 对于生产环境，建议使用方案一，确保宿主机有正确的DNS配置
2. 临时解决方案可以使用方案二或方案三
3. 使用本地DNS服务（如Pi-hole）时，务必按照官方文档进行完整配置
4. 定期检查DNS解析是否正常，特别是在Docker升级后

总结

Docker 28.0版本的这一变更虽然提高了安全性，但也带来了配置上的新要求。理解这一变更背后的原理，可以帮助我们更好地维护容器环境的网络功能。建议所有升级到28.0版本的用户检查自己的DNS配置，确保容器网络功能正常。