【Docker】完美解决拉取镜像超时报错：ERROR: Get https://registry-1.docker.io/v2/

Docker拉取镜像超时解决方法
置顶 已于 2025-11-11 09:19:38 修改
阅读量10w+ 收藏 70
点赞数 71
CC 4.0 BY-SA版权
分类专栏： 《Docker及K8s各类报错整理及解决》 《Linux从入门到精通》 # 《docker从入门到精通》 文章标签： docker kubernetes 运维 linux
于 2023-02-20 09:25:17 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/liu_chen_yang/article/details/129085538
本文介绍了在使用Docker拉取镜像时遇到速度慢或ERROR: Get https://registry-1.docker.io/v2/的问题，分析原因是由于外网镜像资源下载困难。提供了解决方案，即配置阿里云镜像加速器，通过8个步骤详细说明了配置过程，包括访问阿里云官网获取加速器地址，编辑daemon.json文件并重启Docker服务，最终成功解决问题。

👨‍🎓博主简介

  🏅优快云博客专家
  🏅云计算领域优质创作者
  🏅华为云开发者社区专家博主
  🏅阿里云开发者社区专家博主
💊交流社区：运维交流社区 欢迎大家的加入！
🐋 希望大家多多支持，我们一起进步！😄
🎉如果文章对你有帮助的话，欢迎 点赞 👍🏻 评论 💬 收藏 ⭐️ 加关注+💗

文章目录

一、问题报错

docker拉取镜像时超时，拉取失败；

  • docker-compose 创建拉取镜像
