手上管着三五台服务器之后,纯靠记忆敲命令就开始崩溃:这台用 2222 端口,那台要用指定私钥,还有一台必须先跳板。每条命令都带四五个参数,敲错一次就重头再来。密钥怎么生成、怎么禁密码,SSH 密钥登录配置详解已经讲过;跳板机和改端口的进阶连接配置也讲过。这一篇补上中间那块:把这些参数全部写进 ~/.ssh/config,以后连接只敲一个别名。张力问题只有一个——config 怎么写,才能既省事,又不在通配符里埋下安全坑。
30 秒上手:写出第一个别名
配置文件在 ~/.ssh/config,默认不存在,自己建。权限是硬要求:组和其他人不可写,否则 ssh 会拒绝读取或报警告。
touch ~/.ssh/config
chmod 600 ~/.ssh/config
写第一个别名:
Host prod-web
HostName 203.0.113.10
User ubuntu
Port 22
保存之后,连接命令从 ssh [email protected] 变成 ssh prod-web。HostName 是真实地址,User 是登录账号,省略的参数走默认值。Host 后面那个词是别名,只在你本机生效。
验证配置有没有生效,用这条命令。它不真正建立连接,只打印某个别名最终解析出来的全部参数:
ssh -G prod-web | grep -E "^(hostname|user|port) "
排障时先跑 ssh -G,80% 的「配置不生效」问题出在匹配规则上,看一眼解析结果就清楚。
通配符默认值:给所有机器统一预设
Host 后面可以跟模式串,* 匹配所有主机。关键是匹配顺序:ssh 从上往下读,每个参数取第一次出现的值。所以具体的别名写在前面,通配符默认值放最后收尾。
Host prod-web
HostName 203.0.113.10
User ubuntu
Host bastion
HostName 203.0.113.1
User root
# 全局默认,写在文件末尾
Host *
ServerAliveInterval 60
ServerAliveCountMax 3
AddKeysToAgent yes
ServerAliveInterval 60 每 60 秒发一次心跳,防止 NAT 和防火墙掐掉空闲连接;连续 3 次无响应才断开。这三行对现有别名是补充,不会覆盖前面已经指定的 HostName 和 User——first-value-wins 保证越具体的条目越优先。
反过来,通配符也能拿来收紧默认行为。比如在末尾加一段:
Host *
IdentitiesOnly yes
这一行的含义是只用明确指定的密钥,禁止 ssh 把 agent 里所有密钥挨个试一遍。机器多、agent 里密钥杂的时候,能明显减少「密钥太多被服务器拒绝」的报错(OpenSSH 默认上限 6 次尝试)。注意副作用:指定了 IdentitiesOnly 却没写 IdentityFile 的别名会没密钥可用,建议全局开启,并在每个别名里确认已写 IdentityFile。
密钥、跳板、端口转发,全部进配置
上一篇跳板机配置里的 ProxyJump 是命令行参数,写进 config 之后就是永久生效:
Host internal-db
HostName 10.0.0.15
User deploy
IdentityFile ~/.ssh/id_ed25519_work
ProxyJump bastion
LocalForward 5432 localhost:5432
现在 ssh internal-db 一条命令做四件事:通过跳板机连接内网数据库机器、用指定的工作密钥认证、把远端 5432 端口转发到本机 5432。之后在本机 psql -h localhost 直连远端数据库,不用每次背 -J 和 -L 参数。
跳板机本身也配一个别名(上面的 bastion),ProxyJump 直接引用别名,跳板机换 IP 时只改一处配置。
IdentityFile 按机器分组指定密钥。个人用和公司用混在一台电脑上时,这一项躲不开——总不能把个人密钥也发给公司服务器试一遍。
ControlMaster 复用连接:第二条命令零等待
日常操作经常是连着敲好几条:ssh 上去、scp 拉个文件、rsync 同步目录。每次都重新握手认证。密钥设了 passphrase 的话,还要重复输入一遍。ControlMaster 让后续连接复用第一条 TCP 连接:
Host *
ControlMaster auto
ControlPath ~/.ssh/cm-%r@%h:%p
ControlPersist 10m
auto 表示没有现成连接就当主连接,有就直接复用。ControlPersist 10m 让主连接在你退出后继续保留 10 分钟。效果:第一次 ssh prod-web 正常握手,第二次起瞬间进入,scp 和 rsync 也走同一条隧道。操作完可以 ls ~/.ssh/cm-* 看看有没有残留的 socket 文件。
这套参数对 git over SSH 同样生效——仓库 remote 写成别名(git@prod-web:repo.git),push/pull 全部复用连接。
Include 拆分:一台电脑管两套机器
配置超过几十行之后,个人服务器和公司机器混在一个文件里就开始难受。Include 指令能把配置拆成多个文件:
# ~/.ssh/config 开头
Include ~/.ssh/config.d/*.conf
mkdir -p ~/.ssh/config.d
公司机器写进 config.d/work.conf,个人机器留在主文件。拆出来的文件权限同样设 600。Include 写在文件开头,意味着拆分文件里的条目优先于主文件末尾的通配符默认值。顺序规则和之前讲的一致,只是多了文件间的关系。
团队场景下还有个更细的控制:Match 按条件套配置,比如只对某个域名的机器启用特定用户:
Match host *.corp.example.com user deploy
IdentityFile ~/.ssh/id_ed25519_work
Match 能按目标主机、用户、甚至本机执行命令的结果来匹配,日常用到 host 和 user 两个条件就够了。
常用指令一张表
| 指令 | 作用 | 典型值 |
|---|---|---|
| HostName | 真实地址(IP 或域名) | 203.0.113.10 |
| User | 登录账号 | ubuntu |
| Port | 端口 | 2222 |
| IdentityFile | 指定私钥文件 | ~/.ssh/id_ed25519 |
| ProxyJump | 跳板机 | bastion |
| LocalForward | 本地端口转发 | 5432 localhost:5432 |
| ServerAliveInterval | 心跳间隔(秒) | 60 |
| ControlPersist | 连接复用保留时长 | 10m |
| IdentitiesOnly | 只用指定密钥 | yes |
常见问题
config 不生效, ssh 还是走默认参数? 先查权限:chmod 600 ~/.ssh/config,权限过松 OpenSSH 直接忽略该文件。权限没问题就跑 ssh -G 别名 看解析结果,多半是 Host 模式没匹配上或者被前面的条目抢先赋值。
scp、rsync、git 能用别名吗? 全部能用,它们底层都调 ssh 客户端,读同一份 config。scp file prod-web:/tmp/、rsync -av ./ prod-web:/var/www/ 直接写别名。
Windows 上怎么配? Windows 自带的 OpenSSH 客户端读 %USERPROFILE%\.ssh\config,语法和 Linux 一致,指令无需改动。ControlMaster 在 Windows 上不可用(依赖 Unix domain socket),其余指令照常。
别名会泄露服务器信息吗? config 只存在于你的本机,服务器端读不到这个文件。但要注意别把带真实 IP 的 config 提交到公开仓库,Include 拆分后误提交 .conf 文件是最常见的翻车方式。
ssh: Could not resolve hostname 报错怎么查? 别名拼写错了,或者该别名块写在 Include 之后、被通配符条目截胡。跑 ssh -G 别名 | grep hostname 看解析到的真实地址,和预期对不上就检查匹配顺序。
结尾
最小可行配置就三段:每个机器一个别名(HostName/User/Port)、文件末尾一段 Host * 全局心跳、需要跳板的机器加 ProxyJump。写完之后敲 ssh -G 逐个别名验证一遍解析结果,比连上去试错快得多。机器数量到 5 台以上时,再考虑 Include 拆分和 ControlMaster——配置本身 10 分钟,省下来的是之后每一次连接。