Jenkins远程SSH代理PATH环境变量异常，咨询永久配置方案

这个问题我之前帮同事排查过好几次，核心原因其实是Jenkins的SSH代理启动的是非交互式非登录shell，和你手动SSH登录时的shell环境完全不一样：手动登录是交互式登录shell，会依次加载/etc/profile、~/.bash_profile这类配置；而Jenkins触发的shell是非交互式的，只会加载~/.bashrc（bash的情况）或者对应shell的非交互式配置文件，导致你的/usr/local/bin没被加入PATH。

下面是几个永久解决的方案，按优先级推荐：

1. 直接在Jenkins代理节点配置环境变量（最推荐） #

这是最直接且不影响代理机器本地环境的方法：

• 登录Jenkins管理界面，进入「管理节点」页面
• 找到你的SSH代理节点，点击右侧的「配置」按钮
• 下拉到「节点属性」区域，勾选「环境变量」选项
• 点击「添加」，输入变量名PATH，变量值填/usr/local/bin:$PATH
• 保存配置后，这个节点上的所有后续构建都会自动继承这个PATH，完全不用在Pipeline里写临时配置了

2. 修改代理机器的shell非交互式配置文件 #

如果希望从代理机器层面解决，可以针对非交互式shell配置PATH：

• SSH登录到代理机器，编辑对应shell的配置文件：
  • 如果用bash：vim ~/.bashrc
  • 如果用zsh：vim ~/.zshrc
• 在文件末尾（注意看开头有没有[ -z "$PS1" ] && return这类判断，要把配置加在这行之前）添加：

  export PATH="/usr/local/bin:$PATH"
  

• 保存退出后，下次Jenkins连接这个代理时，shell会自动加载这个配置，PATH就会包含目标路径了

3. 配置Jenkins全局环境变量（全局生效） #

如果你的所有Jenkins节点都需要添加这个路径，可以用全局配置：

• 进入Jenkins的「管理Jenkins」→「系统配置」页面
• 下拉到「全局属性」区域，勾选「环境变量」
• 添加PATH变量，值填/usr/local/bin:$PATH
• 保存后，所有节点（包括SSH代理节点）的构建都会使用这个全局PATH配置

验证小技巧 #

配置完成后，可以在Pipeline里加一行简单的命令验证是否生效：

sh 'echo $PATH'

运行构建后查看控制台输出，确认/usr/local/bin已经出现在PATH里就搞定了。

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