~/.ssh/config 别名实战:多主机管理的省力写法

~/.ssh/config 别名实战:多主机管理的省力写法

SSHOpenSSH命令行效率服务器运维Linux
📶 入门 🧩 OpenSSH

手上管着三五台服务器之后,纯靠记忆敲命令就开始崩溃:这台用 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 分钟,省下来的是之后每一次连接。