Jenkins如何将本地环境变量传递至远程机器执行脚本

我之前也遇到过一模一样的Jenkins场景——本地生成环境变量后要传到远程SSH会话执行命令，试了好几种方法，下面这几个亲测有效：

方法1：直接在SSH命令中注入变量（最简单快捷） #

不用折腾Jenkins的全局环境变量配置，直接把本地生成的变量值拼接到SSH命令里，让远程会话直接使用。

比如你本地先执行命令生成GOOD_VARIABLE的值，然后通过SSH传递：

# 本地生成变量值，替换成你的实际初始化命令
GOOD_VARIABLE=$(your-local-init-command)

# SSH远程执行时，先设置变量再执行命令
ssh your-user@remote-host "GOOD_VARIABLE=$GOOD_VARIABLE ${GOOD_VARIABLE}"

原理是：本地shell会先解析双引号里的$GOOD_VARIABLE，把它替换成实际的变量值，然后把完整的命令字符串传给远程主机，远程shell会先设置GOOD_VARIABLE，再执行对应的命令。

方法2：通过Jenkins构建环境传递变量（适合复用场景） #

如果你已经在构建前脚本里尝试注入环境变量但没生效，问题出在Jenkins的本地环境变量不会自动同步到SSH会话里。你需要让Jenkins把这个变量暴露给后续的SSH步骤：

1. 在Jenkins的「构建前执行shell」里，用export声明变量，或者写入Jenkins的构建环境文件：

# 生成变量并导出到当前构建环境
export GOOD_VARIABLE=$(your-local-init-command)

# 可选：写入Jenkins的构建环境文件，确保后续步骤能稳定读取到
echo "GOOD_VARIABLE=$GOOD_VARIABLE" >> $BUILD_ENVIRONMENT

2. 如果你用的是Jenkins的Publish Over SSH插件，在「Exec command」里直接引用变量即可：

GOOD_VARIABLE=${GOOD_VARIABLE} ${GOOD_VARIABLE}

插件会自动把Jenkins构建环境里的变量传递到SSH执行的上下文里。

方法3：用SSH的SendEnv选项（适合多变量传递） #

如果需要传递多个本地变量，可以用SSH的SendEnv参数，但前提是你有权限修改远程主机的sshd_config：

1. 本地先导出变量：

export GOOD_VARIABLE=$(your-local-init-command)

2. SSH命令中指定要传递的变量：

ssh -o SendEnv=GOOD_VARIABLE your-user@remote-host "${GOOD_VARIABLE}"

3. 远程主机需要在/etc/ssh/sshd_config里添加：

AcceptEnv GOOD_VARIABLE

然后重启sshd服务。这个方法适合批量传递变量，但配置稍复杂，没有远程主机权限的话不推荐。

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