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 替换为其他镜像源
20250319更新，亲测可用。

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

注意：这个方法随时可能会失效，如果失效了就要用方法1

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

直接运行这个命令：
（2026年6月21日测试正常）
```
sudo tee /etc/docker/daemon.json > /dev/null <<'EOF'
{
 "registry-mirrors": [
 "https://docker.xuanyuan.me"
 ],
 "insecure-registries": [
 "docker.xuanyuan.me"
 ]
}
EOF
```

修改以后重启：
```
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).
```

这种情况需要使用代理，请看解决办法2

## 解决办法2 配置本地代理

### 在Windows启动代理软件：

打开“允许局域网”、“系统代理”
![](/media/202505/2025-05-08_181119_3173300.6651181653440442.png)

注意：
需要关闭其他代理软件，包括“Mojie”软件以及操作系统的代理开关。
只运行这一个就可以。

### 查看Windows IP地址
注意这个IP地址是会变的，所以下次重启电脑以后需要修改
命令：`ipconfig`
![](/media/202505/2025-05-08_181226_4025080.781148786008965.png)

注意：
如果是无线网络，就看 “无线局域网适配器 WLAN” 的 “IPv4 地址”
如果是有限网络，就看 “以太网适配器 以太网” 的 “IPv4 地址”

### 在Linux安装proxychains
【根据系统安装】Ubuntu/Kali：
`apt -y install wget curl git proxychains4`

【根据系统安装】CentOS（必须填[替换yum源为阿里云](/doc/593/ "替换yum源为阿里云")）：
```bash
yum install epel-release -y
yum install proxychains-ng
```

修改代理配置文件：
Ubuntu/Kali:
`vim /etc/proxychains4.conf`

CentOS：
`vim /etc/proxychains.conf`

在末尾加上代理IP端口（Shift+G跳到末尾）
内容格式：`socks5 代理地址:端口`

例如：
![](/media/202505/2025-05-08_181532_2737540.7246758385954234.png)

### 修改Docker镜像源配置文件
`vim /etc/docker/daemon.json`

文件内容：
端口号默认是7890，IP改成上一步ipconfig得到的IP地址。
```
{
  "proxies": {
    "http-proxy": "http://192.168.x.x:7890",
    "https-proxy": "http://192.168.x.x:7890"
  }
}
```

例如：

![](/media/202505/2025-05-08_181648_8199590.7803780846439449.png)

重启Docker
`systemctl restart docker`

测试（能正常拉取运行代表成功）：
```
docker pull hello-world
docker run hello-world
```

![](/media/202505/2025-05-16_174906_7293410.31069003613104396.png)

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

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

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

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