**快速答案。**最常用到的那些参数:-p <port>(非标准端口)、-i <key>(强制指定某把密钥)、-L / -R / -D(本地、远程和动态转发)、-J <bastion>(经堡垒机跳转)、-N -f(把隧道放到后台、不开 shell)、-t(为 sudo 强制分配一个 TTY)、-o Option=value(就地设置任意 ssh_config 指令),以及 -vvv(调试一次失败的连接)。任何你会传两次的东西,都该写进 ~/.ssh/config,这样 ssh web1 一个参数都不用带就能带上它们。
ssh --help 会按字母顺序一股脑倒出四十个参数,而这正是学习它们最没用的方式。你去找某个参数,靠的是你想做什么——换个用户连接、转发一个端口、经堡垒机跳一下、调试一次连接被拒——所以下面把同一批参数按任务重新组织了一遍,并顺带标出哪些该停止手敲、改为写进你的 ssh_config(英文)。
贯穿这一切的一条准则:参数用于一次性的事,配置用于长久固定的事。 任何你传了两次的东西,都该进到文件里去。
连接基础
这些参数回答的是“谁、在哪里、用哪把密钥”。
-p <port>——连接到一个非标准端口。ssh -p 2222 user@host。(小写-p;大写-P是 scp 的端口参数,每个人都会被绊倒一次。)-l <user>——登录用户,是user@前缀之外的另一种写法。ssh -l deploy host等同于ssh deploy@host;你会在脚本和较老的文档里见到-l。-i <identity>——指向某一把特定的私钥。ssh -i ~/.ssh/work_ed25519 user@host。这是认证失败时最有用的参数:它强制使用确切的那把密钥,而不是让 agent 去猜。-F <configfile>——使用另一个配置文件。ssh -F ./project.sshconfig web1,或者用-F /dev/null来忽略你的个人配置、在零定制的状态下测试。-v/-vv/-vvv——详细程度,也是能了结大多数谜团的参数。一个-v会显示尝试过的认证方式和提交过的密钥;-vvv会显示完整的握手过程。当有东西失败时,先用-vvv再跑一遍,然后再去推测——读懂那段调试输出本身就是一门功夫。
-o 这个万能出口
这是一个值得深入理解的参数,因为它涵盖了其余几十个。-o 能在命令行里就地设置任意 ssh_config 选项。 凡是你能写进 ~/.ssh/config 某个 Host 块里的东西,都可以用 -o Option=value 的形式传进去——不是一小撮被钦定的选项,而是整套配置词汇,全都能为单次连接所用。
几个经常用到的:
ssh -o IdentitiesOnly=yes -i ~/.ssh/right_key user@host # 只提交这一把密钥
ssh -o StrictHostKeyChecking=accept-new user@host # 信任新主机,但仍能发现变化
ssh -o ServerAliveInterval=30 user@host # 为不稳定的链路做保活
ssh -o ProxyJump=bastion.example.com db.internal # 在命令行里直接经堡垒机跳转
当你的 agent 提交了六把密钥、而一台严格的服务器在第五把之后就把你掐断时,-o IdentitiesOnly=yes 就是 Too many authentication failures 的解药。-o StrictHostKeyChecking=accept-new 则是理智的折中——自动信任一台你从没见过的主机,但在一台已知主机的密钥发生变化时照样大喊大叫。
重点在于:你不需要为每一种行为都准备一个专门的参数。只要你知道那条配置指令,你就知道了那个参数——它就是 -o Directive=value。一旦你每次都要传三四个,就把它们永久地搬进配置里。
转发与隧道
这些是搞端口“管道”的参数。其中的心智模型——是哪一侧打开端口——在 SSH 端口转发详解里有专门的一篇;这里只做参数小结。
-L <local>:<host>:<port>——本地转发。在你的机器上打开一个端口,它会通向一个从服务器那端可达的目的地。ssh -L 5432:localhost:5432 db.example.com会把一个远程数据库带到你本地的127.0.0.1:5432。-R <remote>:<host>:<port>——远程转发。在服务器上打开一个端口,它会通回到你这一侧——这是用来触达 NAT 之后机器的反向隧道妙招。-D <port>——动态转发。在你的机器上开一个 SOCKS 代理;目的地按每条连接各自决定。ssh -D 1080 jump.example.com,然后把浏览器指向127.0.0.1:1080。-N——不运行远程命令。当你只想要隧道、不想要 shell 时,把它和任意转发搭配使用。-f——在ssh连接之后把它放到后台。与-N组合,就是一条“设好就不用管”的隧道:ssh -fN -L 5432:localhost:5432 db.example.com。-g——让你局域网上的其他机器也能使用本地(-L/-D)转发,而不只是127.0.0.1。这是一处小小的暴露——你把隧道开放给了整个网络,所以要有意识地使用它。
跳板主机与 agent
触达下一跳,以及一个你该当心的参数。
-J <jumphost>——ProxyJump。经过一台堡垒机建立隧道,并从你的笔记本到目标机器端到端地完成认证。ssh -J bastion.example.com db.internal。堡垒机只是来回搬运加密的字节;你的密钥绝不会落在它上面——这才是穿过网关的正确方式。完整论述:ProxyJump:触达堡垒机之后的服务器。-A——agent 转发。它会在远程主机上暴露一个套接字,把签名请求代理回你本地的 agent,于是那里的某个进程就能以你的身份向下一台服务器认证。方便,但比看上去更危险:只要会话还开着,那台主机上任何拥有 root 的人都能借用你的身份。要“触达下一跳”就用-J,把-A留给你完全信任的主机——原因都在 agent 转发既方便又危险(英文)里。
两者之间的区别:-J 把你的 shell 送到堡垒机之后的一台主机,而不把你的密钥借给任何人;-A 则把你密钥的实时使用权借给了你所连上的那台机器。这不是同一种取舍。
会话控制
这些小参数,各自解决一个具体的烦恼。
-t——强制分配一个伪终端。当某个远程命令需要交互式 TTY 时用得上:ssh -t host 'sudo systemctl status nginx'会给你一个真正的终端,用于sudo的提示和带颜色的输出。叠成两个(-tt)可以在本地没有 TTY 时也强制分配一个。-q——安静模式。抑制警告和横幅;在脚本里只想要命令本身的输出时很有用。-C——请求压缩。在慢速、高延迟的链路上确有收益;在快速局域网上则可忽略不计,甚至略有负作用。-o BatchMode=yes——绝不弹出提示。如果认证需要密码或密码短语,它会立即失败,而不是卡在那里。正是它让 SSH 在 cron 和 CI 里变得安全——无人值守的脚本里一个卡住的提示会永远挂着。
SSH 用哪个端口?
SSH 默认使用 TCP 的 22 端口——当你不另作说明时,ssh、scp、sftp 以及走 SSH 的 git 都默认是它。要连接一台在别处监听的服务器,用 -p 把端口传进去:
ssh -p 2222 user@host
要改变服务器监听的端口,在 /etc/ssh/sshd_config 里设置 Port 并重启 sshd——然后在退出登录之前,务必在主机防火墙和云安全组里都放行新端口,因为换了 SSH 端口却不放行新端口,是把自己锁在门外最快的办法。(离开 22 端口能让顺手扫描的工具安静下来;但它本身算不上真正的安全。)在你的 ssh_config(英文) 里给每台主机设一次 Port 2222,你就再也不用敲 -p 了。
如何通过 SSH 执行一条命令而不开 shell
把命令用引号括起来放在主机之后,SSH 就会执行它、打印输出,然后退出——不会打开交互式 shell:
ssh user@host 'df -h /'
ssh user@host 'systemctl is-active nginx'
这是脚本和 cron 的主心骨:一次连接、一条命令、一个你能拿去判断的退出码。给命令加引号,免得你本地的 shell 抢先把它展开了。这里有两个参数要紧:
-t为需要 TTY 的命令强制分配一个——ssh -t user@host 'sudo systemctl restart nginx'会给sudo一个真正的交互式提示。-o BatchMode=yes(或-n)让它不再等待输入,于是无人值守的任务会快速失败,而不是卡在某个提示上。
如何退出一个 SSH 会话
输入 exit,或按 Ctrl-D,即可关闭 shell 并断开连接。 两者都会向远程 shell 发送文件结束符(EOF),把你登出并带回到你本地的提示符:
exit # 或按 Ctrl-D
当一个会话冻住时——链路已死,终端对一切都置之不理,连 Ctrl-C 也不例外——exit 帮不上忙,因为你敲的任何东西都到不了对端。这时改用 SSH 自己的转义序列:先按 Enter,再输入 ~.(先波浪号,再句点)。这会告诉你本地的 ssh 立刻把连接拆掉,无论远端卡成什么样。~ 转义只有紧跟在换行之后才会被读取,这就是你要先按 Enter 的原因。
紧凑参考表
| 参数 | 作用 | ssh_config 中的等价写法 |
|---|---|---|
-p 2222 | 非标准端口 | Port 2222 |
-l user / user@ | 登录用户 | User user |
-i ~/.ssh/key | 指定身份密钥 | IdentityFile ~/.ssh/key |
-F file | 另一个配置文件 | —(这就是配置本身) |
-v … -vvv | 详细 / 调试输出 | LogLevel DEBUG3 |
-o Opt=val | 在命令行里设任意配置选项 | (选项本身) |
-L a:host:b | 本地转发 | LocalForward a host:b |
-R a:host:b | 远程转发 | RemoteForward a host:b |
-D 1080 | 动态(SOCKS)转发 | DynamicForward 1080 |
-N | 不执行远程命令 | RequestTTY no(且不带命令) |
-f | 连接后转入后台 | —(仅限一次性使用) |
-g | 把转发开放给局域网 | GatewayPorts yes |
-J host | 经堡垒机跳转 | ProxyJump host |
-A | 转发 agent | ForwardAgent yes |
-t | 强制分配 TTY | RequestTTY force |
-q | 安静模式 | LogLevel QUIET |
-C | 压缩 | Compression yes |
-o BatchMode=yes | 绝不弹出提示 | BatchMode yes |
右边那一列才是关键线索。几乎每个参数都有对应的配置写法,而这正是工作流:先用参数跑一次、证明连接能通,再把那些你会重复用的搬进 ~/.ssh/config,这样 ssh web1 就带齐了它们,一个参数都不用敲。那些没有配置等价写法的参数——-f、-F、调试详细度——才是真正一次性的。
一个客户端如何替你保管这些状态
参数和配置都住在你的 dot 文件里,一台机器一份,这在规模变大时就开始让人头疼:设置靠手动在各台笔记本之间复制,隧道每次睡眠之后都要重跑,四十台主机里哪台是活的也无从一眼看出。Termalin 把一个参数会携带的那些信息——端口、用户、密钥、跳板主机、保活设置、保存好的本地/远程/动态转发——作为结构化数据挂在主机上,用文件夹和标签组织起来,并在你的各台机器之间端到端加密地同步。它会在首次连接时验证每台服务器、按主机显示实时状态,并随连接一起启动隧道,而不是让你重敲一条命令。参数教会你正在发生什么;而一个客户端,让你不必每天早上把它们重敲一遍。
Termalin 是一款免费、跨平台的 SSH 客户端,替你保存每台主机的设置、密钥和隧道——下载它,或读一读它如何安全地管理你的密钥。