跳到主要内容

14.11.4 配置个人 Git Token

在 Review Required 或 E-Signature 模式下,每个用户需要配置自己的 Git Personal Access Token, 用于推送个人分支和创建 Merge Request。

为什么需要个人 Token?​

  • 管理员配置的系统服务令牌用于后台自动化操作
  • 用户发起的推送和 MR 创建需要使用个人令牌,以便在 Git 历史中正确记录提交者身份
  • 个人令牌确保每个用户的提交可追溯、不可否认

配置步骤​

1. 生成 Personal Access Token​

在 GitLab 或 GitHub 中创建个人访问令牌(权限要求与管理员配置相同)。

2. 打开个人设置​

点击右上角用户头像,在下拉菜单中选择带有邮箱的菜单项,打开个人设置弹窗。

3. 切换到 Git 标签页​

在个人设置弹窗中,点击 Git 标签页。

Git Token 配置页面

4. 填写 Token​

在输入框中粘贴您的 Personal Access Token。

5. 测试 Token​

点击 测试 按钮验证 Token 有效性。测试通过后会显示"连接成功"。

6. 保存​

点击 保存 按钮完成配置。

GPG 公钥​

在 Git 标签页下方,可以看到您的 GPG 公钥信息(如果管理员已为您生成)。

  • 点击 复制公钥 可复制 GPG 公钥
  • 将公钥添加到 GitLab/GitHub 的 GPG Keys 设置中,即可对您的提交进行自动签名验证
  • 点击 验证配置 可检查远程 Git 服务上的 GPG 配置是否正确

GPG 密钥由管理员在「管理控制台 → 版本控制 → 电子签名密钥」页面中生成。详见 GPG 密钥管理。

常见问题​

Q: 不配置个人 Token 可以吗?

在 Version Track 模式下不需要。在 Review Required / E-Signature 模式下,未配置个人 Token 会导致 Check-In 失败。

Q: Token 过期了怎么办?

重新生成 Token 后,在个人设置中更新即可。

Q: 测试连接失败?

检查 Token 权限是否足够,以及 Token 是否已过期。