如何用统一API查询私有/公有Docker镜像仓库的标签与摘要？

问题核心 #

GCP Artifact Registry遵循CNCF Distribution规范，可通过标准v2路径/v2/<repo-path>/tags/list查询，但Docker Hub公共镜像直接用相同路径会返回认证错误，本质是Docker Hub的v2 Registry API需要匿名认证，而非路径不兼容。

Docker Hub的正确v2 API使用方式 #

Docker Hub公共镜像完全支持标准Registry API，只是需要先获取匿名认证token：

1. 获取匿名token：

   curl "https://auth.docker.io/token?service=registry.docker.io&scope=repository:library/debian:pull"
   

2. 携带token请求标准路径：

   curl -H "Authorization: Bearer <获取到的token>" "https://registry.hub.docker.com/v2/library/debian/tags/list"
   

   该响应格式和GCP Artifact Registry完全一致，符合CNCF规范。

你之前用到的https://hub.docker.com/v2/namespaces/library/repositories/debian/tags是Docker Hub的门户专属API，不属于标准Registry API范畴，路径差异大，不适合跨平台适配。

docker buildx imagetools inspect无需认证的原因 #

Docker CLI（含buildx组件）内置了Registry认证逻辑：针对Docker Hub公共镜像，会自动发起匿名认证流程获取token，再调用标准v2 API拉取清单，所以无需手动处理认证就能拿到结果。

跨仓库统一适配方案 #

以CNCF Distribution v2 Registry API为统一接口，仅针对不同仓库处理认证逻辑即可：

• GCP Artifact Registry：请求时携带GCP服务账号的认证token（可通过gcloud auth print-access-token获取）
• Docker Hub公共镜像：自动执行匿名token获取流程
• 其他遵循规范的私有仓库（如AWS ECR、Harbor）：按对应平台的认证方式生成token，再发起标准API请求

无需依赖各平台的专属API，就能实现跨仓库的标签、摘要查询。

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