让 AI 帮你使用轩辕镜像? · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
绿联 NAS Docker 镜像源配置教程
教程简介
适用场景
适用条件
- 适用机型:绿联私有云全系列
- 适用系统版本:UGOS Pro 及以上
- 支持镜像源:docker.io、ghcr.io、gcr.io、k8s.gcr.io 等
1进入 Docker 设置界面
- 打开绿联 NAS 管理后台
- 点击左侧导航栏的「镜像」
- 点击右上角的齿轮图标 ⚙️ 或「设置」
2打开镜像配置页面
在"镜像仓库"页面,找到已有的 DockerHub 项,点击右侧的「镜像源配置」按钮。

绿联 DX4600 专用配置
如果您使用的是绿联 DX4600 系列,请按照下图所示进行配置:

3填写轩辕镜像地址
在弹出的镜像源配置页面中,将镜像源地址设置为你专属的"轩辕镜像地址":
说明:请根据你的账号获取的实际地址填写,*** 是分配给你的用户前缀。

DX4600 填写专属域名
如果您使用的是绿联 DX4600 系列,请按照下图所示填写镜像源地址:

4保存配置
点击右下角的「确定」,保存镜像源设置。
5拉取镜像测试重要
配置保存后,建议拉取常用镜像(如 nginx)验证加速是否生效。
已知问题:镜像仓库无法搜索
绿联 NAS 的「镜像仓库」目前无法正常检索镜像。即使已正确配置轩辕镜像源,在镜像仓库中搜索 nginx:latest 也可能搜不到任何结果。这是绿联系统侧的已知限制,与轩辕镜像服务本身无关。
请改用「公网库」方式直接拉取镜像,操作路径如下:
- 进入 镜像管理 → 本地镜像 → 添加 → 公网库
- 在镜像地址栏填写专属域名加镜像名,例如
***.xuanyuan.run/nginx,点击 确认 开始拉取 - 等待拉取完成;若配置正确,下载速度会明显加快
请将 *** 替换为你的专属域名前缀。

镜像管理 → 本地镜像 → 添加 → 公网库

输入 ***.xuanyuan.run/nginx,点击确认

镜像拉取过程
可选支持的镜像源(高级用法)
如果你希望也访问 ghcr.io、gcr.io、k8s.gcr.io 的镜像,也可以在终端内使用 Podman 或 containerd 自定义镜像源(高级用法,需 SSH 访问 NAS)。
技术说明(可选了解)
轩辕镜像基于国内优化 + 多地缓存,支持:
- 极速拉取 docker.io/library/* 镜像
- 支持 IPv6 访问优化
- 不需要登录认证,自动识别用户
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务