termal.in

← 博客

你真正会用到的 SSH 命令行参数(一份实用速查表)

· 更新于 2026年11月12日 · Termalin Team sshcheat-sheetproductivitytutorial

**快速答案。**最常用到的那些参数:-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转发 agentForwardAgent yes
-t强制分配 TTYRequestTTY force
-q安静模式LogLevel QUIET
-C压缩Compression yes
-o BatchMode=yes绝不弹出提示BatchMode yes

右边那一列才是关键线索。几乎每个参数都有对应的配置写法,而这正是工作流:先用参数跑一次、证明连接能通,再把那些你会重复用的搬进 ~/.ssh/config,这样 ssh web1 就带齐了它们,一个参数都不用敲。那些没有配置等价写法的参数——-f、-F、调试详细度——才是真正一次性的。

一个客户端如何替你保管这些状态

参数和配置都住在你的 dot 文件里,一台机器一份,这在规模变大时就开始让人头疼:设置靠手动在各台笔记本之间复制,隧道每次睡眠之后都要重跑,四十台主机里哪台是活的也无从一眼看出。Termalin 把一个参数会携带的那些信息——端口、用户、密钥、跳板主机、保活设置、保存好的本地/远程/动态转发——作为结构化数据挂在主机上,用文件夹和标签组织起来,并在你的各台机器之间端到端加密地同步。它会在首次连接时验证每台服务器、按主机显示实时状态,并随连接一起启动隧道,而不是让你重敲一条命令。参数教会你正在发生什么;而一个客户端,让你不必每天早上把它们重敲一遍。


Termalin 是一款免费、跨平台的 SSH 客户端,替你保存每台主机的设置、密钥和隧道——下载它,或读一读它如何安全地管理你的密钥。

先在一台主机上试试。

Termalin 是为你和你的智能体打造的高速 SSH 客户端。

免费版 · Pro 14 天试用 · 价格

将 Termalin 添加为 Google 上的优先来源