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

Docker Hello-World 镜像拉取失败或超时问题排查与解决

Docker Hello-World 镜像拉取失败或超时问题通常由默认镜像源访问受限引起。通过修改 daemon.json 配置文件添加国内镜像加速源,并重启 Docker 服务即可解决。操作涉及创建目录、写入 JSON 配置、重载 systemd 及重启服务,验证 Registry Mirrors 字段后重新拉取镜像即可完成修复。

猫巷少女发布于 2026/2/23更新于 2026/9/762 浏览
Docker Hello-World 镜像拉取失败或超时问题排查与解决

遇到 docker run hello-world 报错无法找到本地镜像且拉取超时的情况,通常是因为默认 Docker Hub 在国内访问不稳定导致的。作为开发者,我们常需要配置国内加速源来保证构建和运行的流畅性。

核心思路是修改 Docker 守护进程配置文件 /etc/docker/daemon.json,添加镜像加速器地址。

首先确保目录存在,然后写入配置。注意命令中的空格不能少,否则会导致执行失败:

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.nju.edu.cn"
  ]
}
EOF

配置完成后,必须重载系统配置并重启 Docker 服务才能生效:

sudo systemctl daemon-reload
sudo systemctl restart docker

验证配置是否成功,可以查看 Docker 信息输出,确认 Registry Mirrors 字段下是否有刚才设置的地址。如果显示正常,再次尝试运行测试镜像:

docker run hello-world

此时应该能顺利看到欢迎信息。如果依然超时,建议检查网络环境或更换其他稳定的镜像源地址。

更多推荐文章

查看全部
  • 前端请求后端 404/405/500 状态码排查与解决实战
  • 基于 ESP32 与 MimiClaw 的 Arduino BLDC 无刷电机驱动方案
  • Mac 系统下 Stable Diffusion WebUI 本地部署指南
  • 知网 AIGC 检测原理及论文被判定为 AI 生成的原因分析
  • 从三年前端到 CS 硕士:我在韩国亚大的留学复盘与回归
  • IDEA Claude Code GUI 插件安装配置与功能测试
  • MetaRTC 跨平台 WebRTC SDK 开发入门指南
  • 慎用 ArrayList 的 contains 方法,优先使用 HashSet
  • Java Web 开发入门:核心概念、环境搭建与 Servlet JSP 实战
  • 分布式文件系统 HDFS:常用命令、Web 页面与 Java API 编程实践
  • 深入解析 Stable Diffusion 基石:潜在扩散模型(LDMs)
  • 智能仿真无人机平台多线程实现:任务分配与碰撞规避
  • Java API 实战:从基础爬虫构建到条件数据提取,详解 URL 与正则策略
  • C++ 哈希表封装实战:从原理到 unordered_map 底层优化
  • 4GB 显存限制下构建 LLM 基础开发环境指南
  • 小米手机端 Agent 落地,撬开智能家居十年困局
  • Python 第三方库 Flet:一套代码构建跨平台桌面与 Web 应用
  • IQuest-Coder-V1 与 Meta-Llama-Code 开源模型部署对比
  • 深入理解 LRU 和 LFU 缓存算法的 Java 实现
  • 基于闲置设备部署 Moltbot 构建私有 AI Agent

相关免费在线工具

  • Base64 字符串编码/解码

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

  • Base64 文件转换器

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

  • Markdown转HTML

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

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online