如何拉取指定架构的镜像？
本文适用于：
- • 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 版本）
本文由「xuanyuan.cloud」维护
专注国内 Docker / 镜像 / Registry 网络问题
内容基于真实用户环境与实测
← 返回常见问题首页📚 问题目录