让 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选择版本并配置
版本说明：以下步骤适用于爱快 3.x 经典界面（含 32 位系统）。爱快 3.x 的 32 位系统仍可正常使用 Docker 插件；若您已升级至 4.0，请切换到「爱快 4.0」标签页（4.0 的 32 位系统不支持 Docker）。
爱快 3.x 通过 Docker 插件的「镜像库下载」功能拉取镜像。请先参考爱快 Docker 官方文档完成 Docker 插件的安装。
配置前请先登录轩辕镜像控制台，在左侧「专属域名」菜单中复制您的专属域名（如***.xuanyuan.run或***.xuanyuan.dev，以控制台显示为准）。
一、进入插件管理并添加容器
- 登录爱快路由管理后台，在左侧菜单栏找到 「高级应用」，点击展开后选择 「插件管理」。
- 点击页面上方的 「添加」 按钮，进入新建插件页面。
- 在 「上传方式」 中选择 「镜像库下载」。
二、通过专属域名搜索并下载镜像
- 在 「镜像搜索」 输入框中，按格式填写：
专属域名/镜像名例如：***.xuanyuan.run/nginx或***.xuanyuan.dev/qbittorrent - 点击 「搜索」 按钮，等待搜索结果列表加载。
- 在搜索结果中找到目标镜像，点击对应行的 「进入下载页」。
- 在下载页选择镜像标签并完成下载安装。
搜索格式说明：爱快 3.x 不支持像 4.0 那样单独配置镜像源列表，需在搜索框中直接带上专属域名前缀。格式为专属域名/镜像名，中间用斜杠分隔，不要加 https:// 前缀。
三、验证配置是否成功
若搜索能返回结果且镜像下载安装成功，说明专属域名配置正确。之后每次拉取新镜像，均在「镜像搜索」中使用相同的专属域名/镜像名格式即可。
配置成功！镜像安装完成后可在插件管理列表中看到对应容器。如遇 3.7.22 版本镜像源异常，请参阅下方「常见问题」章节。
常见问题
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访问体验非常流畅，大镜像也能快速完成下载。"