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 查询行为，常见问题包括：
- 被 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，也建议显式声明）：
- 保存后重启服务：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 请求（可对比手机热点下是否正常）
