Docker Hub令牌异常：Bearer Token缺失Registry Scope致授权失败

问题原因 #

你请求的postgres是Docker Hub官方公共镜像，这类公共资源的pull权限是开放的，Docker Hub认证服务默认不会在返回的令牌中生成具体的access权限条目——因为无需显式授权即可访问。只有当请求的是私有镜像或者需要特定权限的操作时，令牌才会包含对应的access字段。

验证与解决方法 #

1. 测试公共镜像API访问
   即使令牌的access字段为空，它依然可以用于公共镜像的API操作。你可以用获取到的令牌尝试请求postgres镜像的标签列表：

   curl -H "Authorization: Bearer eyJhbGciOiJS..." "https://registry-1.docker.io/v2/postgres/tags/list"
   

2. 私有镜像场景修正
   如果你实际要访问的是私有镜像，需要修正scope参数的格式，使用私有仓库的完整路径：

   curl -X GET --basic --user myself "https://auth.docker.io/token?service=registry.docker.io&scope=repository:your-username/your-private-image:pull"
   

3. 检查PAT权限
   若使用个人访问令牌（PAT），确保创建PAT时勾选了对应权限（比如read:packages），尤其是访问私有资源时。

内容的提问来源于stack exchange，提问作者Erik van Velzen