1群晖 NAS Docker 镜像配置
群晖 NAS 用户可以通过配置 Docker 镜像仓库来使用镜像服务。 请按照下方步骤进行操作,配置完成后即可享受高速的镜像拉取服务。
💡配置前请确保您已在个人中心获取了镜像账户和密码。 群晖NAS推荐使用登录方式拉取,提供更好的安全性和稳定性。
2群晖 NAS Docker 配置步骤
群晖 NAS 用户可以通过以下步骤配置 Docker 镜像仓库:
点击图片可查看大图
⚠️重要提示:由于群晖客户端对专属域名(如 xxx.xuanyuan.run)存在兼容性问题,可能导致注册表搜索结果不全或无法正常显示。
强烈建议:注册表 URL 统一使用 docker.xuanyuan.run,并配合用户名密码验证的方式登录,这样可以确保注册表查询功能正常工作,避免搜索结果不全的问题。
3详细配置步骤
在群晖 NAS 的 Docker 应用中配置镜像仓库:
- 打开群晖 DSM 控制面板
- 进入"套件中心",安装 Docker 套件(如果尚未安装)
- 打开 Docker 应用
- 点击左侧的"注册表"
- 点击右上角的"设置"按钮
- 在设置窗口中,点击"添加"按钮
- 填写注册表信息(请务必按照以下要求填写):
- 注册表 URL:必须填写
docker.xuanyuan.run
⚠️ 注意:不要使用专属域名(如 xxx.xuanyuan.run),否则可能导致注册表搜索结果不全 - 用户名:您的镜像账户(在个人中心的「用户信息」页面查看)
💡 提示:必须填写用户名和密码,使用账号密码验证方式登录 - 密码:您的镜像密码(在个人中心的「用户信息」页面查看)
- 注册表 URL:必须填写
- 点击"测试连接"确认配置正确
- 点击"保存"完成配置
✅配置成功提示:如果测试连接成功,说明配置正确。 之后您就可以通过轩辕镜像仓库快速拉取各种 Docker 镜像了。
💡小贴士:使用轩辕镜像地址:
• 登录地址:docker.xuanyuan.run
4日常使用说明
配置完成后的日常使用方法
后续拉取镜像:
- 在 Docker 应用中,点击左侧的"映像"
- 点击右上角的"添加"按钮
- 选择"从 Docker Hub 添加"
- 在搜索框中输入镜像名称
- 选择需要的镜像版本
- 点击"选择"开始下载
💡小贴士:配置完成后,群晖 NAS 会自动使用轩辕镜像服务拉取镜像, 大大提升下载速度和稳定性。您可以在下载过程中看到明显的速度提升。
5流量耗尽错误提示
当您的流量用尽时,拉取镜像会显示以下错误,请及时充值:
💡当您登录或拉取镜像时返回 402 Payment Required 错误,表示您的流量已耗尽。请立即充值流量包以继续使用镜像服务。
6群晖NAS使用Docker Compose教程
群晖DMS7.2版本后将自己的Docker改名容器服务,套件中心里叫「Container Manager」。 虽然提供了图形界面,但终端设置不生效,如需使用docker compose等命令,需要手动编辑配置文件。
💡版本说明:DMS7.2+版本中,Docker套件已更名为「Container Manager」, 旧版系统请将配置文件路径中的ContainerManager替换为Docker。
配置文件路径:
/var/packages/ContainerManager/etc/dockerd.json/var/packages/Docker/etc/dockerd.json查看当前配置:
首先查看现有的配置文件内容:
sudo cat /var/packages/ContainerManager/etc/dockerd.json
sudo cat /var/packages/Docker/etc/dockerd.json
配置示例:
当前配置文件可能包含多个镜像源,建议保留默认设置,仅修改registry-mirrors部分:
{
"registry-mirrors": [
"https://xxx.xuanyuan.run"
],
"data-root": "/var/packages/ContainerManager/var/docker",
"log-driver": "db",
"storage-driver": "btrfs"
}注意:请将 xxx.xuanyuan.run 替换为您的专属域名
重启Docker服务:
修改配置文件后,需要重启Docker服务使配置生效:
/var/packages/ContainerManager/scripts/start-stop-status stop /var/packages/ContainerManager/scripts/start-stop-status start
/var/packages/Docker/scripts/start-stop-status stop /var/packages/Docker/scripts/start-stop-status start
/var/packages/ContainerManager/scripts/start-stop-status start
/var/packages/Docker/scripts/start-stop-status start
✅配置验证:重启服务后,您就可以在终端中使用 docker compose 等命令, 并且会自动使用轩辕镜像服务,享受丝滑的Docker操作体验。
7Container Manager 注册表查询失败排查
当群晖Container Manager无法正常查询注册表时,通常是网络连通性问题导致。 本模块提供系统性的排查思路和解决方案,帮助您快速恢复镜像拉取功能。
⚠️问题本质:Container Manager注册表查询失败本质上还是群晖Docker网络连通性问题, 因此解决方案主要集中在如何让群晖Docker正常连接到镜像源。
1检查代理设置
确认群晖网络没有配置或开启代理,由于轩辕镜像专业版采用国内地址,因此务必关闭网络代理。
操作步骤:
- 进入DSM控制面板
- 打开"网络"设置
- 检查"代理服务器"配置
- 确保代理功能已关闭
2修改DNS设置
控制面板——网络——手动配置DNS服务器,在里面填写国内公用DNS,一般用阿里的或者114。
操作步骤:
- 控制面板 → 网络
- 选择网络接口(通常是"局域网1")
- 点击"编辑"按钮
- 选择"手动配置DNS服务器"
- 输入上述DNS地址
- 点击"确定"保存设置
3SSH命令行测试
如果前两步完成后Docker注册表仍然无法正常使用,可以通过SSH登录群晖,用命令行拉取测试。 虽说在图形界面无法加载,但是通过SSH可以顺利拉取镜像,只要能够顺利拉取镜像,再在图形界面进行部署,就方便多了。
启用SSH功能:
- 控制面板 → 终端机和SNMP
- 勾选"启用SSH服务"
- 设置端口(默认22)
- 点击"应用"保存设置
SSH连接和镜像拉取:
sudo -i 获取root权限docker pull xxx.xuanyuan.run/mysql
✅成功标志:如果命令行拉取成功,返回NAS的Docker映像页面, 您会发现刚才拉取的镜像已经在里面了,接下来就可以愉快地通过图形界面进行容器的安装。
⚠️仍无法解决?如果命令行拉取也出现异常,请保留具体报错截图,提交工单联系我们技术客服帮您解决。
轩辕镜像配置手册
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
免费版仅支持 Docker Hub 访问,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等;免费版仅支持 docker.io。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务