让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
爱快路由 Docker 镜像源配置教程
教程简介
适用场景
1配置说明
爱快路由内置 Docker 功能，可在路由器上直接运行容器应用。由于爱快自带的默认 Docker 镜像源稳定性较差，甚至会出现故障，强烈建议配置轩辕镜像专属域名作为加速源。
爱快 4.0：高级服务 → Docker → 镜像仓库 → 镜像源
爱快 3.x：高级应用 → 插件管理 → 添加 → 镜像库下载
请根据您的爱快版本选择下方对应的配置教程。如果您使用的是 4.0 版本，请直接查看「爱快 4.0」标签页，按截图逐步操作即可。
爱快 4.0 升级注意事项：根据爱快官方公告，爱快 4.0 的 32 位系统不支持 Docker 和应用市场。若您当前为 32 位系统且需要使用 Docker，请勿升级到 4.0，可继续留在 3.x 并按「爱快 3.x」标签页配置镜像源；若计划升级到 4.0，请先将系统切换为 64 位（软路由用户建议使用 64 位系统进行刷机）。
2选择版本并配置
系统要求：本教程适用于爱快 4.0 64 位系统。32 位系统不支持 Docker 和应用市场——若您为 32 位且需使用 Docker，请勿升级到 4.0；如需升级，请切换至 64 位系统。详见爱快 4.0 升级注意事项。
为什么要配置？爱快 4.0 自带的默认 Docker 镜像源稳定性较差，部分节点甚至会出现故障，导致镜像搜索或下载失败。我们已实测确认：在爱快 4.0 中配置轩辕镜像专属域名后，可以正常搜索、下载 Docker 镜像。
开始之前，请先登录轩辕镜像控制台，在左侧「专属域名」菜单中复制您的专属域名（格式如***.xuanyuan.run）。 爱快 4.0 推荐使用专属域名，无需填写用户名和密码。
一、进入镜像源设置
- 登录爱快路由管理后台，在左侧菜单栏找到 「高级服务」，点击展开后选择 「Docker」。
- 在 Docker 管理页面顶部的标签栏中，点击 「镜像仓库」。
- 点击页面右上角的蓝色按钮 「镜像源」，打开镜像源设置窗口。
图 1：依次点击「Docker」→「镜像仓库」→「镜像源」（对应步骤 ① ② ③）
二、添加轩辕镜像源
- 在弹出的 「镜像源设置」 窗口中，点击右上角的 「添加」 按钮。
- 在 「添加镜像源」 弹窗中，左侧协议下拉框保持默认的 「https://」 即可，无需修改。
- 在右侧输入框中填写您的专属域名，只填域名本身，不要带 https:// 前缀，例如：
***.xuanyuan.run - 在 「备注」 输入框中填写 「轩辕镜像」。
- 点击 「安装」 按钮，完成本条镜像源的添加。
图 2：协议保持 https://，输入框只填专属域名（不带 https://），备注填「轩辕镜像」，点击「安装」
填写注意：协议下拉框已默认选中 https://，右侧输入框只需填写域名（如 ***.xuanyuan.run），不要在输入框中重复填写 https://，也不要在末尾添加多余斜杠。
三、调整优先级并保存
爱快自带的默认镜像源稳定性较差，甚至会出现故障。添加「轩辕镜像」后，必须将其拖动到列表第一位，确保优先使用轩辕镜像加速拉取。
- 添加成功后，在 「镜像源设置」 列表中可以看到「轩辕镜像」条目。爱快会按从上到下的顺序依次尝试各个镜像源，请按住左侧的六点拖拽图标，将「轩辕镜像」拖动到列表最顶部。
- 确认「轩辕镜像」位于第一位后，点击窗口左下角的 「保存」 按钮。
图 3：由于默认镜像源不稳定，需将「轩辕镜像」拖到列表第一位（步骤 ④），然后点击「保存」（步骤 ⑤）
四、确认重启 Docker
- 点击「保存」后，系统会弹出提示：「修改镜像源配置需要重启 docker，服务重启过程中容器与插件应用暂不可用，是否重启？」
- 点击 「确定」，等待 Docker 服务重启完成，新配置即可生效。
图 4：保存后弹出重启确认框，点击「确定」重启 Docker（步骤 ⑥）
重启提示：Docker 重启期间，正在运行的容器和插件应用会短暂中断。建议在业务低峰期操作，或提前停止重要容器。
五、验证配置是否成功
配置完成并重启 Docker 后，建议立即下载一个常用镜像来验证加速是否生效。以下以 nginx 为例：
- 回到 「镜像仓库」 页面，在左上角搜索框中输入 「nginx」 并搜索。
- 在搜索结果中找到官方 nginx 镜像，点击卡片上的 「下载」 按钮。
图 5：搜索 nginx（步骤 ⑦），点击「下载」按钮（步骤 ⑧）
- 在弹出的 「下载镜像」 窗口中，从 「镜像标签」 下拉框选择需要的版本（如
1.30或latest）。 - 点击 「确定」 开始下载。
图 6：选择镜像标签（步骤 ⑨），点击「确定」开始下载（步骤 ⑩）
- 切换到顶部 「本地镜像」 标签，再点击 「下载中」 子标签，即可看到镜像正在下载（状态显示「下载中……」）。
图 7：在「本地镜像 → 下载中」查看下载进度（步骤 ⑪）
- 等待下载完成后，切换回 「本地镜像」 标签，即可在列表中看到已下载的镜像（如 nginx 1.30），表示配置成功。
图 8：镜像下载成功，配置验证通过
配置成功！看到镜像出现在「本地镜像」列表中，说明轩辕镜像源已正常工作。之后您在「镜像仓库」中搜索并下载的任何镜像，都会优先通过轩辕镜像加速拉取。
常见问题
Q：爱快 4.0 找不到 Docker 入口？
爱快 4.0 的 32 位系统不支持 Docker 和应用市场。若您为 32 位系统，请勿升级到 4.0，可留在 3.x 使用 Docker；如需使用 4.0 的 Docker 功能，请切换至 64 位 系统。详见爱快官方 4.0 升级注意事项。
Q：爱快 4.0 配置后仍然拉取失败？
- 确认协议下拉框为
https://，输入框只填域名（不要在输入框中带 https://） - 确认「轩辕镜像」已拖动到列表最顶部（优先级最高）
- 确认保存后已点击「确定」重启 Docker 服务
- 确认专属域名复制正确，且账户仍有可用流量
Q：爱快 3.x 已配置镜像仓库，但拉取镜像失败或镜像源无法生效？
爱快路由系统 3.7.22 版本的 Docker 插件在加载自定义镜像源时存在已知缺陷，可能导致镜像仓库地址保存后仍无法正常使用。该问题与轩辕镜像服务本身无关，属于爱快固件侧的行为。
- 降级系统版本（推荐）：将固件降级至 3.7.19，该版本下 Docker 镜像源配置可正常生效。
- 使用离线上传方式：在其他设备上拉取镜像后导出为 tar 包，上传至爱快路由导入。
- 升级到 4.0：如条件允许，升级至爱快 4.0 后按新版教程配置，体验更稳定。
3流量耗尽错误提示
当您的流量用尽时，拉取镜像会显示以下错误，请及时充值：
当您拉取镜像时返回 402 Payment Required 错误，表示流量已耗尽。请立即充值流量包以继续使用镜像服务。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"