群晖NAS使用轩辕镜像

在群晖NAS中配置Docker使用轩辕镜像服务,享受高速稳定的镜像拉取体验

1
群晖 NAS Docker 镜像配置

群晖 NAS 用户可以通过配置 Docker 镜像仓库来使用镜像服务。 请按照下方步骤进行操作,配置完成后即可享受高速的镜像拉取服务。

💡配置前请确保您已在个人中心获取了镜像账户和密码。 群晖NAS推荐使用登录方式拉取,提供更好的安全性和稳定性。

2
群晖 NAS Docker 配置步骤

群晖 NAS 用户可以通过以下步骤配置 Docker 镜像仓库:

点击图片可查看大图

⚠️重要提示:由于群晖客户端对专属域名(如 xxx.xuanyuan.run)存在兼容性问题,可能导致注册表搜索结果不全或无法正常显示。
强烈建议:注册表 URL 统一使用 docker.xuanyuan.run,并配合用户名密码验证的方式登录,这样可以确保注册表查询功能正常工作,避免搜索结果不全的问题。

3
详细配置步骤

在群晖 NAS 的 Docker 应用中配置镜像仓库:

  1. 打开群晖 DSM 控制面板
  2. 进入"套件中心",安装 Docker 套件(如果尚未安装)
  3. 打开 Docker 应用
  4. 点击左侧的"注册表"
  5. 点击右上角的"设置"按钮
  6. 在设置窗口中,点击"添加"按钮
  7. 填写注册表信息(请务必按照以下要求填写):
    • 注册表 URL:必须填写 docker.xuanyuan.run
      ⚠️ 注意:不要使用专属域名(如 xxx.xuanyuan.run),否则可能导致注册表搜索结果不全
    • 用户名:您的镜像账户(在个人中心的「用户信息」页面查看)
      💡 提示:必须填写用户名和密码,使用账号密码验证方式登录
    • 密码:您的镜像密码(在个人中心的「用户信息」页面查看)
  8. 点击"测试连接"确认配置正确
  9. 点击"保存"完成配置

配置成功提示:如果测试连接成功,说明配置正确。 之后您就可以通过轩辕镜像仓库快速拉取各种 Docker 镜像了。

💡小贴士:使用轩辕镜像地址:
• 登录地址:docker.xuanyuan.run

4
日常使用说明

配置完成后的日常使用方法

后续拉取镜像:

  1. 在 Docker 应用中,点击左侧的"映像"
  2. 点击右上角的"添加"按钮
  3. 选择"从 Docker Hub 添加"
  4. 在搜索框中输入镜像名称
  5. 选择需要的镜像版本
  6. 点击"选择"开始下载

💡小贴士:配置完成后,群晖 NAS 会自动使用轩辕镜像服务拉取镜像, 大大提升下载速度和稳定性。您可以在下载过程中看到明显的速度提升。

5
流量耗尽错误提示

当您的流量用尽时,拉取镜像会显示以下错误,请及时充值

docker pull docker.xuanyuan.run/redis Using default tag: latest Error response from daemon: unknown: {"errors":[{"code":"PAYMENT_REQUIRED","message":"capacity has use up","detail":[{"Type":"repository","Name":"library/*","Action":"pull"}]}]}

💡当您登录或拉取镜像时返回 402 Payment Required 错误,表示您的流量已耗尽。请立即充值流量包以继续使用镜像服务。

6
群晖NAS使用Docker Compose教程

群晖DMS7.2版本后将自己的Docker改名容器服务,套件中心里叫「Container Manager」。 虽然提供了图形界面,但终端设置不生效,如需使用docker compose等命令,需要手动编辑配置文件。

💡版本说明:DMS7.2+版本中,Docker套件已更名为「Container Manager」, 旧版系统请将配置文件路径中的ContainerManager替换为Docker。

配置文件路径:

DMS7.2+版本
/var/packages/ContainerManager/etc/dockerd.json
旧版系统
/var/packages/Docker/etc/dockerd.json

查看当前配置:

首先查看现有的配置文件内容:

DMS7.2+版本
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服务使配置生效:

DMS7.2+版本
/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

配置验证:重启服务后,您就可以在终端中使用 docker compose 等命令, 并且会自动使用轩辕镜像服务,享受丝滑的Docker操作体验。

7
Container Manager 注册表查询失败排查

当群晖Container Manager无法正常查询注册表时,通常是网络连通性问题导致。 本模块提供系统性的排查思路和解决方案,帮助您快速恢复镜像拉取功能。

⚠️问题本质:Container Manager注册表查询失败本质上还是群晖Docker网络连通性问题, 因此解决方案主要集中在如何让群晖Docker正常连接到镜像源。

1检查代理设置

确认群晖网络没有配置或开启代理,由于轩辕镜像专业版采用国内地址,因此务必关闭网络代理。

操作步骤:

  1. 进入DSM控制面板
  2. 打开"网络"设置
  3. 检查"代理服务器"配置
  4. 确保代理功能已关闭

2修改DNS设置

控制面板——网络——手动配置DNS服务器,在里面填写国内公用DNS,一般用阿里的或者114。

阿里DNS
223.5.5.5
114DNS
114.114.114.114

操作步骤:

  1. 控制面板 → 网络
  2. 选择网络接口(通常是"局域网1")
  3. 点击"编辑"按钮
  4. 选择"手动配置DNS服务器"
  5. 输入上述DNS地址
  6. 点击"确定"保存设置

3SSH命令行测试

如果前两步完成后Docker注册表仍然无法正常使用,可以通过SSH登录群晖,用命令行拉取测试。 虽说在图形界面无法加载,但是通过SSH可以顺利拉取镜像,只要能够顺利拉取镜像,再在图形界面进行部署,就方便多了。

启用SSH功能:
  1. 控制面板 → 终端机和SNMP
  2. 勾选"启用SSH服务"
  3. 设置端口(默认22)
  4. 点击"应用"保存设置
SSH连接和镜像拉取:
1. 连接群晖:使用PuTTY或其他终端软件登录到NAS
2. 获取权限:输入 sudo -i 获取root权限
3. 拉取镜像:输入拉取命令测试连接
docker pull xxx.xuanyuan.run/mysql
示例:拉取MySQL镜像(请将xxx.xuanyuan.run替换为您的专属域名)

成功标志:如果命令行拉取成功,返回NAS的Docker映像页面, 您会发现刚才拉取的镜像已经在里面了,接下来就可以愉快地通过图形界面进行容器的安装。

⚠️仍无法解决?如果命令行拉取也出现异常,请保留具体报错截图,提交工单联系我们技术客服帮您解决。

用户好评

来自真实用户的反馈,见证轩辕镜像的优质服务

oldzhang的头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅,大镜像也能快速完成下载。"

免费获取在线技术支持请 提交工单,官方QQ群:13763429 。
轩辕镜像面向开发者与科研用户,提供开源镜像的搜索和访问支持。所有镜像均来源于原始仓库,本站不存储、不修改、不传播任何镜像内容。
商务:17300950906
©2024-2025 源码跳动