跳到主要内容
极客日志极客日志面向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/10/24103 浏览
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

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

更多推荐文章

查看全部
  • Python 集成 RocketMQ 生产消费全流程实战
  • Vercel agent-browser 深度解析:AI 驱动浏览器自动化实践
  • C 语言初阶算法习题实战解析
  • Cursor 中 MCP 服务配置与使用指南
  • python-can 模块使用记录
  • 基于 Higress 网关将 REST API 转换为 MCP Server 工具
  • 基于 Netty 的轻量斗地主服务器部署与内网穿透方案
  • OpenClaw 对接飞书机器人:消息无响应与 Gateway 断连排查
  • 《AI 赋能:AI 重新定义产品经理》书籍核心内容梳理
  • 面向前端开发者的 Claude Code、Codex 与 OpenClaw 共享插件方案
  • Java Map 和 Set 数据结构详解
  • Python 学习路线:从入门到精通的完整指南
  • Arduino BLDC 自主巡逻机器人:避障与路径规划实战
  • 端侧全模态大模型 Megrez-3B-Omni 实测与部署指南
  • 荣耀 MWC 2026 发布 Robot Phone 与人形机器人,探索 AI 硬件生态
  • LeetCode 128:哈希集合求解最长连续序列
  • 基于 Qwen3-VL 与 LLaMA-Factory 的 Grounding 任务 LoRA 微调实战
  • 车载测试:基于 Python 与 CAPL 的程控电源协同控制方案
  • System Verilog 教程:从基础到高级验证
  • Python 数据分析基础:NumPy 核心用法详解

相关免费在线工具

  • 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