极客技术博客’s Blog
·
详解 Docker 错误：no matching manifest for linux/amd64 in the manifest list entries
💡
原文中文，约4700字，阅读约需12分钟。
📝
内容提要
Docker 镜像拉取时出现“no matching manifest for linux/amd64”错误，通常是由于架构不匹配。解决方法包括确认镜像支持的架构、使用特定标签、联系维护者或自行构建。建议使用 Buildx 构建多架构镜像，以确保兼容性。
🎯
关键要点
- Docker 镜像拉取时出现 'no matching manifest for linux/amd64' 错误通常与架构不匹配有关。
- 镜像清单描述单个镜像的元数据，包括层、大小和架构等信息。
- 清单列表是一个 JSON 文件，包含多个镜像清单的引用，用于支持多架构镜像。
- 错误的核心是架构不匹配，可能由镜像本身不支持 linux/amd64、镜像维护者未推送多架构清单或 Docker 客户端版本过低引起。
- 可以通过 docker manifest inspect 命令查看镜像的清单列表详情，确认是否支持 linux/amd64。
- 解决方案包括确认是否存在 amd64 专用标签、联系维护者、自己构建 amd64 版本的镜像或更新 Docker 客户端。
- Docker Buildx 是支持同时构建多架构镜像的工具，建议使用以确保兼容性。
- 使用固定版本标签而非 'latest' 标签可以避免不必要的错误。
- 随着 ARM 架构的普及，多架构镜像支持将成为标配，掌握清单列表与 Buildx 工具能有效避免兼容性问题。
❓
延伸问答
什么是 Docker 中的 'no matching manifest for linux/amd64' 错误？
该错误表示要拉取的 Docker 镜像不支持当前宿主机架构（linux/amd64）。
导致 'no matching manifest for linux/amd64' 错误的常见原因有哪些？
常见原因包括镜像本身不支持 linux/amd64、维护者未推送多架构清单或 Docker 客户端版本过低。
如何确认 Docker 镜像是否支持 linux/amd64 架构？
可以使用 'docker manifest inspect <镜像名:标签>' 命令查看镜像的清单列表，确认是否包含 linux/amd64 条目。
解决 'no matching manifest for linux/amd64' 错误的方案有哪些？
解决方案包括确认是否存在 amd64 专用标签、联系维护者、自己构建 amd64 版本的镜像或更新 Docker 客户端。
如何使用 Docker Buildx 构建多架构镜像？
使用 Docker Buildx 可以通过指定目标架构并推送镜像来构建多架构镜像，步骤包括创建构建器实例和编写 Dockerfile。
使用 'latest' 标签会有什么风险？
使用 'latest' 标签可能导致拉取到不兼容的镜像，建议使用固定版本标签以避免不必要的错误。
➡️
