可登录Docker Registry但无法推送镜像至GitHub私有仓库求助

看来你遇到的是典型的GitHub Packages令牌权限不足问题，结合报错和你的操作场景，我帮你拆解原因和解决步骤：

核心原因分析 #

1. 登录所用令牌权限缺失：你执行docker login时，大概率用的是GitHub自动生成的临时令牌（比如通过GitHub CLI登录时的令牌），或者是没有配置packages相关权限的旧令牌。这类自动生成的令牌通常不会显示在你的「Personal access tokens」列表里，而且权限非常有限，满足不了私有仓库镜像推送的需求。
2. 未使用手动创建的个人访问令牌（PAT）：如果你的GitHub账号开启了两步验证（2FA），用普通密码登录Docker是无效的；即使没开2FA，手动创建的PAT才能精准配置推送镜像所需的权限，而不是依赖默认的登录凭证。

分步解决办法 #

1. 创建具备正确权限的个人访问令牌（PAT） #

• 打开GitHub的「Settings」→「Developer settings」→「Personal access tokens」→「Tokens (classic)」（推荐用classic令牌，配置更直接）。
• 勾选以下必要权限：
  • write:packages：允许推送镜像到GitHub Packages
  • read:packages：推送过程中需要读取仓库的package信息
  • repo：因为是私有仓库，需要关联仓库的读写权限（确保你能访问目标仓库）
• 点击「Generate token」，务必立刻复制生成的令牌并保存到安全的地方——GitHub不会再显示这个令牌内容。

2. 用新PAT重新登录Docker #

• 先退出之前的无效登录：

  docker logout docker.pkg.github.com
  

• 执行登录命令，输入你的GitHub用户名，然后把刚才复制的PAT作为密码输入（终端输入密码时不会显示字符，直接粘贴回车即可）：

  docker login docker.pkg.github.com --username YOUR_GITHUB_USERNAME
  

3. 重新执行推送操作 #

如果之前的镜像标签是正确的，直接推送即可；不确定的话可以重新打标再推送：

# 重新打标（如果需要）
docker build . --tag docker.pkg.github.com/user-name/repo/IMAGENAME:snapshot
# 推送镜像
docker push docker.pkg.github.com/user-name/repo/IMAGENAME:snapshot

额外注意事项 #

• 确认你的GitHub账号确实在目标私有仓库的协作列表中，且拥有「Write」或更高权限（可以让仓库管理员在仓库的「Collaborators and teams」页面检查）。
• 不要用GitHub账号的普通密码登录Docker，尤其是开启了2FA的情况下，必须使用PAT才能成功验证。

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