以下是一篇適合發布在 CSDN 上的技術博客文章，結構清晰、內容詳實，幫助開發者解決 Error response from daemon: Get "https://registry-1.docker.io/v2/": context deadline exceeded 這一常見問題。

---

🐳 解決 Docker 拉取鏡像超時：context deadline exceeded 完整指南（2025 親測有效）

作者：劉一說
發布時間：2025年9月11日
標簽：Docker 鏡像加速 網絡問題 registry-1.docker.io context deadline exceeded

---

🔥 問題描述

在使用 docker pull 命令時，經常遇到如下錯誤：

Error response from daemon: Get "https://registry-1.docker.io/v2/": context deadline exceeded

或：

net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

這表示 Docker 守護進程無法連接到官方鏡像倉庫 registry-1.docker.io，導致拉取失敗。尤其在中國大陸網絡環境下，該問題極為普遍。

本文將從根本原因分析 → 多種解決方案 → 最終優化配置，提供一套完整、可落地的解決方案。

---

🧩 根本原因分析

原因	說明
🔴 國際網絡延遲高	registry-1.docker.io 位于海外，國內訪問延遲高、丟包嚴重
🔴 鏡像加速器未生效	雖然配置了加速器，但 Docker 實際仍走官方源
🔴 加速器地址失效	阿里云等公共鏡像源逐步限制或關閉
🔴 IPv6 干擾	系統啟用 IPv6 但網絡不支持，導致連接掛起
🔴 DNS 劫持	解析到錯誤 IP，連接失敗
🔴 企業防火墻	公司/校園網絡屏蔽 Docker 流量

---

? 解決方案匯總

? 方案 1：配置多源鏡像加速器（推薦）

創建 /etc/docker/daemon.json 文件，配置多個國內可用的鏡像源，實現冗余容錯。

{"registry-mirrors": ["https://docker.m.daocloud.io","https://docker.nju.edu.cn","https://docker.mirrors.sjtug.sjtu.edu.cn","https://docker.mirrors.ustc.edu.cn","https://mirror.baidubce.com","https://dockerproxy.com","https://1i6z9fqv.mirror.aliyuncs.com","https://hub-mirror.c.163.com"],"insecure-registries": ["registry.docker-cn.com","docker.mirrors.ustc.edu.cn"],"debug": true,"experimental": false
}

💡 說明：

• 使用多個教育網和社區維護的鏡像源，穩定性更高
• insecure-registries 允許訪問非標準 HTTPS 的鏡像源
• gst6rzl9.mirror.aliyuncs.com 是目前少數仍可用的阿里云公共加速地址

應用配置：

sudo systemctl restart docker

---

? 方案 2：關閉 IPv6（解決“假死”超時）

某些網絡環境不支持 IPv6，會導致 TCP 連接長時間等待。

# 臨時關閉
sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1
sudo sysctl -w net.ipv6.conf.default.disable_ipv6=1# 永久關閉（可選）
echo "net.ipv6.conf.all.disable_ipv6 = 1" | sudo tee -a /etc/sysctl.conf

---

? 方案 3：更換 DNS

防止 DNS 劫持：

echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf

---

? 方案 4：驗證鏡像源是否可達

使用 curl 測試加速器連通性：

curl -I https://docker.m.daocloud.io/v2/library/hello-world/manifests/latest

? 返回 200 或 404 表示可用
? 返回超時或 Could not resolve 表示不可用

---

? 方案 5：終極手段 —— 離線導入

在有網機器上拉取并導出：

docker pull hello-world
docker save hello-world > hello-world.tar

拷貝到目標機器：

docker load < hello-world.tar

---

? 方案 6：使用 skopeo 工具繞過 Docker

# 安裝 skopeo
sudo yum install -y skopeo# 通過鏡像源拉取
skopeo copy docker://docker.m.daocloud.io/library/hello-world:latest docker-daemon:hello-world:latest

---

📊 各鏡像源對比（2025 年測試）

鏡像源	協議	是否推薦	備注
docker.m.daocloud.io	HTTPS	? 強烈推薦	社區維護，穩定
docker.nju.edu.cn	HTTPS	? 推薦	南大鏡像，速度快
docker.mirrors.ustc.edu.cn	HTTPS	? 推薦	中科大經典源
gst6rzl9.mirror.aliyuncs.com	HTTPS	?? 可用	阿里云幸存地址
hub-mirror.c.163.com	HTTP/HTTPS	? 推薦	網易源穩定
jsdelivr.fyi 系列	HTTPS	? 不推薦	CDN 不穩定

---

🛠? 常見誤區

誤區	正確認知
“只要配一個阿里云就行”	阿里云公共源已逐步限流，建議多源冗余
“curl 能通，docker 就能用”	不一定！Docker 可能 fallback 到官方源
“HTTP 不安全，不能用”	在內網環境下，HTTP 更穩定，可配合 insecure-registries 使用

---

? 總結

要徹底解決 context deadline exceeded 問題，關鍵在于：

1. 配置多個可用鏡像源，避免單點故障
2. 優先使用教育網或社區維護的鏡像
3. 關閉 IPv6 和更換 DNS
4. 驗證加速器是否真正生效
5. 必要時使用離線導入或 skopeo

? 最終建議配置：[見上方 daemon.json]

---

📢 結語

Docker 鏡像拉取問題看似簡單，實則涉及網絡、DNS、TLS、系統配置等多個層面。希望本文能幫助你一次性解決這個“老毛病”。

如果你有更好的鏡像源或解決方案，歡迎在評論區分享！

👍 覺得有用？點贊 + 收藏 + 關注，不錯過每一篇干貨！

---

版權聲明：本文原創，轉載請注明出處。