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 错误，表示流量已耗尽。请立即充值流量包以继续使用镜像服务。
