如何为单个或所有Docker容器修改DNS并永久生效？

在使用 Docker 的过程中，网络问题是最常见的挑战之一，其中域名解析（DNS）故障尤为突出，当容器内的应用无法访问外部服务、ping 域名返回 bad address 或解析速度异常缓慢时，通常都与 DNS 配置不当有关，Docker 默认会继承宿主机的 DNS 配置，但在复杂的网络环境或企业内网中，这种默认行为往往不能满足需求，掌握如何灵活、正确地修改 Docker 的 DNS 设置，是每一位 Docker 用户必备的技能，本文将系统地介绍在不同层面修改 Docker DNS 的方法，并探讨其背后的原理与最佳实践。

理解 Docker 的 DNS 解析机制

在深入修改之前,我们首先需要理解 Docker 是如何处理 DNS 请求的，默认情况下，Docker 守护进程为容器提供一个内嵌的 DNS 服务器（地址为 0.0.11），当容器尝试解析一个域名时，请求会首先发送到这个内嵌服务器，该服务器的解析逻辑如下：

1. 检查容器内的 /etc/hosts 文件：如果域名在此文件中有映射，则直接返回对应的 IP 地址。
2. 检查容器是否使用了自定义的 DNS 服务器：如果通过 docker run --dns 或 docker-compose.yml 指定了 DNS 服务器，则将请求转发给这些服务器。
3. 使用宿主机的 DNS 配置：如果以上两者均未配置，Docker 守护进程会从宿主机的 /etc/resolv.conf 文件中读取 DNS 服务器地址，并将其作为容器的上游 DNS。

理解这个流程有助于我们诊断问题,如果宿主机位于一个需要特定 DNS 才能解析内网域名的环境中，而容器却无法解析这些域名，很可能是因为 Docker 没有正确继承或使用了错误的 DNS 配置。

修改 DNS 的三种核心方法

根据作用范围和持久性的不同,修改 Docker DNS 的方法可以分为三个层级：容器级别、服务级别和守护进程级别。

容器级别修改（临时生效）

这是最直接、最快速的方法，适用于临时测试或一次性任务，在启动容器时，通过 --dns 参数指定一个或多个 DNS 服务器地址。

docker run --rm -it --dns=8.8.8.8 --dns=114.114.114.114 alpine sh

进入容器后,可以通过查看 /etc/resolv.conf 文件来验证设置：

# 在容器内执行
cat /etc/resolv.conf

将会是：

nameserver 8.8.8.8
nameserver 114.114.114.114

优点：简单快捷，立即生效。
缺点：仅对当前启动的容器有效，容器删除后配置即消失，不具备持久性。

Docker Compose 服务级别修改（推荐）

对于使用 Docker Compose 管理的多容器应用，在 docker-compose.yml 文件中为特定服务配置 DNS 是最佳实践，这种方式将配置与代码一同管理，实现了环境的一致性和可移植性。

在 docker-compose.yml 文件中，为需要自定义 DNS 的服务添加 dns 配置项：

version: '3.8'
services:
  web_app:
    image: nginx:alpine
    ports:
      - "8080:80"
    dns:                    # 为 web_app 服务配置 DNS
      - 8.8.8.8
      - 1.1.1.1
  db_service:
    image: mysql:5.7
    # db_service 未配置 dns，将使用默认或守护进程级别的配置

使用 docker-compose up -d 启动服务后，web_app 容器内的 /etc/resolv.conf 将自动包含指定的 DNS 服务器，而 db_service 则不受影响。

优点：配置持久化，与项目代码绑定，针对性强，是开发和测试环境的首选。
缺点：仅对 Docker Compose 管理的服务生效。

守护进程级别修改（全局生效）

当希望所有新创建的容器默认都使用特定的 DNS 服务器时，就需要在 Docker 守护进程的级别进行配置，这是影响范围最广、最为根本的设置方法。

这需要编辑 Docker 的配置文件，在 Linux 系统上，该文件通常位于 /etc/docker/daemon.json，如果该文件不存在，则需要手动创建。

1. 创建或编辑 daemon.json 文件：

   sudo nano /etc/docker/daemon.json

2. 添加 DNS 配置：

   在文件中写入以下 JSON 格式的内容，可以指定多个 DNS 服务器作为备用。

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

3. 重启 Docker 守护进程：

   这是最关键的一步，修改配置文件后必须重启 Docker 服务才能使其生效。

   sudo systemctl restart docker

4. 验证配置：

   之后,任何新创建的容器（未通过 --dns 或 Compose 指定）都会自动使用这里配置的 DNS 服务器。

   

优点：全局生效，一劳永逸，确保所有容器的 DNS 行为统一。
缺点：影响范围大，需要重启 Docker 服务，可能会对正在运行的其他容器造成短暂中断。

配置方法对比

为了更清晰地选择合适的方案,下表对三种方法进行了小编总结对比：

高级配置与注意事项

除了基本的 dns 配置，Docker 还提供了 dns-search 和 dns-opts 选项，用于更精细的控制。

• dns-search：用于设置域名搜索列表，当尝试解析一个不含点（如 database）的域名时，DNS 解析器会自动尝试附加搜索列表中的后缀（如 mycompany.com），变成 database.mycompany.com。
• dns-opts：允许传递任意选项给上游 DNS 解析器，例如设置超时时间 timeout:2 或启用 EDNS0 等。

优先级说明：如果在不同层级同时设置了 DNS，它们的优先级顺序为：容器级别 > 服务级别 > 守护进程级别，也就是说，更具体的设置会覆盖更通用的设置，即使 daemon.json 中配置了 114.114.114，但启动容器时使用了 --dns=8.8.8.8，那么该容器最终会使用 8.8.8。

相关问答 (FAQs)

问1：我已经按照说明修改了 /etc/docker/daemon.json 文件，为什么新创建的容器内的 DNS 设置仍然没有更新？

答： 这是最常见的一个疏忽，修改 daemon.json 文件后，其配置并不会立即被 Docker 守护进程加载，您必须重启 Docker 服务才能使新的全局配置生效，请执行以下命令：
sudo systemctl restart docker
重启后，所有新创建的容器都会采用 daemon.json 中定义的 DNS 设置，您可以通过启动一个新容器并检查其 /etc/resolv.conf 文件来验证。

问2：如果我在 Docker Compose 文件中为服务设置了 DNS，同时在宿主机的 daemon.json 中也设置了 DNS，哪一个会生效？

答： 在这种情况下，Docker Compose 中为服务定义的 DNS 设置具有更高的优先级，Docker 的配置遵循一个覆盖层级：容器启动参数 (--dns) > Docker Compose 服务配置 (dns) > Docker 守护进程全局配置 (daemon.json)，对于您的问题，该服务容器将使用 docker-compose.yml 文件中指定的 DNS 服务器，而忽略 daemon.json 中的全局设置，这种设计允许在全局默认配置的基础上，为特定应用提供灵活的定制化网络配置。