Docker镜像拉取马拉松：从『Timeout绝望』到极速狂飙的救赎

---

title: “ Docker镜像拉取马拉松：从『Timeout绝望』到极速狂飙的救赎”
author: “Cjs”
date: “2025-2-23”
emoji: “⏳”

当你发现Docker镜像下载速度堪比树懒时…

docker-compose up -d
[+] Running 0/5
 ⠿ compreface-postgres-db Error     15.2s
Error: net/http: request canceled while waiting for connection

此刻的你：

“这进度条是坏了吧？！”
“我家网速明明能4K看片啊！”
“Docker Hub是在用拨号上网吗…（怒摔鼠标）”

稳住！ 让本喵（Cjs）带你破解这个"网络龟速"之谜

---

五步极速救援方案（附赠暴躁安慰剂）

第一步：诊断网络心跳

ping registry-1.docker.io  # 检测物理连接
curl -Iv https://registry-1.docker.io  # 模拟Docker握手过程

• 如果出现Could not resolve host ➡️ 跳转第二步
• 如果卡在TLS handshake ➡️ 跳转第三步

---

第二步：DNS大拯救计划

dig @8.8.8.8 registry-1.docker.io  # 使用Google DNS测试解析
sudo vi /etc/docker/daemon.json    # 修改Docker DNS配置

推荐配置：

{
  "dns": ["8.8.8.8", "114.114.114.114"],
  "registry-mirrors": [
  "https://docker.registry.cyou",
   "https://docker-cf.registry.cyou",
   "https://dockercf.jsdelivr.fyi",
   "https://docker.jsdelivr.fyi",
   "https://dockertest.jsdelivr.fyi",
   "https://mirror.aliyuncs.com",
   "https://dockerproxy.com",
   "https://mirror.baidubce.com",
   "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.iscas.ac.cn",
   "https://docker.rainbond.cc",
   "https://docker.1panel.live"
	]
}

生效命令：

sudo systemctl restart docker  # 重启Docker守护进程

---

第三步：镜像加速器开氮气

阿里云镜像加速：

1. 访问容器镜像服务
2. 获取专属加速器地址
3. 修改daemon.json：

{
  "registry-mirrors": ["https://xxxxxx.mirror.aliyuncs.com"]
}

中科大镜像备用：

sudo docker pull registry.cn-hangzhou.aliyuncs.com/compreface/镜像名

---

第四步：手动拉取看进度

# 单独拉取问题镜像（实时显示进度）
docker pull compreface-api --progress=plain

# 强制重新拉取所有镜像
docker-compose pull --no-cache

进度条解读小技巧：

• Already exists：本地已有基础镜像
• Pulling fs layer：开始下载新层
• Waiting：网络阻塞警告！

---

第五步：镜像名称捉迷藏

常见坑点排查：

docker search compreface-api  # 确认镜像是否存在
docker image ls | grep postgres  # 检查本地镜像缓存

Compreface专用修复：

# 在docker-compose.yml中确认镜像路径
services:
  postgres-db:
    image: registry.cn-hangzhou.aliyuncs.com/compreface/postgres-db:v1.0

---

高阶玩家扩展包

代理大法好

export HTTP_PROXY=http://127.0.0.1:1087
export HTTPS_PROXY=http://127.0.0.1:1087
docker-compose up -d  # 通过代理加速

分片下载策略

docker-compose pull --parallel  # 并行拉取服务镜像
docker save -o compreface.tar $(docker-compose config | grep image: | awk '{print $2}')  # 打包镜像备份

---

Cjs的镜像拉取哲学

def download_image():
    while True:
        try:
            pull_from_dockerhub()
        except TimeoutError:
            if coffee_level < 3:
                切换镜像源()
                喝咖啡()
            else:
                手动下载_暴力解压()
                摆烂躺平()
        finally:
            保存进度()

金句墙：

• “每个timeout都是Docker在说『该优化网络啦』”
• “镜像拉取就像爱情，强求不来时就换个目标”
• “程序员最解压的时刻：看到所有layer都verified✅”

---

终极验证时刻

docker-compose up --no-start  # 仅创建容器不启动
docker image ls | grep compreface  # 确认镜像全家桶

遇到更奇葩的网络问题？ 在评论区贴出你的docker info结果～
觉得有用？ 收藏⭐ ➕ 转发 ➕ 点赞 素质三连走起！

“当第一个镜像层开始下载时，
那不是进度条的跃动，
而是希望的火花在闪烁✨”
—— Cjs《镜像拉取启示录》

---

下期预告
《容器启动后的奇幻漂流：当服务们集体装睡时》
（关注不迷路，我们一起攻克部署的星辰大海！）