ERROR: Get https://registry-1.docker.io/v2/library/nginx/manifests/latest: Get https://auth.docker.io/token?scope=repository%3Alibrary%2Fnginx%3Apull&service=registry.docker.io: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)
    了解本专栏 订阅专栏 解锁全文 超级会员免费看
    Docker 构建报错：Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for conne
    甘蓝的专栏
    03-15 2万+
    记录一次 Docker 构建失败的问题。
    【20250604】【项目实战】【亲测可用】Get https://registry-1.docker.io/v2/: net/http: request canceled
    本本本添哥
    11-21 1万+
    【异常】Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for connection。
    dify docker部署安装失败，获取镜像超时 https://registry-1.docker.io/v2/ 一定能解决的方案
    03-14
    主要出现的错误是：访问 https://registry-1.docker.io/v2/ 超时，网上各种方法都尝试后无法解决。特别是更换为国内镜像源，重启docker后仍然无效，还是报这个错误。 无法解决的主要原因是国内镜像源都只提供给自己的用户免费使用，对游客不开放，例如：阿里云镜像只允许在阿里云的服务器中访问镜像源地址，而且时间也有限制。 这个文件是已经配置好直接可用的配置文件。
    详解docker国内镜像拉取和镜像加速registry-mirrors配置修改
    01-11
    由于国内访问直接访问Docker hub网速比较慢，拉取镜像的时间就会比较长。一般我们会使用镜像加速或者直接从国内的一些平台镜像仓库上拉取。 我比较常用的是网易的镜像中心和daocloud镜像市场。 网易镜像中心：https://c.163.com/hub#/m/home/ daocloud镜像市场：https://hub.daocloud.io/ 我们可以先查看下自己的镜像，使用命令： [root@localhost docker]# docker images [root@localhost docker]# docker images REPOSITORY
    解决Docker pull时报错：https://registry-1.docker.io/v2/
    最新发布
    2501_90839023的博客
    10-31 381
    这个错误表明Docker客户端尝试访问Docker Hub或其他Docker注册中心时出现了问题。具体来说，是在尝试获取注册中心API的响应时遇到了错误。可能的原因包括网络问题、认证问题、注册中心URL不正确或者注册中心服务本身不可用。重新执行 ：docker docker pull。如以上都没有问题，下面考虑docker换源。2，查看docker服务运行状态。重启docker服务。
    Docker pull时报错：https://registry-1.docker.io/v2/
    qq_39843371的博客
    02-18 3830
    https://registry-1.docker.io/v2/地址总是无法访问，镜像拉取不下来，查了很多帖子说是这个地址被墙了，但是使用proxy还是无法拉取到镜像，最后使用了方案1解决了问题。
    解决Docker 无法连接到官方镜像仓库
    jc2255的博客
    08-20 5861
    摘要：Docker无法连接官方镜像仓库时，通常由国内网络问题导致。推荐配置阿里云镜像加速器作为首要解决方案，可大幅提升拉取速度。其他方案包括使用公共镜像源、检查DNS设置、配置代理或重启Docker服务。避免使用无效调试方法如ping测试或手动下载镜像。通过运行测试镜像可验证修复效果，国内用户应优先采用镜像加速方案确保稳定访问。（149字）
    在执行Dockerfile时出现Get https://registry-1.docker.io/v2/错误的解决方案
    reg183的专栏
    07-22 6730
    在执行Dockerfile时出现以下问题 [root@localhost test]# docker-compose up Pulling redis (redis:alpine)... ERROR: Get https://registry-1.docker.io/v2/: read tcp 192.168.137.151:39088->54.161.109.204:443: read: connection reset by peer 可以通过配置阿里云的镜像解决 { "registry-m
    【异常】docker-compose up -d提示执行ERROR: Get https://registry-1.docker.io/v2/: net/http: request canceled
    本本本添哥
    10-21 4986
    命令启动 Milvus 服务时，遇到了网络错误 “read: connection reset by peer”，这通常意味着 Docker 在尝试从 Docker Hub 拉取镜像时连接被重置。这个问题可能是由于多种原因引起的，比如网络不稳定、防火墙或代理设置问题等。如果你在中国大陆，Docker Hub 的访问速度可能会比较慢或者不稳定。你可以考虑更换为国内的镜像加速器，例如阿里云、腾讯云或 DaoCloud 提供的镜像加速服务。使用ctrl+c推出vi，然后输入以下内容保存。
    【Docker】ERROR: Get “https://registry-1.docker.io/v2/“: context deadline exceeded
    HEX9CF的技术博客
    02-28 8472
    错误：获取 “https://registry-1.docker.io/v2/” 时出错：net/http：在等待连接时请求被取消（等待标头时客户端超时）。Docker在尝试从默认的Docker镜像仓库（registry-1.docker.io）下载镜像时，由于网络问题导致超时。创建 Docker 配置目录。重新加载 Docker 配置。修改Docker的配置文件。在打开的配置文件中，添加。重启 Docker 服务。
    docker 在拉取镜像超时ERROR: Get “https://registry-1.docker.io/v2/
    Ilikefoodfoodfood的博客
    09-18 2258
    https://registry-1.docker.io/v2/不能访问，需要配置加速。
    Error response from daemon: Get https://registry-1.docker.io/v2/: dial tcp: lookup registry-1.docker
    01-20
    文章目录异常说明具体做法: 异常说明 情景还原: 用docker拉取jenkins最新版本 docker pull jenkins/jenkins:lts报了这个错误: Error response from daemon: Get https://registry-1.docker.io/v2/: dial tcp: lookup registry-1.docker 一通百度，发现原来是dns服务器的错误，把服务器改成8.8.8.8或者114.114.114.114即可 具体做法: vim /etc/sysconfig/network-scripts/ifcfg-ens33 vim /et
    解决Docker拉取镜像报错：Get https://registry-1.docker.io/v2/: 报错
    qq_33650333的博客
    03-20 3501
    解决Docker拉取镜像报错： Get “https://registry-1.docker.io/v2/”: net/http: request canceled while waiting for connection问题描述Get "https://registry-1.docker.io/v2/"是docker官方的镜像源，下载很慢的，一般会自己指定国内映射的加速镜像源。
    Docker镜像源拉取失败超时 Error response from daemon: Get “https://registry-1.docker.io/v2/“解决方案
    weixin_45458037的博客
    03-10 2万+
    这个错误表明Docker客户端尝试访问Docker Hub或其他Docker注册中心时出现了问题。可能的原因包括网络问题、认证问题、注册中心URL不正确或者注册中心服务本身不可用。原文链接：https://blog.csdn.net/qingzhumuqingfeng/article/details/144094325。运行systemctl status docker（Linux系统）查看Docker服务是否正在运行。确保你的机器可以访问互联网，特别是Docker Hub或你所使用的私有注册中心。
    Docker无法连接到官方镜像仓库（registry-1.docker.io）
    2404_87143740的博客
    08-15 2225
    你遇到的问题是Docker无法连接到官方镜像仓库（registry-1.docker.io），这通常由网络原因或镜像源配置问题引起。下面是详细的分析和解决方案：国内访问Docker Hub较慢，建议使用阿里云、DaoCloud等提供的镜像加速服务。
    Docker Registry
    qq_36733838的博客
    11-04 5137
    一个registry是一个存储和内容交付系统，其中维护着若干命名的Docker镜像，这些镜像有不同的标记版本。（例如：有一个镜像名字叫 hello/world，它有两个tags分别是2.0和2.1）用户通过使用 docker push 和 docker pull 命令与 registry 进行交互。（例如：docker pull registry-1.docker.io/hello/world:2.1）前面说了，registry是一个存储系统，它存储的是Docker镜像。那么，镜像到底存到哪里呢？
    完美解决Docker pull时报错：https://registry-1.docker.io/v2/
    热门推荐
    唐可盐的专栏
    11-27 8万+
    完美解决Docker pull时报错：Error response from daemon: Get "https://registry-1.docker.io/v2/": context deadline exceeded (Client.Timeout exceeded while awaiting headers)
    解决Error Get “https://registry-1.docker.io/v2/“:环境报错问题
    计算机视觉领域
    07-10 1607
    解决 docker: Error response from daemon: Get “https://registry-1.docker.io/v2/
    ERROR: Get “https://registry-1.docker.io/v2/“: net/http: request canceled while waiting for connecti
    neo_liukun的专栏
    09-27 2756
    重启docker 服务：systemctl restart docker.service。vim /etc/docker/daemon.json 增加镜像地址。处理这个连接超时，最基础的方法就是换镜像源，网上也有很多方法介绍。输入内容：IP地址 registry-l.doker.io.但是没用，于是我在网上找到了另一种手法。
    Docker拉取镜像报错：ERROR: Get "https://registry-1.docker.io/v2/": dial tcp超时如何解决？
    09-03
    当Docker拉取镜像时出现 'ERROR: Get "https://registry-1.docker.io/v2/": dial tcp超时' 错误，通常是由于网络问题导致无法连接到Docker官方镜像仓库。以下是一些可能的解决方案： ### 1. 检查网络连接 确保你的网络连接正常，尝试访问其他网站以确认网络是否可用。可以使用 `ping` 命令测试网络连通性，例如： ```bash ping www.google.com ``` ### 2. 更换Docker镜像源 国内访问Docker官方镜像仓库可能会受到网络限制，更换为国内的镜像源可以显著提高拉取速度和稳定性。 #### 方式一：修改 `daemon.json` 文件 编辑 `/etc/docker/daemon.json` 文件（如果文件不存在则创建），添加以下内容： ```json { "registry-mirrors": ["https://registry.docker-cn.com"] } ``` 然后重启Docker服务： ```bash sudo systemctl restart docker ``` #### 方式二：使用阿里云镜像源 阿里云为每个用户提供了独立的镜像加速地址，可以登录阿里云控制台获取自己的加速地址。同样修改 `daemon.json` 文件： ```json { "registry-mirrors": ["https://<your-aliyun-mirror>.mirror.aliyuncs.com"] } ``` 之后重启Docker服务。 ### 3. 检查防火墙设置 确保防火墙没有阻止Docker的网络请求。可以临时关闭防火墙进行测试： ```bash sudo systemctl stop firewalld # 对于CentOS/RHEL系统 sudo ufw disable # 对于Ubuntu系统 ``` 测试完成后，建议重新开启防火墙并配置允许Docker相关的网络流量。 ### 4. 增加超时时间 可以通过修改Docker的启动参数来增加超时时间。编辑 `/etc/systemd/system/docker.service` 文件，在 `[Service]` 部分添加或修改 `ExecStart` 行： ```plaintext ExecStart=/usr/bin/dockerd --http-timeout=300s ``` 这里将超时时间设置为300秒。然后重新加载系统服务配置并重启Docker： ```bash sudo systemctl daemon-reload sudo systemctl restart docker ``` ### 5. 检查DNS设置 确保系统的DNS设置正确。可以编辑 `/etc/resolv.conf` 文件，添加公共的DNS服务器，例如： ```plaintext nameserver 8.8.8.8 nameserver 8.8.4.4 ```
    评论 87
    添加红包

    请填写红包祝福语或标题

    个

    红包个数最小为10个

    元

    红包金额最低5元

    当前余额3.43元 前往充值 >
    需支付：10.00元
    成就一亿技术人!
    领取后你会自动成为博主和红包主的粉丝 规则
    hope_wisdom
    发出的红包

    打赏作者

    A-刘晨阳

    你的鼓励将是我创作的最大动力

    ¥1 ¥2 ¥4 ¥6 ¥10 ¥20
    扫码支付：¥1
    获取中
    扫码支付

    您的余额不足，请更换扫码支付或充值

    打赏作者

    实付元
    使用余额支付
    点击重新获取
    扫码支付
    钱包余额 0

    抵扣说明：

    1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
    2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

    余额充值