温馨提示×

linux gitlab token如何配

小樊
41
2026-09-25 18:09:58
栏目: 智能运维

在 Linux 下配置 GitLab Token,通常分为 使用 Personal Access Token(个人访问令牌) 或 使用 Deploy Token(部署令牌),最常见的是前者。下面按使用场景说明。


一、生成 GitLab Token

  1. 登录 GitLab
  2. 右上角头像 → Preferences
  3. 左侧 Access Tokens(个人令牌)
  4. 填写:
    • Name:如 linux-git
    • Expiration:可选
    • Scopes:
      • read_repository(拉代码)
      • write_repository(推代码)
  5. 点击 Create personal access token
  6. 复制保存 Token(只显示一次)

二、在 Linux 中使用 GitLab Token(最常用)

方式 1:HTTPS + Token 代替密码(推荐)

1. clone 仓库

git clone https://<username>:<token>@gitlab.com/yourgroup/yourrepo.git

示例:

git clone https://zhangsan:glpat-xxxxxx@gitlab.com/team/project.git

2. 已 clone 的仓库修改 remote

git remote set-url origin https://<username>:<token>@gitlab.com/yourgroup/yourrepo.git

方式 2:使用 Git Credential 缓存 Token(更安全)

git config --global credential.helper store

然后执行一次:

git pull

输入:

  • 用户名:你的 GitLab 用户名
  • 密码:粘贴 Token

之后 Token 会保存在:

~/.git-credentials

方式 3:使用 .netrc(适合脚本/CI)

vim ~/.netrc

内容:

machine gitlab.com
login your_username
password glpat-xxxxxx

权限:

chmod 600 ~/.netrc

三、SSH 方式(不用 Token,用 Key)

如果你用 SSH,就不需要 Token:

ssh-keygen -t ed25519 -C "your@email.com"
cat ~/.ssh/id_ed25519.pub

复制到 GitLab → SSH Keys

git clone git@gitlab.com:group/project.git

四、CI / 脚本中使用 Token(环境变量)

export GITLAB_TOKEN=glpat-xxxxxx
git clone https://oauth2:${GITLAB_TOKEN}@gitlab.com/group/project.git

五、常见问题

✅ Token 失效

  • 过期时间到了
  • 用户被禁用
  • Token 被撤销

✅ 403 / 401

  • Scope 没选 read_repository
  • 用户名写错
  • 私有仓库无权限

如果你告诉我:

  • GitLab 是 公网 还是 私有部署
  • 用在 本地 / CI / Docker

我可以给你更精确的配置示例。

0 踩