首页/云/Docker 容器速查/docker run --platform 指定架构
基础命令50 条

docker run --platform 指定架构

在多架构镜像(multi-arch manifest)里挑选目标平台运行,常见于 Apple Silicon 上跑 amd64 镜像或核对跨平台产物。

Docker 容器速查云更新于 2026-10-12
用途选择镜像的 OS/架构变体
语法--platform linux/amd64 或 linux/arm64(可带变体 v8)
适用镜像为 multi-arch 时

示例

示例
docker run --rm --platform linux/amd64 alpine:3.20 uname -m
docker buildx imagetools inspect nginx:1.27-alpine   # 查看该镜像有哪些平台
宿主不原生支持该架构时走 QEMU 模拟(需 binfmt 支持),性能下降明显,个别系统调用还可能不兼容。

易错点

  • 单架构镜像上传 --platform 选择会报 no matching manifest,先确认镜像是否真的多架构
  • 用错架构最常见的症状是 exec format error,用 docker inspect 看 Architecture 字段确认

数据来源与参考

  • Docker 官方 CLI 参考:docker run --platform(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