termal.in

← 博客

~/.ssh/config 文件:别再重复输入同样的 SSH 参数

· 更新于 2026年11月12日 · Termalin Team sshssh-configproductivitytutorial

**快速答案。**创建 ~/.ssh/config(并 chmod 600),然后给每台服务器写一个 Host 块,填上 HostName、User、Port 和 IdentityFile——这样 ssh web1 就会展开成整条命令,而 scp、sftp、rsync 和 git 读的是同一个别名。第一个匹配者生效,所以把具体的主机写在前面,宽泛的 Host * 默认值放在最后。ProxyJump 够到堡垒机后面的主机;ServerAliveInterval 30 让空闲会话不掉线;IdentitiesOnly yes 固定一把密钥,这样严格的服务器就不会把你拒之门外。

如果你把 ssh -i ~/.ssh/work_ed25519 -p 2222 -o ServerAliveInterval=30 deploy@203.0.113.10 敲过不止两遍,那你花十分钟学一下 ssh_config,这笔时间早就赚回来了。它是你整套 SSH 配置里最以小博大的一个文件:把那一长串变成 ssh web1,而且 ssh、scp/sftp/rsync 等文件传输工具、git,以及任何会调起 SSH 的程序都会自动读取它。

下面就做一次实用讲解——那些真正值得一席之地的指令,以及值得知道的坑。

它在哪、怎么被读取

你的个人配置是 ~/.ssh/config(没有就创建一个;chmod 600)。此外还有一个系统级的 /etc/ssh/ssh_config。容易绊倒人的规则是:

  • **第一个匹配者生效,而不是最具体的那个。**SSH 从上往下读,每个选项它第一次看到的值,就是最终采用的值。把具体的主机放在最上面,宽泛的 Host * 默认值放在最下面。
  • 每个设置都写在某个 Host 块(一个模式)之下,按惯例缩进(缩进不是必须的,但为了让未来的自己读得顺,还是缩进吧)。

基本单元:一个主机别名

Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

现在 ssh web1 会展开成完整的命令。scp file.tar web1:/srv/、sftp web1 和 rsync -a ./dist/ web1:/var/www/ 也一样。别名正是关键所在:给服务器起一次名,之后到处都用这个名字。

值得一席之地的指令

**ProxyJump——经堡垒机够到服务器。**它是老式 ProxyCommand ... netcat 咒语的现代替代品:

Host db1
    HostName 10.0.0.5          # 私有地址,只能从堡垒机访问
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump

现在 ssh db1 会透明地借道 bastion,够到一台没有公网地址的主机。用逗号把它们串起来(ProxyJump a,b,c),就能应对更深的网络。

**保活设置——别让空闲会话死掉。**当你一走神就冒出 client_loop: send disconnect: Broken pipe 时,这就是解药:

Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4

每 30 秒发一个包,NAT 路由器和防火墙就不会忘掉你的连接;连续四次收不到回复(两分钟)之后它才放弃。

**IdentitiesOnly——只提交那把对的密钥。**如果你手上有好几把密钥,SSH 会把它们全都提交上去,而严格的服务器会回一句 Too many authentication failures。给每台主机固定一把密钥,别再让它瞎猜:

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

AddKeysToAgent——带密码短语的密钥只需解锁一次:

Host *
    AddKeysToAgent yes

模式与通配符——在一个块里配置一整批机器:

Host *.staging.example.com
    User deploy
    IdentityFile ~/.ssh/staging_ed25519

Host 10.0.*
    ProxyJump bastion

一份贴近实战的配置,从头到尾

# 具体主机写在前面(第一个匹配者生效)
Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

Host db1
    HostName 10.0.0.5
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump
    IdentityFile ~/.ssh/work_ed25519

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

# 宽泛的默认值放在最后
Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4
    AddKeysToAgent yes

文件变大后就拆分它:在文件开头写上 Include ~/.ssh/config.d/*,你就能按项目或客户分成一个个独立文件。

两个坑

  • “第一个匹配者生效”会咬你一口——当靠近顶部的某个 Host * 块设了一个你本想在下面覆盖掉的值时,它并不会被覆盖,因为更早的那个值已经赢了。默认值要放在最下面。
  • **注释是行首的 #。**某些选项里,写在值后面的行尾注释可能会被当成值的一部分解析——所以把注释单独放一行。

当配置文件不够用时

ssh_config 非常好用,人人都该有一份。它的局限会在配置超出一个文本文件所能承载时显现出来:你在机器之间手动同步它,把脱敏后的版本分享给同事,记着哪把密钥配哪个密码短语,又或者想一眼看出四十台主机里到底哪些还在线。

这正是 Termalin 补上的那道缝。它保留同样的按主机设置——主机名、用户、端口、密钥、跳板主机、保活——但把它们作为结构化数据挂在主机上,让你用文件夹和标签来组织;通过一个内置的密钥代理一次性解锁你的密钥;在首次连接时验证每台服务器;并在列表里显示每台主机的实时状态。它能导入你现有的 PuTTY 会话,主机列表也会在你的各台机器之间端到端加密同步。文件能撑到一定规模;而一个替你保管状态的客户端,能撑得更远。

无论哪种方式,道理不变:给服务器起一次名,就再也不用重复输入它的命令行参数了。


Termalin 是一款免费、跨平台的 SSH 客户端,替你管理按主机的设置、密钥和跳板主机——下载它,或了解它如何安全地处理密钥。

先在一台主机上试试。

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

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

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