docker问题排查

解决 Docker "context deadline exceeded" 错误

这个错误表明 Docker 无法从 Docker Hub (registry-1.docker.io) 拉取镜像，主要原因是网络连接问题。以下是详细的解决方案：

主要原因

1. 网络连接不稳定或被限制
2. DNS 解析问题
3. 防火墙/代理设置阻止连接
4. Docker Hub 服务不可用（虽然你无法访问状态页面）

解决方案

1. 检查基础网络连接

# 测试是否能ping通Docker Hub
ping registry-1.docker.io# 测试端口443(HTTPS)是否可达
telnet registry-1.docker.io 443

2. 更换DNS服务器（推荐）

1. 打开"网络和共享中心" → "更改适配器设置"
2. 右键当前网络 → 属性 → IPv4 → 使用以下DNS服务器：
   • 首选：8.8.8.8 (Google DNS)
   • 备用：114.114.114.114 (国内DNS)
3. 执行 ipconfig /flushdns 刷新DNS缓存

3. 配置Docker国内镜像加速器（针对中国用户）

1. 右键Docker托盘图标 → Settings → Docker Engine
2. 添加以下配置（以阿里云为例）：

{"registry-mirrors": ["https://<你的ID>.mirror.aliyuncs.com","https://hub-mirror.c.163.com"]
}

1. 点击"Apply & Restart"

4. 调整Docker超时设置

# 临时设置环境变量（CMD中执行）
set DOCKER_CLIENT_TIMEOUT=300
set COMPOSE_HTTP_TIMEOUT=300

5. 检查代理设置

如果你使用代理：

# 设置HTTP_PROXY环境变量
set HTTP_PROXY=http://proxy.example.com:8080
set HTTPS_PROXY=http://proxy.example.com:8080

6. 尝试其他基础镜像

docker run --rm busybox echo "测试连接"

7. 完全重置Docker网络

1. 退出Docker Desktop
2. 删除网络配置文件：
   • 删除 C:\ProgramData\Docker\network\files
3. 重新启动Docker

如果问题依旧，可能是企业/校园网络限制了Docker Hub访问，建议：

1. 尝试切换网络（如手机热点）
2. 联系网络管理员开放 registry-1.docker.io 的访问
3. 考虑使用离线安装方式获取镜像

Ping 请求找不到主机 registry-1.dokcer.io。请检查该名称，然后重试。 

这个错误表明你的系统无法解析 registry-1.docker.io 的域名，这是 Docker 拉取镜像的核心问题。以下是详细的解决方案：

---

​​1. 检查并修复 DNS 问题（最可能的原因）​​

▶ ​​手动修改 DNS 服务器​​

1. 打开 ​​控制面板 > 网络和共享中心 > 更改适配器设置​​
2. 右键你的网络连接（Wi-Fi/以太网）→ ​​属性​​ → 选择 ​​IPv4​​ → ​​属性​​
3. 修改 DNS 服务器为：
   • ​​首选 DNS：8.8.8.8​​（Google DNS）
   • ​​备用 DNS：114.114.114.114​​（国内公共 DNS）
4. 点击 ​​确定​​ 保存，然后执行以下命令刷新 DNS 缓存：

   ipconfig /flushdns

▶ ​​测试 DNS 解析是否正常​​

在 CMD 中运行：

nslookup registry-1.docker.io 8.8.8.8

• 如果返回 IP 地址（如 52.22.181.254），说明 DNS 已修复。
• 如果仍然报错，可能是网络代理或防火墙拦截。

---

​​2. 检查网络代理和防火墙​​

▶ ​​临时关闭防火墙/杀毒软件​​

• 关闭 Windows Defender 防火墙或第三方安全软件（如 360、火绒等）。
• 重新尝试 ping registry-1.docker.io。

▶ ​​检查代理设置​​

如果你使用 VPN 或公司网络代理：

1. 在 CMD 中运行：

   netsh winhttp show proxy

   • 如果显示代理，尝试关闭代理：

     netsh winhttp reset proxy

2. 或者在 Docker Desktop 设置中配置代理：
   • ​​Settings > Resources > Proxies​​ → 填写正确的代理地址。

---

​​3. 直接使用 IP 测试（绕过 DNS 问题）​​

如果 ping registry-1.docker.io 失败，但手动解析 IP 成功，可以尝试：

ping 52.22.181.254

