让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Unraid Docker 镜像源配置教程
教程简介
在 Unraid Web 界面通过终端写入 Docker 镜像加速配置，使用轩辕镜像专属域名提升 docker.io 镜像拉取速度。
适用场景
适用于 Unraid NAS 等场景。
3终端配置镜像源
- 打开 Unraid Web 管理页面，点击右侧菜单栏中的终端图标（
>_） - 进入终端后，用编辑器打开 Docker 配置文件，并写入下方
registry-mirrors配置
打开配置文件（任选其一）：
使用 nano：
mkdir -p /etc/docker && nano /etc/docker/daemon.json
使用 vim：
mkdir -p /etc/docker && vim /etc/docker/daemon.json
在文件中增加或修改 registry-mirrors 字段（若文件已有其它配置，请保留其余字段；若文件不存在则写入下列完整内容）：
{
"registry-mirrors": ["https://***.xuanyuan.run"]
}4重启 Docker 服务
写入配置后需重启 Docker 服务才能生效。请返回 Unraid Web 页面按以下步骤操作：
- 点击顶部菜单栏的设置（Settings）
- 找到并点击Docker
- 将启用 Docker（Enable Docker）改为否，点击应用（Apply），等待 Docker 服务停止
- 再次将启用 Docker改为是，点击应用，等待 Docker 服务启动完成
5验证与使用
Docker 重启完成后，即可通过 Apps 页面搜索并下载镜像：
- 打开 Unraid 的 Apps 页面
- 搜索需要的镜像（例如
nginx） - 点击安装/下载，系统会通过轩辕镜像加速拉取
也可在终端中验证配置是否已加载：
cat /etc/docker/daemon.json
docker info | grep -A 5 "Registry Mirrors"
6配置说明
- HTTPS 协议头：镜像源地址须为完整 URL，例如
https://***.xuanyuan.run，缺少https://可能导致配置无效 - 仅对 docker.io 生效：
registry-mirrors只加速 Docker Hub（docker.io）镜像；GHCR、GCR 等仓库需使用专属域名完整路径拉取，参见 专属域名拉取教程 - 配置持久性：Unraid 重启后
/etc/docker/daemon.json通常保留；若升级系统后失效，请重新检查并重启 Docker
7流量耗尽提示
当您的流量用尽时，拉取镜像会显示以下错误，请及时充值：
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 或 PAYMENT_REQUIRED 错误，表示流量已耗尽。请立即充值流量包以继续使用镜像服务。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"