国内 Docker 镜像源配置指南及测速方法

三、Docker 镜像源配置方法

方法一：直接修改 Docker 配置文件（推荐）

Linux/macOS 系统：

1. 创建或编辑 Docker 配置文件：

sudo mkdir -p /etc/docker

2. 编辑 daemon.json 配置文件：

sudo vim /etc/docker/daemon.json

3. 输入以下内容（使用上面的镜像源列表）：

{"debug":true,"experimental":false,"registry-mirrors":["https://docker.1ms.run","https://docker.m.daocloud.io","https://lispy.org","https://docker-0.unsee.tech"]}

4. 重启 Docker 服务使配置生效：

# 重新加载配置
sudo systemctl daemon-reload
# 重启 Docker 服务
sudo systemctl restart docker
# 检查是否生效
docker info | grep -A 1 "Registry Mirrors"

Windows 系统（Docker Desktop）：

1. 右键点击系统托盘中的 Docker 图标
2. 选择'Settings'（设置）
3. 进入'Docker Engine'选项卡
4. 在右侧编辑 JSON 配置
5. 点击'Apply & Restart'应用并重启

方法二：通过命令行配置

# 备份原有配置
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 "配置完成！"

四、验证配置是否生效

1. 查看当前配置

# 查看 Docker 信息
docker info
# 或直接查看镜像源配置
docker info | grep -A 5 "Registry Mirrors"

2. 测试镜像下载速度

# 拉取一个测试镜像
time docker pull hello-world
# 拉取较大的镜像测试
time docker pull nginx:alpine

3. 检查镜像源实际使用情况

# 拉取镜像时观察镜像源
docker pull ubuntu:20.04
# 查看镜像详细信息
docker inspect ubuntu:20.04 | grep -i repo

五、常见问题与解决方案

问题 1：配置后 Docker 无法启动

错误现象：

Error starting daemon: invalid registry mirror

解决方案：

1. 检查 JSON 格式是否正确
2. 检查镜像源地址是否有效
3. 临时恢复备份配置：

sudo cp /etc/docker/daemon.json.backup /etc/docker/daemon.json
sudo systemctl restart docker

问题 2：部分镜像仍然很慢

原因：某些镜像可能不在镜像源的缓存中

解决方案：

1. 更换镜像源顺序
2. 使用多个镜像源配置
3. 手动指定镜像源拉取：

docker pull registry.docker-cn.com/library/ubuntu:20.04

问题 3：镜像源失效

检测方法：

# 测试镜像源连通性
curl -I https://docker.1ms.run/v2/
# 测试拉取速度
time docker pull --registry-mirror=https://docker.1ms.run hello-world

应急方案：

1. 移除失效的镜像源
2. 使用备用镜像源
3. 临时使用官方源

六、高级配置技巧

1. 为不同仓库配置不同镜像源

{
  "registry-mirrors": ["https://docker.1ms.run"],
  "insecure-registries": [],
  "builder": {"gc": {"defaultKeepStorage": "20GB", "enabled": true}},
  "features": {"buildkit": true}
}

2. 使用代理服务器

如果镜像源仍不理想，可以配置 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"]
}

3. 镜像源健康检查脚本

#!/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

七、性能对比测试

测试环境

• 网络：中国电信 100M 宽带
• Docker 版本：20.10.12
• 测试镜像：ubuntu:20.04 (72.8MB)

下载速度对比

实际效果展示

# 使用官方源（慢）
$ 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

八、镜像源维护建议

1. 定期检查：每月检查镜像源是否可用
2. 多源备份：配置多个镜像源提高可靠性
3. 监控告警：设置镜像拉取失败告警
4. 社区同步：关注国内 Docker 社区的最新推荐

九、总结

配置国内 Docker 镜像源是每个国内开发者必备的优化步骤。通过本文提供的配置：

• 速度提升：从 KB/s 级别提升到 MB/s 级别
• 稳定性增强：减少拉取失败率
• 开发效率：缩短等待时间，提升开发体验

推荐配置方案：

• 主用：https://docker.1ms.run（阿里云，最稳定）
• 备用：https://docker.m.daocloud.io（DaoCloud）
• 测试：定期运行健康检查脚本

技术是不断发展的，镜像源也会时有变更。建议收藏本文，我们会持续更新可用的镜像源列表。