无法从GitHub容器注册表拉取私有Docker镜像的问题求助

检查PAT权限配置 #

• 必须勾选以下核心权限：
  • read:packages：私有镜像读取的基础权限
  • repo：若镜像关联私有GitHub仓库，需此权限完成关联校验
  • 若需推送镜像可额外勾选write:packages
• 注意：权限需完整覆盖，仅勾选部分权限会导致访问被拒

规范执行Docker登录与拉取命令 #

1. 先执行登录命令（替换为你的账号信息）：

docker login ghcr.io -u YOUR_GITHUB_USERNAME -p YOUR_PAT_TOKEN

2. 登录成功后，执行带完整标签的拉取命令：

docker pull ghcr.io/<OWNER_NAME>/<IMAGE_NAME>:TAG

• 重点：拉取命令必须包含具体标签（如latest或Workflow生成的版本标签），仅写镜像名会触发权限校验失败

确认镜像访问权限归属 #

• 进入GHCR包页面，查看「Access control」设置，确保你的GitHub账号或所在团队被添加为「Viewer」及以上权限
• 若镜像属于组织，需确认组织权限规则未限制你的账号访问

清理本地Docker认证缓存 #

若本地存在旧的错误认证信息，先清理再重新登录：

docker logout ghcr.io

验证PAT有效性 #

通过GitHub API测试PAT权限是否正常：

curl -H "Authorization: token YOUR_PAT_TOKEN" https://api.github.com/user/packages/docker/<IMAGE_NAME>/versions

• 返回正常数据说明PAT权限有效；若报错，检查PAT权限配置或镜像名称是否正确

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