Jenkins连接GitLab仓库失败：SSH密钥格式无效、权限被拒

核心问题定位 #

错误日志中的Load key "/tmp/jenkins-gitclient-sshxxxx.key": invalid format是关键，说明Jenkins调用的私钥格式不被系统识别，直接导致SSH认证失败，进而无法连接仓库。

针对性解决步骤 #

• 检查SSH凭据的私钥格式
  确保在Jenkins中添加的私钥是完整的原始PEM格式：

  • 必须包含开头标记-----BEGIN OPENSSH PRIVATE KEY-----（或对应RSA密钥标记）和结尾标记-----END OPENSSH PRIVATE KEY-----
  • 私钥内容无多余换行、空格或注释，直接复制生成的私钥文件全部内容粘贴到凭据中，不要做任何格式修改。

• 修正Jenkins容器内私钥文件权限
  SSH私钥要求严格的权限控制，必须设置为仅所有者可读可写：
  进入Jenkins容器执行命令：

  chmod 600 /path/to/your/private-key-file
  

  若使用Jenkins临时生成的密钥文件，可在凭据配置时确认Jenkins会自动设置正确权限；若仍有问题，可手动指定密钥路径并调整权限。

• 确认GitLab公钥配置位置

  • 若为单个仓库授权，将公钥添加到GitLab项目的「部署密钥」中，并按需勾选「允许写入」；
  • 若为用户级授权，添加到GitLab个人账号的「SSH密钥」中；
  • 确保公钥内容完整无截断，结尾的用户标记（如user@hostname）可正常识别。

• 区分GitLab API令牌与SSH凭据的用途
  GitLab API令牌用于Jenkins与GitLab的集成（如Webhook、状态回传），而仓库拉取/推送依赖SSH凭据。确保在Jenkins项目配置的「源代码管理」中选择的是SSH用户名带私钥的凭据，而非API令牌凭据。

• 验证Git工具配置
  进入Jenkins「全局工具配置」，确认Git的安装路径正确（如/usr/bin/git），且版本与本地测试环境一致，避免因Git版本差异导致参数解析问题。

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