docker多平台镜像通过manifest list实现单标签适配多架构，依赖oci v1.0+仓库支持；推荐用buildx一键构建推送，也可用docker manifest手动聚合已有镜像；需验证清单结构及跨平台拉取正确性。
使用 Docker 镜像仓库管理多平台架构的 Manifest 列表，核心是让一个镜像标签（如 myapp:latest）背后自动适配不同 CPU 架构（如 linux/amd64、linux/arm64），用户拉取时无需指定平台，Docker 客户端会按需选择。这依赖镜像仓库支持 OCI v1.0+ 标准，并配合 docker buildx 或 docker manifest 工具完成构建、推送与清单聚合。
确认镜像仓库兼容性
不是所有仓库都原生支持多架构 Manifest List。Docker Hub、GitHub Container Registry（GHCR）、Amazon ECR、Harbor（v2.0+）、Quay.io 等主流仓库均已支持 OCI Image Index（即 Manifest List）。需注意：
- 私有 Harbor 部署需启用
content_trust和oci模式，且版本 ≥ 2.0 - 自建 registry（如 distribution）需配置
compatibility_schema2并启用 OCI 支持 - 推送前可用
docker buildx imagetools inspect nginx:latest测试是否能成功解析远程清单
用 buildx 一键构建并推送多架构镜像
这是最推荐的生产方式：无需手动打多个标签再合并，buildx 在构建阶段就生成各平台镜像并自动创建 Manifest List 推送至仓库。
- 确保已启用 QEMU 模拟支持：
docker run --privileged multiarch/qemu-user-static --reset -p yes - 创建并启动多架构构建器：
docker buildx create --use --name mybuilder && docker buildx inspect --bootstrap - 执行构建+推送（以 amd64 + arm64 为例）：
docker buildx build \<br> --platform linux/amd64,linux/arm64 \<br> --push \<br> -t your-registry.com/your-ns/app:1.2.0 .
- 推送完成后，仓库中
app:1.2.0即为一个 Manifest List，包含两个 platform-specific 镜像摘要
用 docker manifest 手动创建与推送清单（适用于已有单架构镜像）
当已有分别构建好的单平台镜像（如 app:1.2.0-amd64、app:1.2.0-arm64），可用 manifest 命令聚合：
- 先在
~/.docker/config.json中启用实验性功能："experimental": "enabled" - 创建清单：
docker manifest create your-registry.com/your-ns/app:1.2.0 \<br> your-registry.com/your-ns/app:1.2.0-amd64 \<br> your-registry.com/your-ns/app:1.2.0-arm64
- 添加架构注释（可选但强烈建议）：
docker manifest annotate your-registry.com/your-ns/app:1.2.0 \<br> your-registry.com/your-ns/app:1.2.0-amd64 --arch amd64 --os linux
- 推送清单：
docker manifest push your-registry.com/your-ns/app:1.2.0
验证与调试多架构清单
推送到仓库后，务必验证 Manifest List 是否正确生成并可被客户端识别：
- 查看清单结构：
docker buildx imagetools inspect your-registry.com/your-ns/app:1.2.0（推荐，输出清晰） - 或使用旧命令：
docker manifest inspect your-registry.com/your-ns/app:1.2.0（需开启实验模式） - 检查输出中
manifests数组是否包含预期平台项，每项含platform.architecture和digest - 在不同架构机器上实测拉取：
docker pull your-registry.com/your-ns/app:1.2.0，随后docker inspect确认Architecture字段匹配本地环境
