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

背景

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

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

设置方法

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

Host myserver

        ...

        SendEnv=LC_MYVAR       

        SetEnv LC_ALL=zh_CN.utf8       

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

ssh -o SendEnv=LC_MYVAR -o SetEnv="LC_ALL=zh_CN.utf8" example.com

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

AcceptEnv LANG LC_CTYPE LC_NUMERIC LC_TIME LC_COLLATE LC_MONETARY LC_MESSAGES 

AcceptEnv LC_PAPER LC_NAME LC_ADDRESS LC_TELEPHONE LC_MEASUREMENT 

AcceptEnv LC_IDENTIFICATION LC_ALL LANGUAGE

AcceptEnv XMODIFIERS 

Ubuntu 16.04 / MacOS 11.3

AcceptEnv LANG LC_*

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