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

群晖 Docker 拉取镜像超时及网络代理配置方案

群晖 NAS 在特定网络环境下使用 Docker 拉取镜像时出现连接超时错误。经排查,Docker 服务本身正常,问题源于 DNS 解析受限及国际出口 HTTPS 被阻断。国内镜像源无法解决此问题。最终解决方案是通过 systemd 为 Container Manager 配置 HTTP/HTTPS 代理,使流量经由代理服务器访问公网,从而稳定完成镜像拉取。

筑梦师发布于 2026/3/16更新于 2026/5/3022 浏览
sudo docker pull rustfs/rustfs
Using default tag: latest
Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

群晖 DSM 7 + Container Manager Docker Registry 无法访问解决方案

核心结论

在当前网络环境下,Docker 或 Container Manager 若要正常拉取镜像,配置 HTTP/HTTPS 代理是唯一可行方案。

问题分析

1. Docker 服务本身正常
  • dockerd.json 已正确生效
  • docker system info 能看到 Registry Mirrors
  • Container Manager 服务运行正常
2. DNS 解析受限
  • 能 ping 通公共 IP(如 223.5.5.5)
  • 但域名解析失败
  • 修改公共 DNS 无效
3. 国际出口 HTTPS 被阻断
  • curl https://registry-1.docker.io 超时
  • 直接访问 Docker Hub IP 也超时
4. 镜像源并非万能

即使配置了国内 mirror:

  • mirror 域名本身也需要 DNS 解析
  • 部分步骤仍会回源校验
  • 在网络受限情况下依然无法使用

网络环境画像

这是一个典型的受控网络环境:

  • 能访问部分国内地址
  • 不允许直接访问国际 HTTPS
  • 不允许自由 DNS 查询

在此类网络中,所有直连方案都会失败。

解决方案:配置系统级代理

Docker 需要可用的 HTTPS 出口以访问 Docker Hub 并完成 TLS 握手。通过代理统一出网是稳定路径。

1. 创建 systemd override

执行以下命令编辑服务配置:

systemctl edit pkg-ContainerManager-dockerd.service

在编辑器中写入以下内容(假设代理地址为 192.168.1.2:7890):

[Service]
Environment="HTTP_PROXY=http://192.168.1.2:7890"
Environment="HTTPS_PROXY=http://192.168.1.2:7890"
Environment="NO_PROXY=localhost,127.0.0.1,::1,192.168.0.0/16"
2. 重启 Docker 服务

重新加载配置并重启服务:

systemctl daemon-reexec
systemctl restart pkg-ContainerManager-dockerd.service

经验总结

在受控网络环境下排查 Docker 问题时,若出现 Client.Timeout exceeded、域名解析异常或 Docker Hub 直连失败,建议直接配置代理,而非继续尝试更换镜像源。这是效率最高且最稳定的做法。

这不是 Docker 或 NAS 的问题,而是网络边界限制导致的结果。

目录

  1. 群晖 DSM 7 + Container Manager Docker Registry 无法访问解决方案
  2. 核心结论
  3. 问题分析
  4. 1. Docker 服务本身正常
  5. 2. DNS 解析受限
  6. 3. 国际出口 HTTPS 被阻断
  7. 4. 镜像源并非万能
  8. 网络环境画像
  9. 解决方案:配置系统级代理
  10. 1. 创建 systemd override
  11. 2. 重启 Docker 服务
  12. 经验总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Java 阻塞队列原理及生产者 - 消费者模型应用
  • Linux 下 Vim 编辑器使用详解
  • Android System WebView 内核版本更新方法
  • 前端常用可视化图表组件选型指南
  • C++ 伸展树与红黑树详解及核心实现
  • 鸿蒙金融理财全栈项目:合规审计、风险控制与产品创新优化
  • GitHub Copilot Pro 学生免费订阅认证与 VS Code 集成指南
  • 基于 Q-learning 的无人机三维路径规划算法原理与 MATLAB 实现
  • Stable Diffusion 老照片修复实战与避坑指南
  • 基于 DeepSeek 和 Cursor 从零打造智能代码审查工具
  • 全国大学生智能车竞赛智慧医疗机器人惯导与避障思路分享
  • Whisper 与讯飞语音识别方案对比及 Python 实现
  • 程序员转行方向推荐:数据分析师、AI 大模型工程师、产品经理与云计算工程师
  • Linux 基础 IO(四):用户缓冲区深度解析
  • 二分查找算法详解:山峰数组的峰顶索引与寻找峰值
  • AutoGPT 结合 Python 实现 AI 智能体自动化任务指南
  • S2B2C 模式下 AI 智能名片的人脉网络构建与商业价值
  • 在 VSCode 中配置并使用 Clang-Format 进行 C++ 代码自动格式化
  • GitLab 配置与 Git 集成实践
  • 接口测试用例模板详细说明

相关免费在线工具

  • 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