• 如果能 ping 通，说明是 ​​DNS 解析问题​​（按 ​​步骤1​​ 修复）。
• 如果 ping 不通，可能是 ​​网络被阻断​​（尝试切换网络，如手机热点）。

---

​​4. 使用国内镜像加速器（推荐中国用户）​​

由于 Docker Hub 在国外，国内访问可能较慢或被干扰。配置镜像加速器：

1. ​​右键 Docker 托盘图标 → Settings → Docker Engine​​
2. 添加以下镜像（如阿里云、网易）：

   {"registry-mirrors": ["https://<你的ID>.mirror.aliyuncs.com",  // 阿里云（需注册）"https://hub-mirror.c.163.com"          // 网易]
   }

3. 点击 ​​Apply & Restart​​ 重启 Docker。

---

​​5. 终极解决方案​​

如果以上方法均无效：

1. ​​完全重置 Docker 网络​​：
   • 退出 Docker Desktop → 删除 C:\ProgramData\Docker 目录 → 重新启动 Docker。
2. ​​更换网络环境​​：
   • 尝试连接手机热点或其他网络。
3. ​​联系网络管理员​​：
   • 企业/校园网络可能屏蔽了 Docker Hub，需开放访问。

---

​​测试是否修复​​

运行以下命令验证：

docker run --rm hello-world

 

C:\Users\ZW>nslookup registry-1.docker.io 8.8.8.8
服务器:  dns.google
Address:  8.8.8.8

非权威应答:
名称:    registry-1.docker.io
Addresses:  2a03:2880:f107:83:face:b00c:0:25de
          31.13.94.41

 

从你的 nslookup 结果来看，DNS 解析是成功的，但 Docker 仍然无法连接。这表明问题可能出在 ​​网络连接、防火墙或 Docker 配置​​ 上。以下是针对性的解决方案：

---

​​1. 检查 IPv4/IPv6 问题​​

你的 DNS 返回了 IPv6 地址（2a03:2880...）和 IPv4 地址（31.13.94.41），但某些网络可能不支持 IPv6。
​​解决方法​​：

• ​​禁用 IPv6​​（临时测试）：
  1. 打开 控制面板 > 网络和共享中心 > 更改适配器设置。
  2. 右键当前网络 → ​​属性​​ → 取消勾选 ​​Internet 协议版本 6 (TCP/IPv6)​​ → 确定。
  3. 重启 Docker 并重试。

---

​​2. 直接通过 IP 测试连接​​

手动使用解析到的 IPv4 地址测试：

telnet 31.13.94.41 443

• 如果连接成功，说明网络可达，问题在 Docker 配置。
• 如果失败，可能是防火墙/代理拦截（见下一步）。

---

​​3. 检查防火墙和代理​​

▶ ​​临时关闭防火墙​​

• 在 CMD 中以管理员身份运行：

  netsh advfirewall set allprofiles state off

• 测试 Docker 是否正常工作，完成后记得重新启用防火墙：

  netsh advfirewall set allprofiles state on

▶ ​​检查代理设置​​

• 运行以下命令查看系统代理：

  netsh winhttp show proxy

• 如果显示代理，尝试重置：

  netsh winhttp reset proxy

---

​​4. 强制 Docker 使用 IPv4​​

在 Docker 配置中明确禁用 IPv6：

1. 编辑 Docker 配置文件（C:\ProgramData\Docker\config\daemon.json，如不存在则新建）：

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

2. 重启 Docker Desktop。

---

​​5. 使用国内镜像加速器（推荐）​​

如果国际网络不稳定，配置国内镜像源：

1. 修改 daemon.json 文件：

   {"registry-mirrors": ["https://hub-mirror.c.163.com","https://mirror.baidubce.com"]
   }

2. 重启 Docker。

---

​​6. 终极排查​​

如果问题依旧，请提供以下信息：

1. 运行 docker version 和 docker info 的输出。
2. 测试其他镜像是否正常：

   docker pull alpine

3. 检查 Docker 服务日志：
   • 在 Windows 事件查看器中查看 ​​应用程序和服务日志 > Docker​​。

---

​​总结​​

• ​​已确认​​：DNS 解析正常（IPv4/IPv6 均返回）。
• ​​可能原因​​：IPv6 兼容性问题、防火墙拦截、Docker 配置错误。
• ​​建议步骤​​：
  1. 禁用 IPv6 测试 → 2. 配置国内镜像 → 3. 检查防火墙/代理。