Docker连接超时的解决方法

Shannon Law2025-10-25 9:51

使用docker pull命令下载镜像时，可能因网络问题导致超时，报错如下：

复制代码

Error response from daemon: Get "https://registry-1.docker.io/v2/": context deadline exceeded

针对该问题，最有效的解决方法之一，就是配置国内镜像加速器，流程如下。
1. 更改镜像源

打开文件/etc/docker/daemon.json。如果使用snap安装Docker，则打开文件/var/snap/docker/current/config/daemon.json。

输入可用的镜像源：

复制代码

{
  "registry-mirrors": [
    "https://dockerhub.icu",
    "https://docker.chenby.cn",
    "https://docker.1panel.live",
    "https://docker.awsl9527.cn",
    "https://docker.anyhub.us.kg",
    "https://dhub.kubesre.xyz"
  ]
}

上述镜像源 $1$ ^{ $1$ } $1$ 仅作示例，目前暂时可用。如果不可用，则换用其它镜像源。

2. 重启Docker

bash 复制代码

sudo systemctl daemon-reload
sudo systemctl restart docker

如果使用snap安装Docker，则运行如下命令：

bash 复制代码

sudo systemctl daemon-reload
sudo snap restart docker

3. 验证

运行命令

bash 复制代码

sudo docker info

如果终端显示了添加的镜像源，则表明更改的镜像源已生效。显示的部分信息如下：

复制代码

 Debug Mode: false
 Experimental: false
 Insecure Registries:
  ::1/128
  127.0.0.0/8
 Registry Mirrors:
  https://dockerhub.icu/
  https://docker.chenby.cn/
  https://docker.1panel.live/
  https://docker.awsl9527.cn/
  https://docker.anyhub.us.kg/
  https://dhub.kubesre.xyz/
  https://huecker.io/
  https://dockerhub.timeweb.cloud/
  https://noohub.ru/
  https://do.nark.eu.org/
  https://dc.j8.work/
  https://docker.m.daocloud.io/
  https://dockerproxy.com/
  https://docker.mirrors.ustc.edu.cn/
  https://docker.nju.edu.cn/
 Live Restore Enabled: false

若新的镜像源添加成功，再使用docker pull命令下载镜像。下载成功后，使用docker images命令查看本地的镜像。

参考文献

$1$ docker镜像源（可用）

$2$ Docker连接超时？5种方法快速解决

$3$ Docker简单介绍与使用以及下载对应镜像（项目前置）

$4$ 从Docker拉取镜像一直失败超时？这些解决方案帮你解决烦恼