让 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 pull 提示 manifest unknown 怎么办？
本文适用于：
- • Docker 20+ / 24+（低版本可能导致此错误）
- • 国内网络环境
- • 拉取镜像时遇到 manifest unknown 错误
- • 需要验证镜像是否存在或 Docker 版本是否兼容
⚠️ 重要提示
这通常不是网络问题，而是镜像不存在或 Docker 版本过低。也不是「平台尚未同步」——轩辕镜像与原仓库镜像实时同步，不存在同步滞后。
相关常见问题
若拉取时报 manifest unknown，并怀疑是「原仓库有、轩辕镜像还没同步」，请先阅读轩辕镜像是否实时全量同步原仓库的所有镜像？，再按本文步骤排查 Docker 版本与镜像名、标签。
快速诊断流程：
manifest unknown 错误 ↓ 检查 Docker 版本（docker info） ↓ 版本 < 20 升级 Docker（主要原因） ↓ 版本 >= 20 验证镜像名和标签是否存在
✅ 推荐做法
优先检查 Docker 版本，Docker 20+ 是使用现代镜像仓库的前提。确认版本后，再验证镜像信息是否正确。
当您遇到 manifest unknown 错误时，需要先检查 Docker 版本，然后确认镜像信息是否正确。
错误示例
问题排查步骤
步骤 1：检查 Docker 版本
首先执行 docker info 查看 Server Version：
如果版本低于 20.x，请先升级 Docker 到 20+ 版本。因为 Docker 不同版本支持的 Registry API 协议不同，低版本客户端在拉取镜像时可能不兼容 v2 接口。
步骤 2：确认镜像信息
如果 Docker 版本已经是 20+，仍然报错，这表示镜像仓库中不存在指定的镜像名或标签（tag）。
请优先到原仓库（如 Docker Hub）核实镜像名与标签是否真实存在。若怀疑是「平台未同步」导致，请先阅读轩辕镜像是否实时全量同步原仓库的所有镜像？。
常见原因包括：
- • 镜像名称拼写错误
- • 指定的标签（tag）不存在
- • 镜像已被删除或下架
解决方案
方案 2：验证镜像信息（如果版本已是最新）
请先在本站镜像仓库页面搜索该镜像，确认镜像名与标签（tag）是否正确。
使用页面提供的完整拉取命令执行 docker pull。
示例
假设网站查询到正确的镜像信息为：
镜像名：elestio/nodebb
标签：v4.4.6
则拉取命令为：
总结：遇到 manifest unknown 错误时，先排除「平台未同步」（见实时全量同步说明），再检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。这样可以快速定位和解决问题。
你可能还会遇到：
本文由「轩辕镜像」维护
轩辕镜像 | Docker 镜像高效稳定拉取服务
内容基于轩辕镜像真实用户使用与实测整理