Docker Registry管理多平台镜像的核心是manifest list机制，通过buildx一次性构建、推送并自动生成跨架构（如linux/amd64、linux/arm64）的统一标签，依赖OCI v1.0+仓库支持及HTTPS配置。
直接用 Docker Registry 或云厂商仓库（如 Docker Hub、ECR、ACR）管理多平台镜像，核心不是“手动上传多个镜像”，而是通过 manifest list 把不同架构的镜像聚合成一个逻辑标签。用户拉取时，Docker 自动选匹配架构——这才是多架构镜像仓库管理的本质。
确保基础环境支持多架构构建
不装插件、不配模拟器，buildx 就跑不起来：
- 升级 Docker 到 19.03+，并启用实验性功能：在
~/.docker/config.json中添加"experimental": "enabled" - 安装 QEMU 模拟器支持（用于跨架构构建）：
docker run --privileged --rm tonistiigi/binfmt --install all - 创建并启动 buildx 构建器：
docker buildx create --use --name mybuilder && docker buildx inspect --bootstrap
用 buildx 一次性构建并推送到仓库
不用分别构建再打标签再推，buildx 支持单命令完成全平台构建+推送+生成 manifest：
- 命令示例（同时构建 amd64 和 arm64，并推送到私有仓库）：
docker buildx build \<br> --platform linux/amd64,linux/arm64 \<br> --push \<br> -t myregistry.example.com/myapp:v1.0 .
- 关键点：
–--push会自动触发 manifest list 创建并推送到远程仓库
– 镜像仓库必须支持 OCI v1.0+ 标准（Docker Hub、Harbor v2.0+、ECR、ACR 均满足）
– 推送后，同一 tag（如v1.0）下就包含两个平台的镜像摘要
验证与调试多架构镜像是否生效
别只信推送日志，要实际查 manifest 和本地拉取行为：
- 查看远程镜像支持哪些架构：
docker manifest inspect myregistry.example.com/myapp:v1.0
输出中应含manifests数组，每个元素带platform字段（如{"architecture":"arm64","os":"linux"}） - 在 ARM64 机器上执行：
docker pull myregistry.example.com/myapp:v1.0
然后docker image inspect <image_id></image_id>查Architecture字段是否为arm64 - 若拉取失败或拉错架构，常见原因：
– 仓库未开启 OCI 清单支持（旧版 Harbor 需显式开启）
– 构建时漏写--platform或平台标识拼错（如写成arm64而非linux/arm64）
私有仓库部署建议（兼顾安全与可用）
自建仓库不是只为存镜像，更是为了可控地管理多架构发布流程：
- 优先用 Harbor v2.10+：原生支持 OCI manifest、自动镜像扫描、RBAC 权限控制，且默认启用 manifest list 功能
- 避免裸跑官方 registry：
它虽支持 manifest，但无 UI、无权限、无清理策略，多团队协作易混乱；某团队曾因未设清理规则，三个月积压 300+ 个重复架构镜像 - 生产环境务必配置 HTTPS：
buildx 推送和 manifest 操作依赖 TLS，HTTP 仓库会被拒绝（除非加--insecure-registry，但不推荐）
