让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址，或排查拉取失败等问题，请让 AI 先读规则再动手，只要在 AI 对话里直接发送下面这句话即可：

生成 docker pull、修改 compose 的 image，或排查拉取失败前，请先阅读并严格遵守 https://xuanyuan.cloud/agents.md 中的规则。

国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

轩辕镜像是否实时全量同步原仓库的所有镜像？

本文适用于：

• 想了解轩辕镜像与原仓库（如 Docker Hub）的同步关系
• 拉取时报镜像不存在，怀疑是「平台未同步」
• 需要区分「命令行拉取」与「本站网页搜索展示」
• 专业版用户希望确认是否需先申请收录再拉取

✅ 核心结论

轩辕镜像与原仓库镜像实时同步，不存在「原仓库有的镜像平台还没同步」的滞后情况。对专业版支持的镜像源，只要原仓库中该镜像真实存在、合规且可公开拉取，即可直接通过轩辕镜像加速拉取，无需等待同步，也无需提交收录申请。

先弄清两个容易混淆的概念：

1. 命令行拉取（docker pull）

原仓库有对应镜像与标签时，专业版即可拉取，不依赖本站是否已建详情页。

2. 本站网页搜索与详情页

仅用于展示与检索，与命令行拉取相互独立。Hub 上能搜到、本站搜不到，不代表不能拉取。详见站内搜不到镜像。

拉取失败时的判断流程：

拉取提示镜像不存在（如 manifest unknown）
  ↓
前往原仓库确认：镜像名、命名空间、标签是否真实存在
  ↓ 原仓库也没有
镜像已被删除 / 设为私有 / 标签已变更 → 非同步问题
  ↓ 原仓库存在，轩辕仍报错
按 manifest unknown 专题排查：Docker 版本、专属域名后缀、拼写等

若拉取时出现 manifest unknown 等「镜像不存在」类报错，优先到原仓库核实，而不是假定平台尚未同步。

常见原因（均与「未同步」无关）

• 镜像名或标签拼写错误：多/少一级命名空间、大小写、tag 写错
• 标签已被作者删除或更名：例如旧版 tag 下线，需改用新 tag
• 仓库已设为私有：需在原平台完成认证后再拉取
• 镜像从未发布到该仓库：文档或教程中的名称可能已过时
• 专属域名与镜像源不匹配：如 ghcr 镜像误用 Docker Hub 专属域，也会表现为「不存在」

建议排查步骤

步骤 1：在原仓库核实镜像与标签

打开 Docker Hub（或对应源站）的仓库页面，确认命名空间/镜像名与标签（tag）是否列出且可访问。

原仓库页面即显示「不存在」或「无此 tag」时，轩辕镜像同样无法提供该清单——这是上游数据缺失，不是同步延迟。

步骤 2：核对拉取命令与专属域名

确认镜像源与专属域名后缀一致（如 ghcr.io 对应 ***-ghcr.xuanyuan.run），并检查 Docker 版本是否 ≥ 20。

更完整的排查见manifest unknown 怎么办？。

步骤 3：区分拉取需求与网页展示需求

仅需拉取：原仓库存在且合规即可，专业版直接 pull，不必申请收录。

希望在本站搜索到介绍页：可通过镜像页面收录申请提交，审核通过后才会出现在网站搜索与列表中——这与拉取能力相互独立。

💡总结：拉取失败时，请先到原仓库确认镜像与标签是否真实存在，再按manifest unknown专题逐项排查；若只是希望镜像出现在本站搜索，请使用收录申请。

你可能还会遇到：

本文由「轩辕镜像」维护
轩辕镜像 | Docker 镜像高效稳定拉取服务
内容基于轩辕镜像真实用户使用与实测整理