GitHub Codespaces 推送 Docker 镜像权限不足问题全解：从报错到解决-- unauthorized: access token has insufficient scopes

在利用 GitHub Codespaces 构建并推送 Docker 镜像时，不少开发者会遇到 “unauthorized: access token has insufficient scopes” 的报错。本文将深入剖析这一报错背后的原因，并提供详细、可行的解决方案，帮助大家顺利完成镜像推送任务。

异常原因

最近在进行镜像构建工作时，我选择了 GitHub 提供的 Codespaces 来构建 Docker 镜像。然而，在完成镜像构建，满心欢喜准备推送镜像时，却遇到了 “unauthorized: access token has insufficient scopes” 这样的报错。从报错信息不难看出，这是权限方面的问题，提示当前使用的访问令牌权限域不足。如下图:

这里需要了解的是，GitHub 默认的 Docker 镜像仓库是 ghcr.io，而我需要将镜像推送至 docker.io。由于没有退出默认登录状态并重新登录 docker.io 仓库，才导致了这个权限问题。

解决办法

经过一番摸索，我找到了有效的解决办法：

1. 首先执行docker logout命令，退出当前的登录状态。这个步骤是为了清除之前可能存在的干扰登录信息，确保后续登录操作不受影响。
2. 接着使用docker login --username=xxx docker.io命令登录 docker.io 仓库。这里要特别提醒大家，在 Codespaces 环境下使用docker login登录 docker.io 时，务必指定用户名。否则，系统会默认跳转到网页授权登录方式，而目前login.docker.io这个网页无法正常使用，这会导致登录失败，无法完成镜像推送。

   操作示例：

   docker logout
   # 登录到docker.io仓库
   docker login --username=tekintian  docker.io
   

    

   操作图示

按照上述步骤操作后，我成功地将镜像推送到了 docker.io 仓库，顺利解决了权限不足的问题。

总结

本文聚焦于在 GitHub Codespaces 中推送 Docker 镜像时出现 “unauthorized: access token has insufficient scopes” 报错的情况。详细分析了报错原因，即默认仓库与目标仓库不一致且未重新登录导致权限问题，并给出了具体的解决步骤：先退出当前登录，再指定用户名登录 docker.io 仓库。希望通过这些内容，能帮助大家在遇到类似问题时迅速解决，提升开发效率。

TAG：GitHub、Codespaces、Docker、镜像推送、权限问题