Docker 镜像库国内加速的几种方法

概述

在国内，拉取 Docker 镜像速度慢/时不时断线/无账号导致限流等，比较痛苦. 这里提供加速/优化的几种方法。

梳理一下，会碰到以下情况：

国内下载速度慢/时不时断线：是因为网络被限制了。
没有公共镜像库账号导致限流：是因为 Docker Hub 等主流镜像库，近年来纷纷开始对未登录的匿名用户进行限流，限制拉取的速度，以及一定时间内拉取的镜像数量。

为了解决以上问题，有这么几种方法：

针对国内下载速度慢/时不时断线, 可选方法如下：

配置国内可用/速度尚可的 Docker Registry Mirrors
自建 Docker Registry Mirror/Proxy, 并配置为 Mirror
Docker Daemon 配置 proxies

针对没有公共镜像库账号导致限流, 可选方法如下：

注册各个镜像库账号并 docker login 登录

具体方案如下。

具体方案

Notes:

这里以 Docker 举例说明。

Containerd/Podman/cri-o 等请举一反三。

配置国内可用/速度尚可的 Docker Registry Mirrors
1. 阿里云 Docker 加速：类似 xxxxxx.mirror.aliyuncs.com 的个人专属加速地址；
2. DockerProxy 代理加速：dockerproxy.com
3. 百度云 Mirror: mirror.baidubce.com
4. ...
自建 Docker Registry Mirror/Proxy, 并配置为 Mirror
1. 这里使用 Cloudflare Worker - cloudflare-docker-proxy 搭建
Docker Daemon 配置 proxies, 具体包括：http-proxy https-proxy no-proxy
注册各个镜像库账号并 docker login 登录

方案实施细节

配置国内可用的 Docker Registry Mirrors

随着时间的推移，国内可用的 Docker Registry Mirrors 会持续发生变化，因此，需要实时根据可用情况调整 Docker Registry Mirrors 配置。

截止 2023/9/5, 可用 Mirrors 列表如下：

阿里云 Docker 加速：类似 xxxxxx.mirror.aliyuncs.com 的个人专属加速地址；
DockerProxy 代理加速：dockerproxy.com
百度云 Mirror: mirror.baidubce.com
DaoCloud: docker.m.daocloud.io
南京大学：docker.nju.edu.cn
上海交大：docker.mirrors.sjtug.sjtu.edu.cn

测试国内 Docker Registry 可用性

可以自行测试验证，手动测试方法是拉取镜像，这里以测试 dockerproxy.com 为例：

docker pull dockerproxy.com/library/nginx

在国内拉取成功则证明可用。

也可以直接查看 GitHub 仓库：docker-practice/docker-registry-cn-mirror-test 的 Github Action 执行结果。如最近一次的执行结果为：

阿里云 Docker 加速服务申请

阿里云加速器（点击管理控制台 -> 登录账号 -> 右侧镜像工具 -> 镜像加速器 -> 复制加速器地址）

截图如下：

其他几个加速域名

DockerProxy 代理加速：dockerproxy.com
百度云 Mirror: mirror.baidubce.com
Daocloud: docker.m.daocloud.io
南京大学：docker.nju.edu.cn
上海交大：docker.mirrors.sjtug.sjtu.edu.cn

都是固定域名，直接配置即可。

已经不可用的 Docker 加速域名

以下 Docker 加速域名，已经因为各种原因不可用或只允许对应云供应商网络使用，包括：

163: hub-mirror.c.163.com
USTC: docker.mirrors.ustc.edu.cn
腾讯云：mirror.ccs.tencentyun.com
Azure 中国: dockerhub.azk8s.cn
七牛云：reg-mirror.qiniu.com
Docker CN: registry.docker-cn.com

Docker Registry Mirror 配置

创建或修改 /etc/docker/daemon.json:

sudo mkdir -p /etc/docker

sudo tee /etc/docker/daemon.json <<-EOF

