群晖 NAS Docker 镜像源配置教程

1

群晖 NAS Docker 镜像配置

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

2

群晖 NAS Docker 配置步骤

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

点击图片可查看大图

3

详细配置步骤

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

1. 打开群晖 DSM 控制面板
2. 进入"套件中心"，安装 Docker 套件（如果尚未安装）
3. 打开 Docker 应用
4. 点击左侧的"注册表"
5. 点击右上角的"设置"按钮
6. 在设置窗口中，点击"添加"按钮
7. 填写注册表信息（两种方式任选其一）：
   ✅ 方式一：使用专属域名（推荐）
   • 注册表 URL：填写您的专属域名 ***.xuanyuan.run（登录后，在左侧菜单栏的「个人中心」中查看）
   • 用户名 / 密码：留空即可，无需填写
   🔑 方式二：使用通用域名
   • 注册表 URL：填写 docker.xuanyuan.run
   • 用户名：您在轩辕镜像网站的镜像账户
   • 密码：您在轩辕镜像网站的镜像密码（如忘记密码，可登录后在「个人中心」中重新设置）
8. 点击"测试连接"确认配置正确
9. 点击"保存"完成配置

4

日常使用说明

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

5

流量耗尽错误提示

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

6

群晖NAS使用Docker Compose教程

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

sudo cat /var/packages/ContainerManager/etc/dockerd.json

sudo cat /var/packages/Docker/etc/dockerd.json

{
    "registry-mirrors": [
        "https://***.xuanyuan.run"
    ],
    "data-root": "/var/packages/ContainerManager/var/docker",
    "log-driver": "db",
    "storage-driver": "btrfs"
}

/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

7

Container Manager 注册表查询失败排查

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

docker pull ***.xuanyuan.run/mysql