一、国内主流镜像加速器

常用加速地址(按推荐顺序):

  1. 阿里云加速器(推荐)

    • 需要注册阿里云账号,免费

    • 地址格式:https://<你的ID>.mirror.aliyuncs.com

  2. 中科大镜像(USTC)

    https://docker.mirrors.ustc.edu.cn
  3. 网易云加速器

    https://hub-mirror.c.163.com
  4. 腾讯云加速器

    https://mirror.ccs.tencentyun.com
  5. DaoCloud加速器

    https://f1361db2.m.daocloud.io

二、配置方法

方法1:直接修改配置文件(推荐)

Linux(包括WSL2)

# 创建配置文件目录
sudo mkdir -p /etc/docker

# 编辑配置文件
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://<你的阿里云加速地址>",
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  }
}
EOF

# 重启Docker服务
sudo systemctl daemon-reload
sudo systemctl restart docker

# 验证配置
docker info | grep Mirrors

macOS(Docker Desktop):

  1. 打开 Docker Desktop

  2. 点击 Settings → Docker Engine

  3. 在配置文件中添加 registry-mirrors

  4. 点击 Apply & Restart

Windows

  1. Docker Desktop 设置界面

  2. Docker Engine → 编辑 daemon.json

  3. 添加 mirrors 数组

  4. 应用并重启

方法2:命令方式配置(临时)

# 查看当前配置
docker info --format '{{.RegistryConfig.Mirrors}}'

# 临时使用加速器(单次拉取)
docker pull registry.docker-cn.com/library/ubuntu:latest

三、阿里云镜像加速器获取步骤

  1. 访问 https://cr.console.aliyun.com

  2. 登录阿里云账号

  3. 进入「镜像加速器」页面

  4. 复制专属加速器地址

  5. 按照系统类型使用配置脚本

四、多加速器配置示例

{
  "registry-mirrors": [
    "https://xxx.mirror.aliyuncs.com",  // 阿里云
    "https://docker.mirrors.ustc.edu.cn",  // 中科大
    "https://registry.docker-cn.com"  // Docker中国官方
  ],
  "insecure-registries": [],
  "debug": false,
  "experimental": false
}

五、验证加速效果

# 1. 查看当前生效的镜像源
docker info | grep -A 5 Mirrors

# 2. 测试拉取镜像速度
time docker pull ubuntu:latest

# 3. 检查镜像源是否生效
docker pull hello-world

六、常见问题解决

1. 配置不生效

# 检查配置文件语法
sudo cat /etc/docker/daemon.json | python -m json.tool

# 查看Docker服务状态
sudo systemctl status docker

2. 清除缓存重新配置

# 停止Docker服务
sudo systemctl stop docker

# 清除旧配置
sudo rm -f /etc/docker/daemon.json

# 重启服务
sudo systemctl start docker

3. 拉取镜像报错

  • 检查加速器地址是否正确

  • 尝试更换其他加速器

  • 检查网络连接

七、进阶配置

私有仓库配置

{
  "registry-mirrors": ["加速器地址"],
  "insecure-registries": ["私有仓库IP:端口"]
}

按需使用代理(针对特定仓库)

export HTTP_PROXY="http://proxy-ip:port"
export HTTPS_PROXY="http://proxy-ip:port"
docker pull ubuntu:latest

小贴士

  1. 建议配置2-3个镜像源,避免单点故障

  2. 定期更新镜像源地址(部分服务会变更)

  3. 对于生产环境,建议搭建私有镜像仓库

  4. 使用 docker pull 时添加 -v 参数查看详细下载过程