让 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 镜像仓库。首先请参考爱快 Docker 官方文档完成 Docker 的安装。
配置前请确保您已登录网站，并在左侧菜单栏的「专属域名」菜单中获取了专属域名。 爱快路由推荐使用专属域名方式，更加简单便捷。
2爱快路由 Docker 配置步骤
爱快路由用户可以通过以下步骤配置 Docker 镜像仓库：
点击图片可查看大图
3详细配置步骤
在爱快路由的 Docker 管理界面中配置镜像仓库：
- 登录后，在左侧菜单栏的「专属域名」菜单中找到您的专属域名
- 复制您的专属域名（格式如：***.xuanyuan.run）
- 在爱快 Docker 管理界面中，按照上图所示配置镜像仓库地址
- 将复制的专属域名填入相应的配置项中
- 保存配置并测试连接
✅配置成功提示：如果测试连接成功，说明配置正确。 之后您就可以通过轩辕镜像仓库快速拉取各种 Docker 镜像了。
💡小贴士：使用专属域名无需填写用户名和密码，直接配置镜像仓库地址即可。 推荐使用轩辕镜像地址获得最佳速度。 如需了解更多爱快 Docker 功能，请参考官方文档。
4日常使用说明
配置完成后的日常使用方法
后续拉取镜像：
- 在爱快 Docker 管理界面中，进入镜像管理页面
- 点击"拉取镜像"或"添加镜像"按钮
- 输入您需要的镜像名称和标签
- 系统会自动使用配置的轩辕镜像服务
- 等待镜像下载完成
💡小贴士：配置完成后，爱快路由会自动使用轩辕镜像服务拉取镜像， 大大提升下载速度和稳定性。您可以在下载过程中看到明显的速度提升。 根据您的网络环境，系统会自动选择最优的访问路径。
5配置说明
推荐配置：爱快路由用户使用轩辕镜像地址， 可获得最佳的国内网络访问速度。
常见问题
Q：已配置镜像仓库，但拉取镜像失败或镜像源无法生效？
可能原因：
爱快路由系统 3.7.22 版本的 Docker 插件在加载自定义镜像源时存在已知缺陷，可能导致镜像仓库地址保存后仍无法正常使用，或拉取镜像时始终失败。该问题与轩辕镜像服务本身无关，属于爱快固件侧的行为。
建议按以下方式处理：
- 降级系统版本（推荐）
将爱快路由固件降级至 3.7.19。该版本下 Docker 镜像源配置可正常生效，是目前较为稳定的替代方案。降级前请备份当前配置，并在爱快官方渠道下载对应版本固件。 - 使用离线上传方式
若暂时无法降级，可在其他已联网的设备上使用 Docker 拉取所需镜像，导出为 tar 包后上传至爱快路由，通过 Docker 管理界面的「离线上传」或「引用镜像」功能导入。具体操作请参考爱快 Docker 官方文档。 - 排查配置与流量
若您使用的并非 3.7.22 版本，或降级、离线上传后仍有问题，请确认专属域名填写正确、测试连接已通过，且账户仍有可用流量。流量耗尽时会返回 402 错误，详见下方「流量耗尽错误提示」章节。
7流量耗尽错误提示
当您的流量用尽时，拉取镜像会显示以下错误，请及时充值：
💡当您登录或拉取镜像时返回 402 Payment Required 错误，表示您的流量已耗尽。请立即充值流量包以继续使用镜像服务。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"