如何通过HEAD请求调用Docker Hub API获取镜像清单？

可以，使用HEAD请求访问Docker Registry API的manifest端点，既能获取关键元数据，又不会被Docker Hub算作拉取操作，从而避开拉取速率限制的约束。

具体说明： #

• Docker Registry API明确支持对/v2/<name>/manifests/<reference>端点发送HEAD请求，该请求与GET请求的身份验证要求一致（私有镜像或需提升配额的场景仍需完成认证）。
• HEAD请求仅返回响应头信息，不会传输完整的manifest内容，因此不会触发Docker Hub的拉取操作计数，也不会消耗你的拉取配额。
• 从HEAD响应中可获取的核心信息包括：
  • Docker-Content-Digest：manifest的唯一校验摘要，可用于后续精准拉取或镜像验证
  • Content-Length：manifest文件的大小
  • Content-Type：manifest的类型（如application/vnd.docker.distribution.manifest.v2+json）

注意事项： #

• 若需要完整的manifest内容，仍需使用GET请求，此时会被计入拉取配额。
• HEAD请求仍受Docker Hub的通用请求频率限制（如匿名用户的请求频次限制），但该限制独立于拉取操作的配额。
• 发送HEAD请求时需指定与GET请求一致的Accept头，确保获取对应版本manifest的响应头信息。

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