Jenkins无法连接GitHub私有仓库问题求助

核心问题定位 #

EC2实例本地通过ssh -T git@github.com可正常完成GitHub认证，但Jenkins使用配置的私钥凭据无法连接私有仓库，排除网络层面问题，问题集中在Jenkins运行环境的SSH权限、凭据配置或主机密钥信任机制上。

具体排查与修复步骤 #

1. 检查Jenkins运行用户的SSH权限
   • Jenkins默认以jenkins用户运行，需确认该用户能正常使用私钥：
     • 登录EC2，切换至jenkins用户：sudo su - jenkins
     • 手动执行ssh -T git@github.com，验证是否能成功认证
     • 若失败，将私钥复制到/var/lib/jenkins/.ssh/目录，设置文件权限为600，目录权限为700
2. 修正Jenkins凭据配置
   • 放弃「用户名/密码」模式，选择「SSH Username with private key」类型：
     • 用户名固定填git（GitHub SSH认证统一使用该用户名）
     • 私钥选择「Enter directly」，完整粘贴生成的私钥内容（需包含开头-----BEGIN RSA PRIVATE KEY-----和结尾-----END RSA PRIVATE KEY-----）
     • 若选择「From a file on Jenkins master」，需确保jenkins用户拥有该文件的读取权限
3. 处理GitHub主机密钥信任问题
   • GitHub更新过主机密钥，Jenkins首次连接可能因未信任密钥失败：
     • 临时调试：在Jenkins全局配置的「Git」选项中，勾选「Disable git ssl verification」
     • 生产环境建议：在jenkins用户的~/.ssh/config中添加：

       Host github.com
           StrictHostKeyChecking no
       

4. 验证GitHub SSH密钥有效性
   • 确认GitHub账户中添加的公钥，是EC2实例上生成的密钥对的公钥，而非其他机器的密钥
   • 检查GitHub SSH密钥列表，确保该密钥未被标记为失效或删除
5. 确认Jenkins任务的Git仓库URL
   • 任务中填写的Git URL必须是SSH格式（如git@github.com:username/repo.git），而非HTTPS格式

调试技巧 #

• 在Jenkins任务中添加「Execute shell」步骤，执行ssh -vT git@github.com，查看详细SSH调试日志定位具体失败点
• 查看Jenkins系统日志（/var/log/jenkins/jenkins.log），提取认证相关的错误信息

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