---

name: glab-auth description: 管理 GitLab CLI 认证，包括登录/登出、检查认证状态、切换账户以及配置 Docker 镜像仓库访问。适用于首次设置 glab、排查认证问题、切换 GitLab 实例/账户或配置 Docker 从 GitLab 镜像仓库拉取镜像。触发关键词：auth、login、logout、认证、凭证、token、Docker 镜像仓库。

glab auth

管理 GitLab CLI 认证。

快速开始

# 交互式登录
glab auth login

# 查看当前认证状态
glab auth status

# 登录到其他实例
glab auth login --hostname gitlab.company.com

# 登出
glab auth logout

工作流程

首次设置

1. 运行 glab auth login
2. 选择认证方式（token 令牌或浏览器）
3. 按照提示操作，连接你的 GitLab 实例
4. 使用 glab auth status 验证

切换账户/实例

1. 从当前账户登出：

   glab auth logout
   

2. 登录到新实例：

   glab auth login --hostname gitlab.company.com
   

3. 验证：

   glab auth status
   

Docker 镜像仓库访问

1. 配置 Docker 凭证助手：

   glab auth configure-docker
   

2. 验证 Docker 是否可以认证：

   docker login registry.gitlab.com
   

3. 拉取私有镜像：

   docker pull registry.gitlab.com/group/project/image:tag
   

故障排查

"401 Unauthorized"（未授权）错误：

• 检查状态：glab auth status
• 验证 token 是否过期（在 GitLab 设置中查看）
• 重新认证：glab auth login

多实例场景：

• 使用 --hostname 参数指定实例
• 每个实例的认证信息独立维护

Docker 认证失败：

• 重新运行：glab auth configure-docker
• 检查 Docker 配置：cat ~/.docker/config.json
• 确认凭证助手已设置："credHelpers": { "registry.gitlab.com": "glab-cli" }

子命令

详细参数文档请参见 references/commands.md：

• login - 向 GitLab 实例进行认证
• logout - 从 GitLab 实例登出
• status - 查看认证状态
• configure-docker - 配置 Docker 使用 GitLab 镜像仓库
• docker-helper - Docker 凭证助手
• dpop-gen - 生成 DPoP 令牌

相关技能

初始设置：

• 完成认证后，参见 glab-config 设置 CLI 默认配置
• 参见 glab-ssh-key 进行 SSH 密钥管理
• 参见 glab-gpg-key 设置提交签名

仓库操作：

• 参见 glab-repo 克隆仓库
• 首次克隆/推送前需要先完成认证