# Docker Hub 镜像加速器

国内从 Docker Hub 拉取镜像有时会遇到困难，此时可以配置镜像加速器。Docker 官方和国内很多云服务商都提供了国内加速器服务。

> Dockerized 实践 https://github.com/y0ngb1n/dockerized

## 配置加速地址

> Ubuntu 16.04+、Debian 8+、CentOS 7+

创建或修改 `/etc/docker/daemon.json`：

```bash
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
    "registry-mirrors": [
        "https://dockerproxy.com",
        "https://docker.mirrors.ustc.edu.cn",
        "https://docker.nju.edu.cn"
    ]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
```

## Docker Hub 镜像加速器列表

以下镜像站来源于互联网（感谢热心网友），可能出现宕机、转内网、关停等情况，建议同时配置多个镜像源。

镜像加速器 | 镜像加速器地址 | 专属加速器[？](# "需登录后获取平台分配的专属加速器") | 其它加速[？](# "支持哪些镜像来源的镜像加速")
--- | --- | --- | ---
~~[Docker 中国官方镜像](https://docker-cn.com/registry-mirror)~~ | ~~`https://registry.docker-cn.com`~~ | | ~~Docker Hub~~（[已关闭](https://github.com/docker/docker.github.io/issues/8793)）
[DaoCloud 镜像站](https://github.com/DaoCloud/public-image-mirror) | `https://docker.m.daocloud.io` | |  Docker Hub、GCR、K8S、GHCR、Quay、NVCR 等
[Azure 中国镜像](https://github.com/Azure/container-service-for-azure-china/blob/master/aks/README.md#22-container-registry-proxy) | `https://dockerhub.azk8s.cn` | [仅供内部访问](https://mirror.azk8s.cn/help/docker-registry-proxy-cache.html) | Docker Hub、GCR、Quay
[科大镜像站](https://mirrors.ustc.edu.cn/help/dockerhub.html) | `https://docker.mirrors.ustc.edu.cn` | [仅供内部访问](https://mirrors.ustc.edu.cn/help/dockerhub.html) | Docker Hub、[GCR](https://github.com/ustclug/mirrorrequest/issues/91)、[Quay](https://github.com/ustclug/mirrorrequest/issues/135)
[阿里云](https://cr.console.aliyun.com) | `https://<your_code>.mirror.aliyuncs.com` | 需登录，系统分配 | Docker Hub
~~[七牛云](https://kirk-enterprise.github.io/hub-docs/#/user-guide/mirror)~~ | ~~`https://reg-mirror.qiniu.com`~~ | | ~~Docker Hub、GCR、Quay~~
~~[网易云](https://www.163yun.com/help/documents/56918246390157312)~~ | ~~`https://hub-mirror.c.163.com`~~ | | ~~Docker Hub~~
[腾讯云](https://cloud.tencent.com/document/product/457/9113) | `https://mirror.ccs.tencentyun.com` | 仅供内部访问 | Docker Hub
[Docker 镜像代理](https://dockerproxy.com) | `https://dockerproxy.com` | | Docker Hub、GCR、K8S、GHCR
[百度云](https://cloud.baidu.com/doc/CCE/s/Yjxppt74z#%E4%BD%BF%E7%94%A8dockerhub%E5%8A%A0%E9%80%9F%E5%99%A8) | `https://mirror.baidubce.com` | | Docker Hub
[南京大学镜像站](https://doc.nju.edu.cn/books/35f4a) | `https://docker.nju.edu.cn` | | Docker Hub、GCR、GHCR、Quay、NVCR 等
~~[上海交大镜像站](https://mirrors.sjtug.sjtu.edu.cn/)~~ | ~~`https://docker.mirrors.sjtug.sjtu.edu.cn`~~ | | ~~Docker Hub、GCR 等~~（[已关闭](https://sjtug.org/post/mirror-news/2024-06-06-takedown-dockerhub/)）
[中科院软件所镜像站](https://mirror.iscas.ac.cn/mirror/docker.html) | `https://mirror.iscas.ac.cn` | | Docker Hub

> ⚠️ 部分网友反馈以下镜像站存在未同步最新源镜像问题，请按需选用（评论区可考古）
> - 阿里云

## 检查加速器是否生效

命令行执行 `docker info`，如果从结果中看到了如下内容，说明配置成功。

```console
Registry Mirrors:
 [...]
 https://docker.m.daocloud.io
```

## Docker Hub 镜像测速

使用镜像前后，可使用 `time` 统计所花费的总时间。测速前先移除本地的镜像！ 

```console
$ docker rmi node:latest
$ time docker pull node:latest
Pulling repository node
[...]

real   1m14.078s
user   0m0.176s
sys    0m0.120s
```

## 更新日志

<details open>
<summary><b>2024.06.06</b></summary>

  - 🚫 失效加速器
    - 上海交大镜像站
      - https://sjtug.org/post/mirror-news/2024-06-06-takedown-dockerhub/

  > 感谢 [@hangone](https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6?permalink_comment_id=5080408#gistcomment-5080408) 提供反馈

</details>

<details>
<summary><b>2024.01.10</b></summary>

  - 🚫 失效加速器
    - 网易云镜像

  > 感谢网友 [@joelhy](https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6?permalink_comment_id=4791486#gistcomment-4791486) [@MalikWilliams1greher](https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6?permalink_comment_id=4824642#gistcomment-4824642) 的反馈

</details>

<details>
  <summary><b>2023.12.21</b></summary>

  - 🆕 新增加速器
    - 中科院软件所镜像站
      - https://mirror.iscas.ac.cn/
      - https://mirror.iscas.ac.cn/mirror/docker.html

  > 感谢网友 @ApsarasX @snowdream [提供反馈](https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6?permalink_comment_id=4801425#gistcomment-4801425)

</details>

<details>
  <summary><b>2023.06.19</b></summary>

  - 🆕 新增加速器
    - 上海交大镜像站
      - https://mirrors.sjtug.sjtu.edu.cn/
      - https://mirrors.sjtug.sjtu.edu.cn/docs/docker-registry

  > 感谢网友 [@shadowofmoo 的反馈](https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6?permalink_comment_id=4601317#gistcomment-4601317)

</details>

<details>
  <summary><b>2023.03.14</b></summary>

  - 🆕 新增加速器
    - 南京大学镜像站
      - https://doc.nju.edu.cn/books/35f4a
      - https://sci.nju.edu.cn/9e/05/c30384a564741/page.htm

  > 感谢网友 [@msojocs 的反馈](https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6?permalink_comment_id=4492785#gistcomment-4492785)

</details>

<details>
  <summary><b>2023.03.04</b></summary>

  - 🔒 已转为私有
    - 科大镜像站

  > 感谢网友 [@ionlz 的反馈](https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6?permalink_comment_id=4488961#gistcomment-4488961)

</details>

<details>
<summary><b>2023.02.22</b></summary>

  - 🆕 新增加速器
    - 百度云镜像
  - 🔒 已转为私有
    - Azure 中国镜像
    - 腾讯云镜像
  - 🚫 失效加速器
    - 七牛云镜像

  > 感谢网友 [@YiuTerran 的反馈](https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6?permalink_comment_id=4478958#gistcomment-4478958)

</details>

---

## 参考链接

+ https://docs.docker.com/registry/recipes/mirror/
+ https://github.com/yeasy/docker_practice/blob/master/install/mirror.md
+ https://github.com/moby/moby/blob/d409b05970e686993e343d226fae5b463d872082/docs/articles/registry_mirror.md
+ https://www.fengbohello.top/archives/docker-registry-mirror
+ https://www.ilanni.com/?p=14534
+ https://github.com/Azure/container-service-for-azure-china/blob/master/aks/README.md#22-container-registry-proxy
+ https://moelove.info/2020/09/20/突破-DockerHub-限制全镜像加速服务/