多平台Docker镜像导入报错，求正确的导出及本地测试方法

问题根源 #

• docker load只支持导入单镜像的Docker归档格式（也就是docker save生成的文件），你用type=oci导出的是多平台镜像仓库归档，所以加载失败。
• docker import是导入文件系统快照，会丢掉镜像的元数据（比如ENTRYPOINT、CMD、环境变量这些），所以启动容器时会提示没指定命令。

正确操作流程 #

1. 本地构建并测试多平台镜像 #

先确保buildx的构建器支持多平台（没创建过的话先执行这条）：

docker buildx create --name multi-platform-builder --use

构建时可以针对性导出单个平台的镜像到本地Docker，先做测试（比如树莓派用的arm64）：

# 构建并导出arm64镜像到本地Docker
docker buildx build --platform linux/arm64 -t openhaus/backend:latest --load .

# 测试启动容器（如果是amd64机器，得先开QEMU模拟arm架构）
docker run -it --rm openhaus/backend:latest

要是在amd64机器上测试arm64镜像，先执行这条开QEMU支持：docker run --privileged --rm tonistiigi/binfmt --install all

2. 导出多平台镜像为可加载的格式 #

如果要导出tar文件传到不同平台导入，有两种靠谱方式：

方式一：分平台导出单镜像归档（推荐，适配docker load）

分别导出每个平台的镜像为单独的tar，传到对应平台后直接用docker load：

# 导出amd64平台镜像
docker buildx build --platform linux/amd64 -t openhaus/backend:amd64-latest --output type=docker,dest=backend-amd64.tar .

# 导出arm64平台镜像
docker buildx build --platform linux/arm64 -t openhaus/backend:arm64-latest --output type=docker,dest=backend-arm64.tar .

把backend-arm64.tar传到树莓派，执行docker load -i backend-arm64.tar就能正常导入，之后启动容器也不会有问题。

方式二：用skopeo导入OCI多平台归档（适合批量管理）

如果要保留多平台结构，用skopeo工具处理（树莓派需要先安装skopeo）：

• 本地导出OCI仓库归档：

docker buildx build --platform linux/amd64,linux/arm64 -t openhaus/backend:latest --output type=oci,dest=backend-multi.tar .

• 树莓派上操作：

# 先解压归档文件
mkdir backend-oci
tar -xf backend-multi.tar -C backend-oci

# 把arm64镜像导入本地Docker
skopeo copy oci:/root/backend-oci docker-daemon:openhous/backend:latest --override-arch arm64

导入完成后就能正常启动容器。

3. 测试完成后推送镜像到仓库 #

本地测试没问题，直接用buildx推送多平台镜像到仓库：

docker buildx build --platform linux/amd64,linux/arm64 -t openhaus/backend:latest --push .

之后树莓派直接执行docker pull openhaus/backend:latest，Docker会自动拉取适配arm64的镜像。

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