SSH连接时发送/设置环境变量

Posted 2023-05-11

参考技术A SSH连接时有时需要自动设置特定的环境变量，如LANG等。如果您使用专用的图形化SSH终端，如XShell之类的工具，可以直接在相应软件的连接配置文件里设置。这里记录的是直接在 终端使用SSH命令连接 的情况下，发送环境变量的两种方法（SendEnv和SetEnv）。

SendEnv需要提供一个或多个本地已存在的环境变量名，将本地环境变量发送到远程主机上去；SetEnv可以直接指定一个新的环境变量名和值设置到远程主机上。

1. 如果你在使用ssh config配置文件(~/.ssh/config)，格式如下：

2. 如果你想在命令行场景下中使用，格式如下[1]：

3. 也可以通过添加K=V格式的环境变量到~/.ssh/environment文件来设置对所有SSH主机都要应用的环境变量，但是这些环境变量仍然受到服务器sshd设置中AcceptEnv的限制。

1. SetEnv是OpenSSH 7.8新增加的特性，发布于2018年。而SendEnv早就已经普遍支持。

2. 有些极特殊的环境变量如(TERM)暂时还不能通过SetEnv/SendEnv设置，见文章[2]。

3. 你想要设置的变量，必须在服务端/etc/ssh/sshd_config里用AcceptEnv明确允许接收。如果要设置的变量不在其中，需要在sshd配置里加入，或者利用PermitUserEnvironment配置项详细配置，或者看下面一条注意事项中的间接绕过方法。

实测默认允许接收的变量如下：

CentOS 8

Ubuntu 16.04 / MacOS 11.3

4. 另一种发送环境变量的思路是设置连接后自动执行的命令去export变量(类似于文章[1]中提到的workaround)。也可以考虑利用RemoteCommand配置项，但可能有其他问题，如运行ssh hostname command格式的(非交互式shell)命令时可能会报错。见文章[3]提到的问题。

[1]  When ssh'ing, how can I set an environment variable on the server that changes from session to session?

[2]  SSH: Behavior of SetEnv for TERM variable

[3]  Remote command in ssh config file

如何解决ssh连接CentOS后中文显示乱码

需要将终端（ssh连接成功就是远程终端）的编码设置成中文编码，改变终端编码需要设置LANG这个环境变量，设置方法是在终端输入LANG=zh_CN.UTF-8，设置好LANG变量后编码字符集就改变了。
在终端直接设置LANG环境变量的方式，在下次登录或下次打开虚拟终端时，设置就生效了。如果不想每次打开终端都输入LANG=zh_CN.UTF-8设置一遍，可以把LANG=zh_CN.UTF-8这一行内容加入到~/.bashrc这个配置文件中，保存退出这个配置文件后再执行命令：
source ~/.bashrc
使配置文件的设置马上生效。 参考技术A 在会话设置里面把编码换成utf-8就可以了。