glab-auth

# glab auth 管理 GitLab CLI 认证。 ## 快速开始 ```bash # 交互式登录 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. **从当前账户登出：** ```bash glab auth logout ``` 2. **登录到新实例：** ```bash glab auth login --hostname gitlab.company.com ``` 3. **验证：** ```bash glab auth status ``` ### Docker 镜像仓库访问 1. **配置 Docker 凭证助手：** ```bash glab auth configure-docker ``` 2. **验证 Docker 是否可以认证：** ```bash docker login registry.gitlab.com ``` 3. **拉取私有镜像：** ```bash 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](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` 克隆仓库 - 首次克隆/推送前需要先完成认证