Mac M1 拉不到镜像？Docker 指定 amd64 平台就能跑

换了 M1 的 Mac，docker run mysql 直接报错或者干脆拉不下来？

问题不在你身上。

M1、M2、M3 这些 Apple Silicon 芯片是 arm64 架构，而很多老镜像只发布了 x86_64（也就是 amd64）的版本。架构对不上，Docker 自然不让跑。

解决办法就一个参数：--platform。

为什么 M1 上跑不了某些镜像

Docker 镜像是分架构的。

一个镜像 tag 背后可能有 arm64、amd64 等多个变体，靠 manifest list 区分。Docker 默认会拉和当前主机架构匹配的那一个。

M1 是 arm64，所以默认拉 arm64 版本。

可偏偏有些镜像（尤其是老版本、小众镜像）压根没出 arm64 包。这时候 Docker 要么报 no matching manifest，要么拉下来一个跑不起来的镜像，启动就崩。

典型报错长这样：

no matching manifest for linux/arm64/v8 in the manifest list entries

或者容器起来后日志里一堆 exec format error。

核心命令：用 –platform 指定架构

强制让 Docker 拉 amd64 版本，加 --platform linux/amd64 就行。

拉镜像时指定：

docker pull --platform linux/amd64 mysql:5.7.36

运行时指定：

docker run --platform linux/amd64 mysql

两个地方都能加，作用是告诉 Docker：别管我本机是 arm64，给我装 amd64 的。

M1 上跑 amd64 镜像靠的是 QEMU 模拟，Docker Desktop 默认集成了，不用额外装。

amd64、x86_64、linux/amd64 到底是不是一回事

是同一个东西的不同叫法，别被绕晕。

--platform 推荐写完整的 linux/amd64。

虽然 --platform linux/x86_64 在部分版本里也能识别，但不是标准写法，新版本可能不认。统一用 linux/amd64 最稳。

docker-compose 里怎么写

Compose 文件里直接加 platform 字段。

services:
  mysql:
    image: mysql:5.7.36
    platform: linux/amd64
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: 你的密码

这样 docker compose up 就会按 amd64 拉取和运行，不用每次敲命令带参数。

环境变量里的密码记得换成自己的，别直接抄。

性能代价：模拟跑确实会慢

amd64 镜像在 M1 上是模拟执行的，不是原生。

CPU 密集型的操作会明显变慢，数据库高并发、编译构建这类场景能感觉到卡顿。简单的小服务日常开发，影响其实不大。

所以优先级是这样：

• 能找到 arm64 原生镜像，就用原生的，最快
• 找不到 arm64，再用 --platform linux/amd64 兜底
• 别无脑全局指定 amd64，否则本来有 arm64 版本的镜像也被拖慢了

很多常用镜像现在都补上 arm64 了，mysql、redis、nginx 的新版本基本都支持。先试默认拉取，拉不动再指定平台。

全局默认指定平台（不推荐长期开）

如果某个项目就是离不开 amd64，可以设环境变量临时全局生效。

export DOCKER_DEFAULT_PLATFORM=linux/amd64

设了之后所有 docker pull / docker run 默认走 amd64。

这招省事，但副作用明显：连本来该用 arm64 的镜像也被强制成 amd64 了，整体变慢。建议只在当前终端临时用，别写进 .zshrc 长期开着。

常见问题 FAQ

Q1. –platform linux/x86_64 和 linux/amd64 有区别吗？

指向同一个架构，没有实质区别。

但 linux/amd64 是 Docker 官方标准写法，兼容性最好。x86_64 在新版本里可能不被识别，建议统一用 linux/amd64。

Q2. 加了 –platform 还是报错怎么办？

先确认 Docker Desktop 版本够新，旧版本 QEMU 模拟支持不全。

再检查镜像本身是否真的有 amd64 变体，用 docker manifest inspect 镜像名 能看到它支持哪些架构。如果连 amd64 都没有，那就得换镜像或换 tag。

Q3. 怎么确认镜像支持哪些架构？

用这条命令查：

docker manifest inspect mysql:5.7.36

输出里的 platform 字段会列出 architecture，能看到是 arm64 还是 amd64，或者两个都有。

Q4. 模拟跑 amd64 性能损失大概多少？

看场景，没有固定数字。

I/O 为主的轻量服务几乎无感，CPU 密集型任务（大量计算、编译、高并发查询）可能慢一截。生产环境别这么干，模拟方案只适合本地开发调试。

Q5. 必须用 mysql:5.7.36 这种老版本吗？

不一定。

老版本之所以要指定 amd64，多半是因为它没出 arm64 包。如果业务允许，升到支持 arm64 的新版本（比如 MySQL 8.x）能直接原生跑，省掉模拟开销。

小结

M1 上跑 x86 镜像，记住一个参数就够：--platform linux/amd64。

拉取、运行、Compose 三个地方都能加。能用 arm64 原生就别模拟，模拟是兜底手段，不是默认选择。

具体性能表现和镜像支持情况会随版本变化，本文命令在主流 Docker Desktop 版本上验证可用，遇到新报错以官方文档为准。

如果你在 M1 上还踩过别的镜像兼容坑，或者有更顺手的方案，欢迎在评论区交流～～～