拥有维护者权限的非个人名下GitLab仓库如何实现SSH免密拉取

前置确认 #

你个人名下仓库可正常免密拉取，说明你绑定到GitLab账号的SSH密钥本身是有效的，可排除密钥本身失效的可能，注意：你无需将SSH公钥提交给仓库所有者添加，只要你自己的GitLab账号有目标仓库的访问权限，绑定在你个人GitLab账号下的公钥即可生效，按以下步骤排查即可：

• 步骤1：确认拉取地址格式正确
  目标仓库必须使用SSH格式的拉取地址，而非HTTPS格式：
  正确格式：git@<GitLab服务器IP>:<仓库所属账号/组名>/<仓库名>.git
  错误格式：https://<GitLab服务器IP>/<仓库所属账号/组名>/<仓库名>.git
  你可以执行git remote -v查看本地绑定的远程地址，若格式错误执行以下命令修改：
  git remote set-url origin <正确的SSH格式地址>
• 步骤2：排查SSH密钥匹配问题
  如果你的Linux服务器上存储了多对SSH密钥，SSH客户端可能默认没有选中你绑定到GitLab账号的对应密钥，可通过以下两种方式解决：
  临时测试验证：拉取时指定对应私钥，命令如下：
  git clone -c core.sshCommand="ssh -i ~/.ssh/<你绑定GitLab的私钥文件名>" <仓库SSH地址>
  若该命令可正常免密拉取，说明是默认密钥匹配问题，可做永久配置：
  编辑~/.ssh/config文件，添加如下配置：

  Host <你的GitLab服务器IP>
    User git
    IdentityFile ~/.ssh/<你绑定GitLab的私钥文件名>
    IdentitiesOnly yes
  

  保存后执行chmod 600 ~/.ssh/config修正配置文件权限，后续拉取会自动使用指定密钥。
• 步骤3：排查权限异常问题
  1. 确认你的GitLab账号在目标仓库的成员列表中，权限等级不低于Reporter（你提到是Maintainer权限可跳过此步，若后续权限变动可在此排查）
  2. 修正服务器本地SSH相关文件权限，权限异常会导致SSH客户端拒绝使用密钥：

     chmod 700 ~/.ssh
     chmod 600 ~/.ssh/<你的GitLab绑定私钥文件名>
     chmod 644 ~/.ssh/<你的GitLab绑定公钥文件名>
     

• 验证方法
  所有配置完成后，执行ssh -T git@<GitLab服务器IP>，若返回Welcome to GitLab, @<你的GitLab用户名>!说明SSH认证已正常生效，可直接免密拉取目标仓库。

内容的提问来源于stack exchange，提问作者Nikhil S