如何限制Dockerfile仅构建linux/amd64平台镜像？

要解决你遇到的“指定错误平台构建出标记与实际架构不符的异常镜像”问题，可以通过在Dockerfile中添加目标平台校验逻辑，强制限制仅能构建linux/amd64镜像，同时不影响ARM主机通过模拟环境正常构建。

实现方式 #

修改后的Dockerfile如下：

FROM --platform=linux/amd64 ubuntu:22.04
WORKDIR /placeholder

# 校验目标平台，非linux/amd64直接终止构建
ARG TARGETPLATFORM
RUN if [ "$TARGETPLATFORM" != "linux/amd64" ]; then echo "错误：本Dockerfile仅支持linux/amd64平台" >&2; exit 1; fi

原理说明 #

• TARGETPLATFORM是Docker构建过程中自动注入的环境变量，其值对应docker build --platform指定的目标平台。
• 新增的RUN指令会检查目标平台是否为linux/amd64，如果不符则直接报错退出，避免生成标记错误的异常镜像。
• 在ARM主机上执行docker build .或docker build --platform linux/amd64 .时，Docker会自动通过QEMU模拟x86_64环境完成构建，无需额外配置（前提是主机已开启QEMU支持，Docker Desktop或安装qemu-user-static的Linux主机默认已支持）。

效果验证 #

• 若执行docker build --platform linux/arm64 .，构建会立即报错终止，不会生成任何镜像。
• 正常构建出的镜像标记为linux/amd64，容器内arch命令返回x86_64，符合预期。

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