Docker国内镜像源全部失效的问题

以下主要是针对**本地虚拟机**的Linux系统，包括CentOS、Kali、Ubuntu等。
**阿里云服务器**请参考这篇文章：
https://help.aliyun.com/zh/ecs/use-cases/install-and-use-docker-on-a-linux-ecs-instance

如果不是docker-compose拉取，而是docker pull拉取单个镜像，可以用：
https://dockerproxy.net/

# 一、问题现象
Docker官方镜像仓库 hub.docker.com 在国内是无法访问的。我们在安装Docker的教程中给大家提供了配置镜像仓库的方法。这些仓库会自动同步官方镜像仓库的内容，做到高速下载。

2024年6月中旬起，所有国内的Docker镜像仓库全部都失效了。
docker pull无法正常拉取镜像。
docker-compose同样无法拉取镜像。

![](/media/202406/2024-06-17_151616_9238600.6984476447429634.png)

# 二、解决办法
## 解决办法1 替换为其他镜像源
<font color="red">20250319更新，亲测可用。

![](/media/202503/2025-03-19_171840_7605810.41956409699085173.png)

注意：这个方法随时可能会失效，如果失效了就要用方法2</font>

这些网站是长期更新的，里面的网址都可以试试：
https://github.com/dongyubin/DockerHub
https://www.wxy97.com/archives/b5b225b6-7741-4560-be2f-2e6a4f671d9b

编辑配置文件，修改镜像源：
`vi /etc/docker/daemon.json`

```
{
 "registry-mirrors": ["https://docker.1panel.live",
"https://hub.rat.dev",
"https://docker.actima.top",
"https://atomhub.openatom.cn",
"https://docker.m.daocloud.io",
"https://docker.nastool.de",
"https://dockerpull.org",
"https://registry.dockermirror.com",
"https://docker.m.daocloud.io",
"https://docker.1ms.run",
"https://docker.aityp.com",
"https://dockerhub.xisoul.cn",
"https://docker.imgdb.de",
"https://hub.littlediary.cn",
"https://docker.unsee.tech",
"https://hub.crdz.gq",
"https://hub.firefly.store",
"https://docker.kejilion.pro",
"https://dhub.kubesre.xyz",
"https://hub.xdark.top",
"https://docker.udayun.com" 
]
}
```

修改以后重启：
```
systemctl daemon-reload
systemctl restart docker.service
```

测试拉取：
`docker pull mysql:5.7`
![](/media/202410/2024-10-03_104820_6237200.5245116412547223.png)

如果运行`docker search`或者 `docker pull`报错：
```
Unable to find image 'nginx:latest' locally
docker: Error response from daemon: 
Get https://registry-1.docker.io/v2/: net/http: 
request canceled while waiting for connection 
(Client.Timeout exceeded while awaiting headers).
```

<font color="red">这种情况需要使用代理，请看解决办法2</font>

## 解决办法2：使用代理
因为我们大部分时候是在Linux虚拟机使用Docker，所以解决办法就是让Linux虚拟机使用代理访问官方镜像源。

按这篇教程使用即可：虚拟机如何使用物理机的VPN
https://wiki.bafangwy.com/doc/58/

使用代理后，正常拉取：
![](/media/202406/2024-06-17_164247_4049450.27878576004201894.png)

拉取完以后即可关闭代理。