haomingz glab auth
管理 GitLab CLI 认证。
快速开始
# 交互式登录
glab auth login
# 查看当前认证状态
glab auth status
# 登录到其他实例
glab auth login --hostname gitlab.company.com
# 登出
glab auth logout
工作流程
首次设置
- 运行
glab auth login - 选择认证方式（token 令牌或浏览器）
- 按照提示操作，连接你的 GitLab 实例
- 使用
glab auth status验证
切换账户/实例
从当前账户登出：
glab auth logout登录到新实例：
glab auth login --hostname gitlab.company.com验证：
glab auth status
Docker 镜像仓库访问
配置 Docker 凭证助手：
glab auth configure-docker验证 Docker 是否可以认证：
docker login registry.gitlab.com拉取私有镜像：
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克隆仓库 - 首次克隆/推送前需要先完成认证