你有一台 x86_64 的开发机器
你构建了一个 linux/arm64 的 Docker 镜像
你需要测试这个镜像是否正常工作

Docker 容器 → BuildKit → QEMU binfmt → 执行 arm64 指令
                 ↑
          二进制翻译（翻译 ARM 指令为 x86 指令）

# 一键安装所有支持的架构
docker run --privileged --rm tonistiigi/binfmt --install all

# 安装特定架构
docker run --privileged --rm tonistiigi/binfmt --install arm64
docker run --privileged --rm tonistiigi/binfmt --install arm

# 安装 QEMU
apt-get update && apt-get install -y qemu-user-static

# 注册 binfmt
update-binfmts --enable

# 确认注册成功
ls /proc/sys/fs/binfmt_misc/

- name: Set up QEMU
  uses: docker/setup-qemu-action@v3
  with:
    platforms: arm64,arm

# 在 x86 机器上运行 ARM 容器
docker run --rm arm64v8/ubuntu uname -m
# 输出: aarch64

# 查看注册的 binfmt
cat /proc/sys/fs/binfmt_misc/qemu-aarch64

# QEMU 适合做的：构建和测试
docker buildx build --platform linux/arm64 -t myapp:arm64 .

# QEMU 不适合做的：性能测试
docker run --platform linux/arm64 myapp:arm64 bench

# 使用 BUILDPLATFORM 进行编译，减少 QEMU 模拟的工作量
FROM --platform=$BUILDPLATFORM golang:1.21 AS builder
ARG TARGETARCH
RUN GOARCH=$TARGETARCH go build -o server

FROM --platform=$TARGETPLATFORM alpine:3.19
COPY --from=builder /app/server /server

# 检查内核版本
uname -r  # 需要 4.8+ 支持 binfmt_misc

# 检查是否安装了 qemu-user-static
dpkg -l | grep qemu-user-static

# 尝试二进制安装
wget https://github.com/multiarch/qemu-user-static/releases/latest/download/qemu-aarch64-static
chmod +x qemu-aarch64-static
cp qemu-aarch64-static /usr/bin/

# 启用缓存加速
docker buildx build \
  --cache-from type=registry,ref=myapp:cache \
  --platform linux/arm64 \
  -t myapp:arm64 .