首页/云/Docker 容器速查/镜像与宿主架构/平台不符
容器排障52 条

镜像与宿主架构/平台不符

no matching manifest for linux/amd64 或运行期 exec format error:镜像与宿主平台不符;多架构标签可自动选择,显式 --platform 时要保证执行侧有对应支持。

Docker 容器速查云更新于 2026-10-12
诊断uname -m 对照镜像 Architecture
拉取docker pull --platform linux/arm64 …
运行需 binfmt/qemu 才能跨架构执行

示例

示例
uname -m
docker image inspect nginx:alpine -f '{{.Os}}/{{.Architecture}}'
docker pull --platform linux/amd64 nginx:alpine
docker run --rm --platform linux/amd64 nginx:alpine uname -m
构建发布面向两类架构时,用 buildx 多平台构建产出清单,运行侧由宿主自动选择。

易错点

  • Mac(arm) 上本地构建默认 arm64,推到 amd64 服务器直接起不来,构建侧要指定平台
  • 跨架构运行有性能折扣与兼容边界,只适合验证不适合长期承载

数据来源与参考

  • Docker 官方文档:Multi-platform images(docs.docker.com/build)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