跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

Docker pull 报错 registry-1.docker.io 超时解决方案

Docker pull 请求 registry-1.docker.io 时出现 context deadline exceeded 错误,通常由网络不通或镜像源不可达导致。通过检查网络连接、确认 Docker 服务状态后,若问题依旧,可通过配置/etc/docker/daemon.json 添加国内镜像加速源来解决。修改配置后重载并重启 Docker 服务即可恢复正常拉取。

雾岛听风发布于 2026/3/16更新于 2026/10/998 浏览
Docker pull 报错 registry-1.docker.io 超时解决方案

1、错误描述

root@ubuntu-database:/opt/dify/docker# docker compose up -d
[+] Running 9/9
 ✘ api Error context canceled 15.1s
 ✘ db Error context canceled 15.1s
 ✘ nginx Error context canceled 15.1s
 ✘ redis Error Get "https://registry-1.docker.io/v2/": context deadline exceeded (Client.Timeout exceeded while awaiting headers) 15.1s
 ✘ ssrf_proxy Error context canceled 15.1s
 ✘ worker Error context canceled 15.1s
 ✘ weaviate Error context canceled 15.1s
 ✘ sandbox Error context canceled 15.1s
 ✘ web Error context canceled 15.1s
Error response from daemon: Get "https://registry-1.docker.io/v2/": context deadline exceeded (Client.Timeout exceeded while awaiting headers)

该错误表明 Docker 客户端尝试访问 Docker Hub 或其他 Docker 注册中心时出现了问题,具体是在获取注册中心 API 响应时遇到超时。可能的原因包括网络问题、认证问题或注册中心服务不可用。

2、解决方法

2.1、检查网络连接

确保机器可以访问互联网,特别是 Docker Hub 或私有注册中心。

root@ubuntu-database:/opt/dify/docker# ping www.baidu.com
PING www.a.shifen.com (110.242.68.3) 56(84) bytes of data.
64 bytes from 110.242.68.3: icmp_seq=1 ttl=128 =38.5 ms
64 bytes from 110.242.68.3: icmp_seq=2 ttl=128 =36.4 ms
64 bytes from 110.242.68.3: icmp_seq=3 ttl=128 =52.3 ms
time
time
time

2.2、检查 Docker 服务状态

运行 systemctl status docker(Linux 系统)查看 Docker 服务是否正在运行。

root@ubuntu-database:/opt/dify/docker# systemctl status docker
● docker.service - Docker Application Container Engine
 Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
 Active: active (running) since Wed 2024-11-27 12:04:05 UTC; 55min ago
 TriggeredBy: ● docker.socket
 Docs: https://docs.docker.com
 Main PID: 4766 (dockerd)
 Tasks: 10 Memory: 21.8M (peak: 24.5M) CPU: 479ms CGroup: /system.slice/docker.service

如以上都没有问题,下面考虑 Docker 换源。

2.3、换源

创建目录并编辑配置文件:

sudo mkdir -p /etc/docker
vim /etc/docker/daemon.json

在 /etc/docker/daemon.json 文件中加入以下配置:

{
  "registry-mirrors": [
    "https://docker.registry.cyou",
    "https://docker-cf.registry.cyou",
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://dockertest.jsdelivr.fyi",
    "https://mirror.aliyuncs.com",
    "https://dockerproxy.com",
    "https://mirror.baidubce.com",
    "https://docker.m.daocloud.io",
    "https://docker.nju.edu.cn",
    "https://docker.mirrors.sjtug.sjtu.edu.cn",
    "https://docker.mirrors.ustc.edu.cn",
    "https://mirror.iscas.ac.cn",
    "https://docker.rainbond.cc",
    "https://do.nark.eu.org",
    "https://dc.j8.work",
    "https://gst6rzl9.mirror.aliyuncs.com",
    "https://registry.docker-cn.com",
    "http://hub-mirror.c.163.com",
    "http://mirrors.ustc.edu.cn/",
    "https://mirrors.tuna.tsinghua.edu.cn/",
    "http://mirrors.sohu.com/"
  ],
  "insecure-registries": [
    "registry.docker-cn.com",
    "docker.mirrors.ustc.edu.cn"
  ],
  "debug": true,
  "experimental": false
}

重载配置生效:

sudo systemctl daemon-reload

重启服务:

sudo systemctl restart docker

查看是否配置成功:

docker info

输出示例:

root@ubuntu-database:/etc/docker# docker info
Client:
 Version: 27.3.1
Server:
 Server Version: 27.3.1
 Registry Mirrors:
  https://docker.registry.cyou/
  https://docker-cf.registry.cyou/
  ...
  http://mirrors.sohu.com/
...

重新执行 docker compose up -d,若出现正常启动日志,说明问题已解决。

Docker Info

Success Log

目录

  1. 1、错误描述
  2. 2、解决方法
  3. 2.1、检查网络连接
  4. 2.2、检查 Docker 服务状态
  5. 2.3、换源

更多推荐文章

查看全部
  • FPGA 开发常用软件对比:Vivado、Quartus、ModelSim 详解
  • C++ 异常处理机制:捕获、自定义与实战
  • Llama-Factory 强化学习微调支持与 RLHF 模块进展解析
  • Llama-AVSR 论文精读:基于 LLM 的视听语音识别新框架
  • Stable Diffusion 图生图转视频工作流实战
  • Vibe Coding的感想:从自动补全到 Copilot 的技术与职业全景
  • Android AMS 启动流程源码解析
  • 深度学习模型训练和部署的基本步骤
  • 基于阿里万物识别模型的电力绝缘子无人机巡检实践
  • 2026必备10个降AIGC工具,研究生必看!
  • 前缀和算法详解:高效解决区间求和问题
  • 网络安全入门学习路线与实战指南
  • HarmonyOS RcTag 组件实战:技能标签墙与搜索热词
  • C++ 模板机制与 string 类实战指南
  • 华为预训练大模型白皮书核心观点与技术趋势分析
  • Android 免 Root 自动抢红包工具 AutoRobRedPackage 使用指南
  • Agentic Workflow 是什么?会成为下一个 AI 风口吗?
  • Windows WSL Ubuntu 环境部署 OpenClaw 接入飞书与百炼模型
  • OpenClaw 刚配好就完了?5 步调教,让你的 AI 助手真正“能干活”
  • Git 安装流程与基础使用指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online