Docker 镜像拉取超时错误解决方案

Docker 镜像拉取超时错误解决方案

问题描述

在使用 Docker 进行镜像拉取时，若网络连接不稳定或无法访问官方仓库，常会出现拉取失败或超时的情况，报错如下：

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).

解决方法

具体操作步骤如下：

1. 备份原配置文件

cp /etc/docker/daemon.json{,.bak}

2. 修改或重建 daemon.json 配置

删除原有配置文件（测试环境可直接删除），并添加国内镜像源配置：

sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.1panel.live/"
  ]
}
EOF

3. 重载配置并重启 Docker

sudo systemctl daemon-reload
sudo systemctl restart docker

4. 验证拉取

再次尝试拉取镜像进行测试。