让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
如何拉取指定 CPU 架构的镜像（如 ARM64、AMD64）？
本文适用于：
- • Docker 20+ / 24+
- • 需要拉取特定 CPU 架构的镜像（ARM64/AMD64等）
- • 跨平台部署场景
在使用 Docker 拉取指定架构镜像时，镜像能否成功拉取，取决于您设备的 CPU 架构（例如 x86_64 / ARM64）以及该镜像是否提供相应架构版本。
常见设备架构说明
🖥️ 电脑、服务器：
默认采用 x86 架构（对应 Docker 的 amd64 平台）
🔧 树莓派、国产主机：
通常采用 ARM 架构（对应 Docker 的 arm64 平台）
如何拉取指定架构的镜像
如果需要拉取指定架构的镜像，可以使用 --platform 参数：
拉取 ARM64 架构镜像示例：
docker pull --platform linux/arm64 镜像名:标签
拉取 AMD64 架构镜像示例：
docker pull --platform linux/amd64 镜像名:标签
查看镜像支持的架构
在执行拉取前，请先到我们的镜像页面查看该镜像是否支持相应架构：
👉 访问镜像详情页，查看「版本下载 - 系统架构」标签
常见错误提示
若该镜像未提供对应架构（例如没有 ARM 版本），即使加上 --platform 参数，也会报错：
no matching manifest for linux/arm64 in the manifest list entries
这个错误表示该镜像的清单列表中没有您请求的架构版本。
💡 建议：
- ✅ 拉取镜像前，先在镜像详情页查看「版本下载 - 系统架构」标签
- ✅ 确认您的设备架构与镜像支持的架构匹配
- ✅ 如果没有对应架构，可尝试使用作者提供的其他版本或标签
- ✅ 或者切换到兼容架构的设备上运行
- ⚠️ 部分镜像可能仅支持特定架构（如某些老旧镜像只有 amd64 版本）
你可能还会遇到：
本文由「轩辕镜像」维护
轩辕镜像 | Docker 镜像高效稳定拉取服务
内容基于轩辕镜像真实用户使用与实测整理