Docker 配置国内镜像加速源

为什么需要配置 Docker 国内镜像加速源

Docker 默认从 Docker Hub 拉取镜像，由于服务器位于国外，国内用户在拉取镜像时常遇到速度缓慢甚至超时的问题。尤其是在部署大型镜像（如 TensorFlow、Nginx、Redis 等）时，等待时间可能长达数十分钟。通过配置国内镜像加速源（Registry Mirror），可以将镜像请求转发到国内的镜像仓库，大幅提升下载速度，降低任务失败概率。

配置方法（以 Linux 系统为例）

1. 修改 Docker 守护进程配置

Docker 的配置主要集中在 /etc/docker/daemon.json 文件中。如果该文件不存在，需手动创建。

sudo mkdir -p /etc/docker
sudo vim /etc/docker/daemon.json

2. 填入镜像源地址

将以下内容复制到 daemon.json 中。这里整合了多个稳定、高速的国内镜像源（包括阿里云、百度云、中科大、南京大学等），可根据网络环境选择信任的源。

{
    "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"
    ]
}

注意：Docker 会按顺序尝试列表中的源，第一个响应的源会被使用。建议保留 3-5 个常用源即可，避免过多源导致配置臃肿。如果某些源不稳定，可以酌情删除。

3. 重启 Docker 服务

修改配置后，必须重启 Docker 守护进程使配置生效。

sudo systemctl daemon-reload
sudo systemctl restart docker

验证配置是否生效

方法一：检查 Docker Info

执行以下命令，查看输出中的 Registry Mirrors 字段是否包含你配置的镜像源。

docker info | grep -A 5 "Registry Mirrors"

示例输出：

 Registry Mirrors:
   https://docker.registry.cyou/
   https://mirror.aliyuncs.com/
   ...

方法二：拉取一个测试镜像

例如拉取一个较小的 hello-world 镜像，观察下载速度：

docker pull hello-world

如果原来需要几十秒的镜像现在几秒内完成，则说明加速配置成功。

不同系统的配置差异

Windows / macOS：Docker Desktop 用户，在设置界面中搜索 Registry mirrors，直接粘贴 JSON 数组即可，无需手动修改文件。
其他 Linux 发行版：CentOS 与 Ubuntu 配置步骤完全一致，都是操作 /etc/docker/daemon.json。

常见问题与注意事项

1. 镜像源的安全与可靠性

优先使用官方认证或知名云厂商提供的镜像源（如阿里云、百度云、中科大等），避免使用来源不明的第三方镜像源，以防镜像被篡改。
列表中部分源（如 *.jsdelivr.fyi）为社区维护，速度较快但可能存在有效期，可定期检查可用性。

2. 配置冲突

如果同时设置了 insecure-registries 或其他自定义仓库，确保 JSON 格式正确（不能有重复逗号）。
使用多个镜像源时，Docker 会按顺序尝试，若第一个源失败则自动切换到下一个。

3. 网络环境差异

不同地区（例如电信、联通、移动）对不同镜像源的访问速度可能不同。建议做简单测试后保留最快的 2-3 个源。可以手动运行 curl -I https://<mirror-url>/v2/ 检查响应时间。

4. 配置后无法启动 Docker

检查 daemon.json 的 JSON 格式是否合法（可用 python -m json.tool /etc/docker/daemon.json 验证）。如格式错误，则 Docker 无法启动。

总结

通过配置国内镜像加速源，Docker 的镜像拉取速度普遍提升 5-10 倍，极大优化了开发与部署体验。本文提供的镜像源列表经过社区验证，覆盖多个主流云厂商和高校镜像站。建议读者根据自己所在网络环境选择最优源组合，并定期关注最新可用源。

额外建议：对于企业级用户，可以考虑搭建私有仓库（如 Harbor），并在内部网络使用，彻底规避外网瓶颈。

参考资源：

Docker 官方文档 - 镜像加速

DaoCloud 镜像站

中科大镜像站

本文采用 CC BY-NC-SA 4.0协议进行许可，转载请注明出处。