dns配置错误是docker拉取镜像超时的常见原因，需通过nslookup、dig、ping验证解析是否正常，检查并修复/etc/resolv.conf，显式配置/etc/docker/daemon.json中的dns字段，清空缓存并排除hosts干扰。

DNS 配置错误是 Docker 拉取镜像超时的常见原因，尤其在首次安装或网络环境变更后。排查关键在于验证域名能否正确解析为 IP，且解析过程不延迟、不失败。

确认系统 DNS 是否生效

执行以下命令检查当前 DNS 设置是否能解析 Docker Hub 域名：

• nslookup registry-1.docker.io —— 查看是否返回有效 IPv4 地址（如 152.199.20.162）
• dig registry-1.docker.io +short —— 更简洁地输出解析结果，避免冗余信息
• ping -c 3 registry-1.docker.io —— 若 ping 不通但 nslookup 成功，说明 DNS 正常但网络连通性差；若 nslookup 失败，则基本锁定 DNS 问题

检查 /etc/resolv.conf 内容

该文件控制系统的 DNS 查询行为，常见问题包括：

Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

• 被 NetworkManager 或 DHCP 覆盖，内容为空或含无效地址（如 127.0.0.53）
• 运营商 DNS 存在污染或响应慢（实测中部分本地 DNS 解析耗时超 300ms）
• IPv6 DNS 优先但实际不可用，导致阻塞等待

临时修复可写入公共 DNS：

sudo sh -c 'echo "nameserver 8.8.8.8" > /etc/resolv.conf'

验证 Docker 自身 DNS 配置

Docker 守护进程可能忽略系统 DNS，需单独配置：

• 编辑 /etc/docker/daemon.json，添加 DNS 设置（即使已配系统 DNS，也建议显式声明）：

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

• 保存后重启服务：sudo systemctl restart docker
• 运行 docker info | grep -i dns 确认配置已加载

排除缓存与干扰因素

DNS 缓存或本地 hosts 干预可能导致异常：

• 清空 systemd-resolved 缓存：sudo systemd-resolve --flush-caches（适用于 Ubuntu/CentOS 8+）
• 检查 /etc/hosts 是否有错误条目（如将 registry-1.docker.io 映射到 127.0.0.1）
• 若使用代理或企业防火墙，确认其未劫持 DNS 请求（可对比手机热点下是否正常）