如何列出Harbor中缓存的Docker Hub镜像并校验其ARM64平台适配性

枚举Harbor缓存的公共镜像 #

Harbor没有原生提供跨项目拉取所有缓存公共镜像的专用接口，可以通过现有接口组合实现枚举：

• 调用GET /projects接口拉取所有有权限访问的项目列表，筛选出类型为代理缓存项目的条目，这类项目是Harbor用来缓存上游Registry（比如Docker Hub）镜像的专用项目
• 遍历所有代理缓存项目，调用GET /projects/{project_name}/repositories接口拉取项目下的所有仓库列表
• 对每个仓库调用GET /projects/{project_name}/repositories/{repository_name}/artifacts接口，拉取制品的manifest信息即可匹配确认上游是否为Docker Hub公共镜像

批量校验镜像ARM64兼容性 #

如果已经整理出常用镜像列表，可以直接用Docker原生能力完成校验，无需依赖Harbor额外接口：

• 提前将团队常用镜像的完整引用整理为文本文件，每行一条记录
• 仅校验多架构支持情况、无需实际下载镜像可使用docker manifest命令，示例如下：

# 单镜像校验
docker manifest inspect --verbose 镜像地址 | grep -E 'architecture.*arm64'

# 批量校验（假设镜像列表保存在image_list.txt）
while read image; do
  if docker manifest inspect --verbose "$image" | grep -q 'architecture.*arm64'; then
    echo "* $image 支持ARM64"
  else
    echo "* $image 不支持ARM64"
  fi
done < image_list.txt

• 如果需要模拟实际拉取场景验证，可使用命令docker pull --platform linux/arm64 镜像地址，命令执行成功即代表镜像适配ARM64架构，注意该命令会实际下载镜像占用本地磁盘空间

补充说明 #

• 部分旧版本Harbor的代理缓存不会自动同步上游镜像的最新多架构manifest，若校验发现Harbor缓存的镜像不支持ARM64，可手动触发缓存刷新后再次校验
• Docker for Mac自带Rosetta 2转译能力，大部分仅适配AMD64的镜像也可在Apple Silicon设备上正常运行，仅强依赖底层硬件指令的镜像会出现兼容性问题

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