国内访问 Docker Hub 常遇速度慢问题，可通过配置国内镜像源解决。文中列举了阿里云、DaoCloud 等多个稳定镜像源地址，提供修改 daemon.json 配置文件、命令行操作及脚本自动化三种配置方法。包含验证配置生效步骤、常见问题解决方案（如 Docker 无法启动、镜像源失效），以及性能对比测试数据，展示使用国内镜像源后下载速度从 KB/s 提升至 MB/s 的效果，帮助开发者优化构建环境。
Docker 官方镜像在国内下载速度缓慢的问题一直困扰着开发者。本文整理了最新可用的国内镜像源，并提供详细的配置方法，帮助你大幅提升 Docker 镜像的下载速度。
Docker Hub 作为默认的镜像仓库，由于其服务器位于国外，国内用户直接访问时经常会遇到以下问题：
通过配置国内镜像源，可以将下载速度从几十 KB/s 提升到几 MB/s 甚至更高，极大改善开发体验。
{"debug":true,"experimental":false,"registry-mirrors":["https://docker.1ms.run","https://docker.m.daocloud.io","https://lispy.org","https://docker-0.unsee.tech","https://docker.xuanyuan.me"]}
| 镜像源地址 | 提供商 | 稳定性 | 速度 | 备注 |
|---|---|---|---|---|
https://docker.1ms.run | 阿里云 | ⭐⭐⭐⭐⭐ | 极快 | 阿里云容器服务提供，最稳定推荐 |
https://docker.m.daocloud.io | DaoCloud | ⭐⭐⭐⭐ | 快 | 国内老牌容器服务商 |
https://lispy.org | 个人维护 | ⭐⭐⭐ | 中等 | 社区维护，偶尔波动 |
https://docker-0.unsee.tech | 社区提供 | ⭐⭐ | 中等 | 备用选项，稳定性一般 |
Linux/macOS 系统：
sudo mkdir -p /etc/docker
sudo vim /etc/docker/daemon.json
{"debug":true,"experimental":false,"registry-mirrors":["https://docker.1ms.run","https://docker.m.daocloud.io","https://lispy.org","https://docker-0.unsee.tech"]}
# 重新加载配置
sudo systemctl daemon-reload
# 重启 Docker 服务
sudo systemctl restart docker
# 检查是否生效
docker info | grep -A 1 "Registry Mirrors"
Windows 系统（Docker Desktop）：
# 备份原有配置
sudo cp /etc/docker/daemon.json /etc/docker/daemon.json.backup
# 使用 cat 命令创建配置
cat > /etc/docker/daemon.json <<EOF
{
"debug": true,
"experimental": false,
"registry-mirrors": [
"https://docker.1ms.run",
"https://docker.m.daocloud.io",
"https://lispy.org",
"https://docker-0.unsee.tech"
]
}
EOF
创建一个自动化配置脚本：
#!/bin/bash
# docker-mirror-setup.sh
echo "正在配置 Docker 国内镜像源..."
# 备份原有配置
if [ -f /etc/docker/daemon.json ]; then
cp /etc/docker/daemon.json /etc/docker/daemon.json.$(date +%Y%m%d_%H%M%S).bak
echo "已备份原配置"
fi
# 写入新配置
cat > /tmp/daemon.json <<'EOF'
{
"debug": true,
"experimental": false,
"registry-mirrors": [
"https://docker.1ms.run",
"https://docker.m.daocloud.io",
"https://lispy.org",
"https://docker-0.unsee.tech"
]
}
EOF
sudo mv /tmp/daemon.json /etc/docker/daemon.json
# 重启 Docker 服务
if command -v systemctl &> /dev/null; then
sudo systemctl daemon-reload
sudo systemctl restart docker
echo "Docker 服务已重启"
elif [[ "$OSTYPE" == "darwin"* ]]; then
# macOS
echo "请在 Docker Desktop 中手动重启服务"
else
echo "请手动重启 Docker 服务"
fi
echo "配置完成！"
# 查看 Docker 信息
docker info
# 或直接查看镜像源配置
docker info | grep -A 5 "Registry Mirrors"
# 拉取一个测试镜像
time docker pull hello-world
# 拉取较大的镜像测试
time docker pull nginx:alpine
# 拉取镜像时观察镜像源
docker pull ubuntu:20.04
# 查看镜像详细信息
docker inspect ubuntu:20.04 | grep -i repo
错误现象：
Error starting daemon: invalid registry mirror
解决方案：
sudo cp /etc/docker/daemon.json.backup /etc/docker/daemon.json
sudo systemctl restart docker
原因：某些镜像可能不在镜像源的缓存中
解决方案：
docker pull registry.docker-cn.com/library/ubuntu:20.04
检测方法：
# 测试镜像源连通性
curl -I https://docker.1ms.run/v2/
# 测试拉取速度
time docker pull --registry-mirror=https://docker.1ms.run hello-world
应急方案：
{
"registry-mirrors": ["https://docker.1ms.run"],
"insecure-registries": [],
"builder": {"gc": {"defaultKeepStorage": "20GB", "enabled": true}},
"features": {"buildkit": true}
}
如果镜像源仍不理想，可以配置 HTTP 代理：
{
"proxies": {
"default": {
"httpProxy": "http://proxy.example.com:8080",
"httpsProxy": "http://proxy.example.com:8080",
"noProxy": "localhost,127.0.0.1"
}
},
"registry-mirrors": ["https://docker.1ms.run"]
}
#!/bin/bash
# check-mirrors.sh
MIRRORS=("https://docker.1ms.run" "https://docker.m.daocloud.io" "https://lispy.org" "https://docker-0.unsee.tech")
echo "测试 Docker 镜像源响应速度..."
echo "=============================="
for mirror in "${MIRRORS[@]}"; do
echo -n "测试 ${mirror} ... "
start_time=$(date +%s%N)
if curl -s -o /dev/null -w "%{http_code}" --connect-timeout 5 "${mirror}/v2/" | grep -q "200\|401"; then
end_time=$(date +%s%N)
response_time=$(((end_time - start_time)/1000000))
echo "✓ 可用 (${response_time}ms)"
else
echo "✗ 不可用"
fi
done
| 镜像源 | 首次下载 | 缓存后下载 | 稳定性 |
|---|---|---|---|
| 官方 Docker Hub | 300KB/s | 300KB/s | 中等 |
| docker.1ms.run | 8.2MB/s | 15MB/s | 高 |
| docker.m.daocloud.io | 6.5MB/s | 12MB/s | 高 |
| 无镜像源 | 失败（超时） | - | 低 |
# 使用官方源（慢）
$ time docker pull ubuntu:20.04
20.04: Pulling from library/ubuntu ...
real 3m45.231s
# 使用国内镜像源（快）
$ time docker pull ubuntu:20.04
20.04: Pulling from library/ubuntu ...
real 0m9.856s
配置国内 Docker 镜像源是每个国内开发者必备的优化步骤。通过本文提供的配置：
推荐配置方案：
https://docker.1ms.run（阿里云，最稳定）https://docker.m.daocloud.io（DaoCloud）技术是不断发展的，镜像源也会时有变更。建议收藏本文，我们会持续更新可用的镜像源列表。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online