如何在QEMU模拟的arm7l平台上用docker buildx build构建ARM v6镜像？

当使用docker buildx build --platform=linux/arm/v6构建镜像时，构建容器默认模拟armv7l架构，而非预期的armv6l。虽然运行容器时设置QEMU_CPU=arm1176可以让容器识别为armv6l，但直接在主机设置该环境变量无法传递到Buildx的构建容器中，可通过以下方法解决：

方法1：修改Dockerfile添加环境变量 #

在Dockerfile开头添加ENV QEMU_CPU=arm1176，让构建容器的QEMU直接读取该参数：

FROM debian:bookworm-slim
ENV QEMU_CPU=arm1176

# 原有Dockerfile内容...
RUN echo "TARGETPLATFORM is '$TARGETPLATFORM'"
RUN echo "TARGETARCH is '$TARGETARCH'"
RUN echo "arch returns $(arch)"

执行原构建命令即可生效：

docker buildx build -t rbanffy/hercules-base:latest-armv6 --platform=linux/arm/v6 --progress=plain .

方法2：通过buildx的--build-arg传递参数（无需修改Dockerfile） #

如果不想修改Dockerfile，可以用--build-arg传递参数，同时在Dockerfile中声明ARG并转为ENV：

步骤1：修改Dockerfile添加ARG和ENV #

FROM debian:bookworm-slim
ARG QEMU_CPU
ENV QEMU_CPU=$QEMU_CPU

# 原有Dockerfile内容...
RUN echo "TARGETPLATFORM is '$TARGETPLATFORM'"
RUN echo "TARGETARCH is '$TARGETARCH'"
RUN echo "arch returns $(arch)"

步骤2：带参数构建 #

docker buildx build -t rbanffy/hercules-base:latest-armv6 --platform=linux/arm/v6 --progress=plain --build-arg QEMU_CPU=arm1176 .

原理说明 #

Buildx的构建容器是独立于主机的隔离环境，主机的环境变量不会自动传递到构建容器内。QEMU_CPU是QEMU模拟架构时读取的环境变量，必须通过Dockerfile的ENV或Buildx的--build-arg显式注入到构建容器中，才能让QEMU使用arm1176CPU（对应armv6l架构）进行模拟。

修改后构建输出会显示：

#8 0.712 TARGETPLATFORM is 'linux/arm/v6'
#8 0.717 TARGETARCH is 'arm'
#8 0.783 arch returns armv6l

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