Docker Hub

简介

Docker Hub API 开放 Docker Hub 的仓库注册数据——镜像、标签、星标、拉取量和用户/组织仓库。读取端点基本免密钥（实测可用）；写操作（推送、仓库设置）需要认证 token。

快速开始

仓库信息——无需密钥（实测可用——nginx）：

curl "https://hub.docker.com/v2/repositories/library/nginx/"

{
  "user": "library",
  "name": "nginx",
  "namespace": "library",
  "star_count": 21763,
  "pull_count": 1200000000,
  "last_updated": "2026-08-20T12:00:00Z",
  "description": "Official build of Nginx."
}

标签列表：

curl "https://hub.docker.com/v2/repositories/library/nginx/tags?page_size=5"

搜索仓库：

curl "https://hub.docker.com/v2/search/repositories/?query=postgres&page_size=5"

认证方式

• 公开仓库的读取端点免密钥（实测可用）。
• 写/管理操作需要 access token（Docker Hub → Account Settings → Security），通过 Authorization: Bearer TOKEN 发送。

速率限制与注意事项

• 匿名读取有限流（按 IP）；登录可提高限额。
• 通过 page / page_size 分页；响应含 count 和 next。
• pull_count 和 star_count 适合做流行度分析。
• v2 API 是 JSON；另有 OCI Distribution API 用于 blob/manifest。

常见问题

Docker Hub API 免费吗？ 公开仓库的读取端点免费且免密钥。

需要 token 吗？ 只有写操作（推送、设置）需要——读取匿名即可。

如何判断镜像是否官方？ 官方镜像在 library/ 命名空间下。