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

本文最后更新于:2024年7月24日 晚上

概述

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

梳理一下,会碰到以下情况:

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

为了解决以上问题,有这么几种方法:

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

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

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

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

具体方案如下。

具体方案

📝Notes:

这里以 Docker 举例说明。
Containerd/Podman/cri-o 等请举一反三。

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

方案实施细节

配置国内可用的 Docker Registry Mirrors

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

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

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

测试国内 Docker Registry 可用性

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

1
docker pull dockerproxy.com/library/nginx

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

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

docker-registry-cn-mirror-test result

阿里云 Docker 加速服务申请

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

截图如下:

阿里云镜像加速器

其他几个加速域名

  1. DockerProxy 代理加速:dockerproxy.com
  2. 百度云 Mirror: mirror.baidubce.com
  3. Daocloud: docker.m.daocloud.io
  4. 南京大学:docker.nju.edu.cn
  5. 上海交大: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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
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 来实施。

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

  1. Fork Repo

  2. Deploy 按钮对应 URL 调整为您自己的 repo url

  3. 修改 src/index.jsconst routes 块的内容

    1
    2
    3
    4
    5
    6
    7
    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",
    };
  4. 点击 “Deploy” 按钮部署,部署后如下:
    Cloudflare Worker

  5. 在 Cloudflare 的 DNS 记录里添加 CNAME 指向部署后的 ${workername}.${username}.workers.dev 地址。如下:
    Cloudflare DNS Records

  6. 在 Workers 的 HTTP Routes 里,添加 xxx.your-domain.com/* 路由指向 cloudflare-docker-proxy, xxx 就是 docker quay gcr 等,如下:
    Cloudflare Worker Routes

完成。

Docker Registry Mirror 配置

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

Docker Daemon 配置 proxies

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

前提

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

Docker Daemon 配置

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

1
2
3
4
5
6
7
8
9
10
11
12
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 格式的.

完成。

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

包括不限于:

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

注册过程略。

docker login 登录

Docker Hub 登录:

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

其他 Docker Registry 登录:

1
2
3
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 文件:

1
2
3
4
5
6
7
8
9
10
11
12
13
{
"auths": {
"ghcr.io": {
"auth": "<auth>"
},
"https://index.docker.io/v1/": {
"auth": "<auth>"
},
"quay.io": {
"auth": "<auth>"
}
}
}

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

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

结束。

总结

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


Docker 镜像库国内加速的几种方法
https://ewhisper.cn/posts/57490/
作者
东风微鸣
发布于
2023年9月5日
许可协议