在arm64架构主机运行amd64架构Docker镜像出现exec format错误怎么办

你遇到的standard_init_linux.go:219: exec user process caused: exec format error报错本质是主机和Docker镜像的CPU架构不兼容：

• 当前主机为arm64（aarch64）架构，只能直接运行编译为arm64架构的二进制程序
• 你尝试启动的Docker镜像内部的可执行文件是为amd64（x86_64）架构编译的，架构不匹配导致操作系统无法识别执行格式，触发报错。

以下方案按优先级从高到低排序：

• 优先使用适配arm64架构的镜像
  绝大多数官方维护的Docker镜像都支持多架构分发，拉取镜像时Docker会自动匹配和主机架构一致的版本。你可以先删除本地已下载的amd64架构镜像，重新拉取对应镜像的官方版本即可。
  如果需要手动指定拉取arm64架构的镜像，可在拉取和启动命令中添加--platform linux/arm64参数：

  # 拉取指定架构镜像
  docker pull --platform linux/arm64 <镜像名:版本号>
  # 启动指定架构镜像
  docker run --platform linux/arm64 <其他启动参数> <镜像名:版本号>
  

• 配置QEMU架构转译兼容amd64镜像
  如果找不到对应arm64版本的镜像，可以安装QEMU用户态模拟工具，通过二进制转译的方式运行amd64架构的程序，配置步骤如下：

  1. 安装依赖包，Debian/Ubuntu系发行版执行命令：
     apt install -y binfmt-support qemu-user-static
  2. 注册架构转译规则：
     docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
     配置完成后即可正常启动amd64架构的镜像，注意：转译运行会带来20%~50%不等的性能损耗，仅建议无对应arm64镜像的场景下使用

• 自行构建适配arm64架构的镜像
  如果是你自行开发的自定义镜像，可以直接在arm64架构的主机上重新执行docker build流程，生成适配arm64架构的镜像后再运行即可。如果需要同时适配多架构，也可以使用Docker buildx工具一次构建多架构版本的镜像。

内容的提问来源于stack exchange，提问作者Vinayak Bachhav