如何判断Docker Registry中的镜像清单是否为多架构清单？

当然可以在客户端侧判断，核心是要主动获取镜像清单列表（manifest list/index），而非让客户端自动拉取匹配本地架构的单架构清单。以下是两种实用方法：

方法1：使用Docker CLI的manifest inspect命令 #

docker manifest inspect是专门查看镜像清单的工具，能直接获取多架构镜像的清单列表：

• 若为多架构镜像，输出结果会包含manifests数组，每个元素对应一个架构的镜像信息，带有platform字段（明确标注architecture和os）。
• 若为单架构镜像，输出结果不会有manifests数组，直接展示当前架构的镜像配置细节。

示例命令 #

# 部分Docker版本需先启用CLI实验特性（Linux/macOS）
export DOCKER_CLI_EXPERIMENTAL=enabled

# 检查目标镜像的清单类型
docker manifest inspect nginx:latest

方法2：直接调用Docker Registry API #

通过HTTP请求显式请求manifest list类型的清单，指定Accept请求头为application/vnd.docker.distribution.manifest.list.v2+json：

• 若Registry返回200 OK，且响应体包含manifests数组，说明是多架构镜像。
• 若返回406 Not Acceptable，或响应体是无manifests数组的普通清单，则为单架构镜像。

示例curl命令（以Docker Hub公开镜像为例） #

curl -H "Accept: application/vnd.docker.distribution.manifest.list.v2+json" \
  https://registry-1.docker.io/v2/library/nginx/manifests/latest

如果是私有Registry，需先获取认证Token并在请求中加入Authorization: Bearer <token>头。

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