必须配置国内镜像源,否则拉取ubuntu:22.04等镜像常卡在2%超三分钟;推荐清华源安装Docker并配置多源镜像加速(如网易、腾讯、中科大),重启docker服务后执行docker info验证生效。

装完 Docker 后不配国内镜像源,拉个 ubuntu:22.04 可能卡在 2%,等三分钟没动静是常态。核心问题不在 Docker 本身,而在默认连接的是海外 Docker Hub——物理距离远、带宽受限、还有匿名限速。配置国内镜像源不是“锦上添花”,而是让 Docker 能用起来的基础操作。
安装 Docker(以 Ubuntu 为例)
推荐使用清华源,比官方源快 5–10 倍,且稳定:
- 先卸载旧版本(避免冲突):
sudo apt-get remove docker docker-engine docker.io containerd runc - 添加清华 GPG 密钥和仓库源:
curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpgecho "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null - 更新并安装:
sudo apt-get update && sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin - 验证安装:
sudo docker run hello-world(成功输出即代表运行正常)
配置国内镜像源(关键一步)
仅安装还不够,必须改守护进程配置,否则仍走默认慢通道:
- 创建或编辑配置文件:
sudo mkdir -p /etc/dockersudo nano /etc/docker/daemon.json - 写入镜像源列表(推荐组合:网易 + 腾讯 + 中科大,多源容错):
{ "registry-mirrors": ["https://hub-mirror.c.163.com", "https://mirror.ccs.tencentyun.com", "https://docker.mirrors.ustc.edu.cn"] } - 重启服务生效:
sudo systemctl daemon-reload && sudo systemctl restart docker
验证镜像源是否生效
别跳过这步,很多问题出在 JSON 格式错误或服务未重载:
- 执行:
docker info | grep "Registry Mirrors" -A 1 - 正确输出应类似:
Registry Mirrors:
https://hub-mirror.c.163.com/
https://mirror.ccs.tencentyun.com/
https://docker.mirrors.ustc.edu.cn/ - 如果无输出或报错,检查:
•daemon.json是否有中文引号、多余逗号
• 文件权限是否为 root 可读
• 是否漏掉systemctl daemon-reload
简单测速对比(真实效果)
用一个标准镜像实测,感受差异:
- 未配置前:
time docker pull nginx:alpine→ 通常耗时 2 分钟以上,平均速度 ≤300 KB/s - 配置后重试:
同一命令 → 多数情况 15–25 秒完成,峰值可达 6–9 MB/s - 小技巧:首次拉取后可加
--no-cache强制走镜像源,排除本地缓存干扰


















