升级Jenkins至2.36.1后代理节点SSH连接异常问题

排查方向1：密钥路径的节点兼容性 #

全局配置里的SSH密钥路径是控制器节点本地的路径，代理节点大概率没有对应路径或读取权限：

• 把密钥文件复制到代理节点的目标路径，确保Jenkins运行用户（如jenkins）拥有读取权限，执行命令：

  chmod 600 /path/to/your/private_key
  chown jenkins:jenkins /path/to/your/private_key
  

• 或者在代理节点的专属配置中，单独设置可访问的SSH密钥路径，不再复用全局配置路径。

排查方向2：代理节点的SSH环境变量缺失 #

代理节点的Jenkins进程可能未加载SSH相关环境变量，导致密钥无法被识别：

• 在代理节点的启动脚本中添加SSH代理配置，或手动执行以下命令加载密钥：

  eval $(ssh-agent -s)
  ssh-add /path/to/your/private_key
  

• 重启代理节点的Jenkins代理服务，确保环境变量生效。

排查方向3：Publish Over SSH插件的节点适配问题 #

插件在代理节点运行时可能无法正确读取全局配置的密钥：

• 任务配置中不再选择全局SSH服务器配置，而是单独配置代理节点可访问的密钥路径。
• 检查Jenkins全局安全配置，确保代理节点的执行用户拥有调用SSH插件的权限。

排查方向4：Jenkins 2.36.1的权限变更影响 #

该版本可能收紧了代理节点的文件访问权限：

• 检查代理节点Jenkins工作目录的权限设置，确保未限制读取外部文件。
• 查看Jenkins控制器和代理节点的系统日志（Manage Jenkins → System Log），搜索SSH相关错误（如权限拒绝、文件不存在），定位具体问题。

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