在GitHub Actions中构建ARM64 Docker镜像的配置是否正确？
2026-8-10
关于GitHub Action构建多架构Docker镜像的配置验证
你当前的GitHub Action配置完全正确，可以在x86-64架构的ubuntu-latest环境下构建出适配ARM64平台的Docker镜像，核心原因如下：
- 你已经引入了
docker/setup-qemu-action@v2：QEMU是一款指令集虚拟化工具，能在x86-64主机上模拟ARM64的运行环境，为跨架构镜像构建提供底层支持。 - 同时启用了
docker/setup-buildx-action@v2：Docker Buildx是官方的扩展构建工具，专门支持多架构镜像构建，它能结合QEMU的模拟能力，在x86主机上分别编译生成对应架构的镜像层。 - 在
docker/build-push-action@v3中指定platforms: linux/amd64,linux/arm64后，Buildx会自动为两个架构构建独立镜像，并将它们打包成一个多架构镜像清单推送到DockerHub。你看到DockerHub显示对应架构信息，就已经说明镜像包含了ARM64的适配内容。
如果想在没有ARM设备的情况下进一步验证：
- 本地安装Docker并启用Buildx后，执行
docker buildx imagetools inspect MyUser/MyImage:latest，可以查看镜像的架构清单，确认两个架构的镜像层都已存在。 - 也可以用
docker run --platform linux/arm64 MyUser/MyImage:latest命令，借助本地QEMU模拟运行ARM64镜像，验证镜像的基本功能是否正常。
内容的提问来源于stack exchange，提问作者SopMe
相关产品推荐
相关产品推荐
