如何通过Docker BuildX使32位用户空间自动拉取arm64镜像？

你可以通过BuildX修改镜像的manifest list，将linux/arm/v8架构条目关联到已有的arm64镜像层，这样32位用户空间的Docker就能自动匹配并拉取64位镜像，无需重新构建32位版本。

方法一：构建时直接生成兼容manifest #

在BuildX构建命令中，同时指定linux/amd64、linux/arm64/v8和linux/arm/v8平台，BuildX会自动复用arm64的构建结果生成兼容条目：

docker buildx build \
  --platform linux/amd64,linux/arm64/v8,linux/arm/v8 \
  --tag your-image:latest \
  --push \
  .

方法二：修改已推送的镜像manifest #

如果已经完成amd64+arm64镜像的推送，可通过docker buildx imagetools直接修改manifest list：

1. 获取arm64镜像的digest：

ARM64_DIGEST=$(docker buildx imagetools inspect your-image:latest --format '{{range .Manifests}}{{if eq .Platform.Architecture "arm64"}}{{.Digest}}{{end}}{{end}}')

2. 创建包含linux/arm/v8条目的新manifest并推送：

docker buildx imagetools create \
  -t your-image:latest \
  your-image:latest@$(docker buildx imagetools inspect your-image:latest --format '{{range .Manifests}}{{if eq .Platform.Architecture "amd64"}}{{.Digest}}{{end}}{{end}}') \
  your-image:latest@$ARM64_DIGEST \
  --platform linux/arm/v8=$ARM64_DIGEST

验证效果 #

修改完成后，在32位用户空间的树莓派上直接拉取镜像：

docker pull your-image:latest

此时Docker会自动匹配linux/arm/v8条目，拉取对应的arm64镜像，无需额外加--platform参数强制指定。

注意：该方案仅适用于64位内核的设备，32位内核无法运行arm64镜像，需提前告知用户这一限制。

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