{

    "registry-mirrors": [

        "https://<changme>.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"

    ]

}

EOF

sudo systemctl daemon-reload

sudo systemctl restart docker

自建 Docker Registry Mirror/Proxy

前提

有 Cloudflare 账号
（可选）有自定义的域名，且域名托管在 Cloudflare 上
Cloudflare Workers 额度足够

cloudflare-docker-proxy

这里使用 Cloudflare Worker - cloudflare-docker-proxy 搭建。原文 README 步骤有一些问题，可以参考这篇 README.md 来实施。

这里以自定义域名配置方式举例, 步骤如下：

Fork Repo
Deploy 按钮对应 URL 调整为您自己的 repo url

修改 src/index.js 的 const routes 块的内容

const routes = {

  "docker.your-domain.com": "https://registry-1.docker.io",

  "quay.your-domain.com": "https://quay.io",

  "gcr.your-domain.com": "https://k8s.gcr.io",

  "k8s-gcr.your-domain.com": "https://k8s.gcr.io",

  "ghcr.your-domain.com": "https://ghcr.io",

};

点击 "Deploy" 按钮部署，部署后如下：
在 Cloudflare 的 DNS 记录里添加 CNAME 指向部署后的 ${workername}.${username}.workers.dev 地址。如下：
在 Workers 的 HTTP Routes 里，添加 xxx.your-domain.com/* 路由指向 cloudflare-docker-proxy, xxx 就是 docker quay gcr 等，如下：

完成。

Docker Registry Mirror 配置

将配置后的 docker.<your-domain>.com Mirror 添加到 /etc/docker/daemon.json 的 registry-mirrors 中并重启 Docker 生效。

Docker Daemon 配置 `proxies`

如果不想设置 Mirrors, 还可以配置 proxies, 实现通过 proxies 拉取 Docker Hub 镜像。

前提

有一个 Proxy, 可以稳定访问到 Docker Hub

Docker Daemon 配置

vi /etc/docker/daemon.json, 添加如下内容：

sudo mkdir -p /etc/docker

sudo tee /etc/docker/daemon.json <<-EOF

{

    "proxies": {

        "http-proxy": "http://<proxy-ip>:7890",

        "https-proxy": "http://<proxy-ip>:7890",

        "no-proxy": "*.cn,127.0.0.0/8,192.168.0.0/16,172.16.0.0/12,10.0.0.0/8"

    }

}

EOF

sudo systemctl daemon-reload

sudo systemctl restart docker

Notes:

Docker Daemon 里的 no-proxy, 是支持 CIDR 格式的.

完成。

注册各个镜像库账号并登录

包括不限于：

Docker Hub
Quay.io
GHCR.io (GitHub 的 Docker registry)
gcr.io (Google Cloud 的 Registry)
...

注册后，视情况不同，有的可以直接通过密码登录，有的需要申请 Token/Service Account 等专用密码。

注册过程略。

`docker login` 登录

Docker Hub 登录：

echo "<password>" | docker login --username <username> --password-stdin'

其他 Docker Registry 登录：

echo "<password>" | docker login quay.io --username <username> --password-stdin

echo "<password>" | docker login ghcr.io --username <username> --password-stdin

echo "<password>" | docker login gcr.io --username <username> --password-stdin

或者，也可以直接写入 ~/.docker/config.json 文件：

{

  "auths": {

    "ghcr.io": {

      "auth": "<auth>"

    },

    "https://index.docker.io/v1/": {

      "auth": "<auth>"

    },

    "quay.io": {

      "auth": "<auth>"

    }

  }

}

<auth> 通过如下方式获得：

echo -n '<username>:<password>' | base64

结束。

总结

通过以上方法，相信您能在国内使用 Docker 得心应手。

三人行, 必有我师; 知识共享, 天下为公. 本文由东风微鸣技术博客 EWhisper.cn 编写.