Docker Buildx通过QEMU模拟和manifest list实现多架构镜像统一标签自动适配，核心步骤包括启用binfmt_misc、创建多平台构建器、编写支持$BUILDPLATFORM/$TARGETPLATFORM的Dockerfile，并用--platform与--push一键构建推送。
用 Buildx 构建多架构容器镜像，核心是让一个镜像标签（比如 myapp:latest）在不同 CPU 架构机器上拉取时自动匹配对应版本——x86 机器拉 amd64 镜像，M 系列 Mac 或树莓派拉 arm64 镜像。这不是打多个 tag，而是生成符合 OCI 规范的 manifest list（清单列表），由 Docker 客户端按需分发。
启用 QEMU 模拟支持
跨架构构建的前提是让宿主机（通常是 x86_64）能运行 ARM 等非原生二进制。Buildx 依赖内核的 binfmt_misc 和 QEMU 用户态模拟器：
- Linux 主机执行：
docker run --privileged --rm tonistiigi/binfmt:latest --install all - macOS/Windows 用户使用 Docker Desktop 时，这步通常已预置，可跳过
- 验证是否生效：运行
ls /proc/sys/fs/binfmt_misc/，应看到qemu-arm64、qemu-amd64等条目
创建并初始化多平台构建器
默认 buildx 构建器只用本地 Docker 引擎（仅限当前架构），必须显式创建支持多节点的构建器：
- 创建并设为默认：
docker buildx create --use --name mybuilder --bootstrap - 检查支持平台：
docker buildx inspect --bootstrap，输出中Platforms字段应包含linux/amd64、linux/arm64等 - 若提示驱动错误，可改用容器驱动：
docker buildx create --use --name mybuilder --driver docker-container
编写适配多架构的 Dockerfile
关键在于利用 Buildx 注入的构建变量，避免硬编码平台逻辑：
- 开头声明语法版本：
# syntax=docker/dockerfile:1 - 构建阶段拉基础镜像时用
--platform=$BUILDPLATFORM（如FROM --platform=$BUILDPLATFORM golang:1.22） - 运行阶段用
--platform=$TARGETPLATFORM（如FROM --platform=$TARGETPLATFORM alpine:3.20） - 交叉编译时设置环境变量：
ENV CGO_ENABLED=0 GOOS=linux GOARCH=${TARGETARCH}
一键构建并推送多架构镜像
执行构建命令时指定目标平台和推送标志，Buildx 自动完成并行构建、上传、清单合并：
- 示例命令：
docker buildx build --platform linux/amd64,linux/arm64 -t yourname/app:latest --push . - 成功后，任意架构机器执行
docker pull yourname/app:latest都会拉到匹配自身架构的镜像层 - 查看清单结构：
docker buildx imagetools inspect yourname/app:latest，确认各架构 digest 和 platform 字段完整
