核心问题 #

你之前尝试失败的核心原因是：当在GitHub Actions的job中直接指定container字段时，Runner会先启动容器，之后steps里的命令默认在容器内部执行，无法直接操作宿主机安装qemu-user-static。

可行方案 #

方案一：用官方QEMU配置Action+手动启动容器（推荐） #

通过docker/setup-qemu-action在宿主机层面完成QEMU的注册，再手动拉取自定义镜像并启动容器执行构建：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: 配置QEMU跨架构支持
        uses: docker/setup-qemu-action@v3
        with:
          platforms: arm64

      - uses: actions/checkout@v4

      - name: 拉取自定义Debian镜像
        run: docker pull customed/debian

      - name: 在容器内执行构建
        run: |
          docker run --rm -v ${{ github.workspace }}:/workspace customed/debian /bin/bash -c "
            cd /workspace
            build.sh xxxx
          "

方案二：调整自定义镜像（补充QEMU依赖） #

如果不想修改工作流结构，可以在自定义Debian镜像中预先安装qemu-user-static和binfmt-support，同时确保镜像构建时已完成QEMU格式注册：

# 自定义Debian镜像的Dockerfile示例
FROM debian:latest

# 安装跨架构编译依赖和QEMU
RUN apt-get update && apt-get install -y \
    qemu-user-static \
    binfmt-support \
    gcc-aarch64-linux-gnu \
    && rm -rf /var/lib/apt/lists/*

# 注册QEMU二进制格式
RUN update-binfmts --enable qemu-aarch64

之后直接使用原工作流结构即可，因为容器自身已具备跨架构运行能力。

关键说明 #

• docker/setup-qemu-action是官方维护的工具，会自动在Runner宿主机上注册对应架构的QEMU模拟，无需手动处理权限和格式配置。
• 若选择方案二，需确保自定义镜像在构建时已完成binfmt的注册，否则容器启动后仍无法正常模拟arm64架构。

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