直接在群晖NAS上配置国内镜像加速器最有效，DSM 7.2+原生支持，需通过SSH编辑/var/packages/Docker/etc/daemon.json填入三个HTTPS加速地址，重启pkgctl-Docker服务并验证生效。

直接在群晖NAS上配置国内镜像加速器，是解决镜像拉取慢、超时、失败最有效的方式。2026年实测稳定的加速源已覆盖主流NAS平台，操作不复杂但细节决定成败。

确认设备支持与当前状态

群晖DSM 7.2及以上系统原生支持Docker镜像加速配置，无需额外安装组件。操作前先检查：

• 进入“Docker”套件 → “设置” → 查看“注册表镜像”栏是否为空；若已有内容，建议先清空再重新配置
• 通过SSH登录群晖（需在控制面板→终端机和SNMP中启用SSH），执行docker info | grep "Registry Mirrors"，输出为空说明尚未生效
• 避免使用DSM图形界面编辑配置文件——权限限制易导致保存失败或格式错误

填写合法、多源、HTTPS的加速地址

群晖的Docker服务实际使用的是标准Docker daemon，配置文件路径为/var/packages/Docker/etc/daemon.json（非通用Linux的/etc/docker/daemon.json）。必须按以下规范操作：

• 用SSH执行：sudo vi /var/packages/Docker/etc/daemon.json
• 填入2026年持续可用的三源组合（免注册、全HTTPS、无地域限制）：

{ "registry-mirrors": [ "https://docker.xuanyuan.me", "https://docker.1ms.run", "https://docker.m.daocloud.io" ] }

• 每条地址必须以https://开头，结尾不加斜杠
• 多个地址用英文逗号分隔，整个JSON需语法正确（可用sudo dockerd --validate快速校验）
• 不推荐只填单个源——2026年4月曾出现某高校镜像站同步延迟3小时，多源可自动 fallback

重启服务并验证是否真正生效

群晖不能仅靠图形界面重启Docker，必须触发底层daemon重载：

• 执行命令：sudo synoservice --restart pkgctl-Docker（这是群晖专用重启方式）
• 等待约10秒后，再次运行docker info | grep "Registry Mirrors" -A 1，应清晰显示你填入的三个域名
• 实测验证：拉取一个中等体积镜像，例如docker pull alpine:latest，正常应在5秒内完成，无TLS handshake timeout报错
• 若仍失败，大概率是DNS解析问题——可在同一daemon.json中追加"dns": ["8.8.8.8", "1.1.1.1"]字段后重试

日常维护与异常兜底建议

加速器不是一劳永逸的开关，需配合简单运维习惯：

• 每月检查一次加速源状态：访问https://docker.xuanyuan.me/v2/，返回{"errors":[{"code":"UNAUTHORIZED","message":"authentication required"}]}即表示服务在线（401是正常响应）
• 遇到特定镜像拉取失败（如gcr.io或k8s.gcr.io），可临时改用DaoCloud前缀模式：m.daocloud.io/gcr.io/google-containers/busybox:1.29
• 保留SSH拉取能力：当图形界面卡死或配置失效时，直接用docker pull --platform linux-amd64 xxx指定架构，绕过GUI限制