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

Docker 拉取镜像失败报错及配置镜像源解决方案

Docker 拉取 redis 镜像时出现连接超时或解析失败错误。通过检查网络连通性后,在 Docker Desktop 设置中配置 Docker Engine 的 registry-mirrors 和 dns 参数,使用国内镜像加速源解决网络连接问题,最终成功完成 langfuse 环境部署。

微码行者发布于 2026/3/15更新于 2026/10/19103 浏览
Docker 拉取镜像失败报错及配置镜像源解决方案

在安装 Langfuse 过程中,遇到 Docker 拉取镜像失败错误:

Error response from daemon: failed to resolve reference "docker.io/library/redis:7": failed to do request: Head "https://registry-1.docker.io/v2/library/redis/manifests/7": dialing registry-1.docker.io:443 container via direct connection because Docker Desktop has no HTTPS proxy: connecting to registry-1.docker.io:443: dial tcp [2a03:2880:f12c:83:face:b00c:0:25de]:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.

截图如下:

文章配图

执行 ping 命令验证网络连通性:

ping registry-1.docker.io

结果显示:

文章配图

经过排查,最终通过配置 Docker Engine 解决该问题。打开 Docker Desktop 设置,进入 Docker Engine 页面,将配置内容修改为包含镜像加速源和 DNS 的配置:

{
  "builder": {
     
       
       
    
  
   
     
  
   
    
    
    
    
    
    
    
  
   
    
    
  

"gc"
:
{
"defaultKeepStorage"
:
"20GB"
,
"enabled"
:
true
}
}
,
"features"
:
{
"buildkit"
:
true
}
,
"registry-mirrors"
:
[
"https://dockerpull.pw"
,
"https://dockerhub.icu"
,
"https://hub.rat.dev"
,
"https://register.librax.org"
,
"https://docker-0.unsee.tech"
,
"https://docker-cf.registry.cyou"
,
"https://docker.1panel.live"
]
,
"dns"
:
[
"8.8.8.8"
,
"114.114.114.114"
]
}

如图所示:

文章配图

修改之后,点击【应用并重启】按钮。

然后再执行 docker compose up 命令:

文章配图

再次查看 Docker 界面,确认已安装成功:

文章配图

更多推荐文章

查看全部
  • VSCode Copilot MCP 快速上手指南
  • Linux 线程池封装与实现详解
  • AI 大模型驱动 Web UI 自动化测试:Playwright 与 RobotFramework 实践
  • AG-UI:构建 AI 前端交互的统一协议
  • 前端核心面试题与实战知识点梳理
  • Spring Boot 与 JDK、Maven、MyBatis-Plus、Tomcat 版本对应
  • 树莓派 4B 连接大疆 M300 RTK 无人机开发指南
  • 路径类动态规划入门:3 道经典例题全解析
  • WebMCP:浏览器原生 AI 交互新范式
  • Python 爬虫实战:将网络小说保存为本地 TXT 文件
  • OpenClaw 结合 Kimi K2.5 本地私有化部署与办公自动化实战
  • 从记忆化搜索到动态规划:DP 核心思想与实战解析
  • 飞算 JavaAI 工具箱:项目文档生成与代码规范优化实践
  • Qwen3-VL-WEBUI 部署与 AI 绘画使用指南
  • Rust 系统编程核心技能:文件操作与网络编程基础及进阶
  • Python 月相可视化系统:从天文计算到 Web 界面生成
  • Python + AI 自动化生成每日工作汇报工具
  • C/C++ 经典笔试编程题解析与代码实现
  • 十个实用的 AI 提示词工程技巧
  • 基于 Python Flask + Vue3 的学生信息管理系统设计与实现

相关免费在线工具

  • 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