科技日报

Appearance

每次连接远程服务器，都要输入一长串命令：

ssh -i ~/.ssh/blog_deploy_key root@182.92.95.136

能不能简化成一个词？答案是：可以，而且非常简单。

配置完成后，只需要一行：

ssh vps

本文将带你从零理解 SSH 别名的工作原理，并动手配置你自己的别名。

SSH 客户端的工作流程 ​

当你在终端里输入ssh vps时，实际发生了以下过程：

输入：ssh vps
  ↓
SSH 客户端按顺序查找配置文件
  1. 系统级：/etc/ssh/ssh_config（所有用户共享）
  2. 用户级：~/.ssh/config（当前用户，优先级更高）
  ↓
找到匹配 Host vps 的区块
  ↓
将区块中的参数合并为 SSH 连接参数
  ↓
实际执行的命令等价于：
  ssh root@182.92.95.136 -i ~/.ssh/blog_deploy_key

SSH 客户端内置了一个”配置文件解释器”。它按固定格式读取配置文件，把文件中的参数翻译成命令行参数。你不需要记住任何复杂的参数组合。

SSH Config 文件格式 ​

SSH Config 使用区块匹配格式，结构非常直观：

Host <别名>              ← 区块头，SSH 会拿你的输入来匹配它
    参数名 参数值         ← 缩进任意（习惯用 4 空格），每行一个参数
    参数名 参数值

多个区块互不干扰，按从上到下的顺序匹配：

Host vps                 ← 输入 ssh vps 时匹配此区块
    HostName 182.92.95.136
    User root
    IdentityFile ~/.ssh/blog_deploy_key

Host github.com          ← 输入 ssh github.com 时匹配此区块
    User git
    IdentityFile ~/.ssh/id_ed25519

Host *                   ← 通配符，匹配所有未匹配的主机
    ServerAliveInterval 60

匹配规则：SSH 客户端从上到下扫描，第一个匹配Host值的区块生效。参数是累加的，后面的区块可以覆盖前面的值。

参数详解 ​

以一个完整的配置为例，逐行解释每个参数的作用：

Host vps
    HostName 182.92.95.136
    User root
    IdentityFile ~/.ssh/blog_deploy_key
    BatchMode yes
    IdentitiesOnly yes
    ServerAliveInterval 60
    ServerAliveCountMax 3

配置完成后，ssh vps完全等价于：

ssh root@182.92.95.136 \
  -i ~/.ssh/blog_deploy_key \
  -o BatchMode=yes \
  -o IdentitiesOnly=yes \
  -o ServerAliveInterval=60 \
  -o ServerAliveCountMax=3

本质就是：把命令行参数提前写进配置文件，用别名触发。

动手配置 ​

第一步：打开配置文件 ​

打开 Git Bash，编辑（或创建）SSH 配置文件：

# 方法一：用记事本打开（Windows）
notepad ~/.ssh/config

# 方法二：用 vim 编辑
vim ~/.ssh/config

# 方法三：用 VS Code 编辑（需已安装）
code ~/.ssh/config

Windows 用户注意：~代表C:\Users\你的用户名\，所以完整路径是C:\Users\你的用户名.ssh\config。

第二步：添加配置区块 ​

在文件中追加以下内容（修改为你的实际值）：

Host myserver
    HostName 你的服务器IP
    User 你的用户名
    IdentityFile ~/.ssh/你的密钥文件名
    ServerAliveInterval 60
    ServerAliveCountMax 3

保存关闭。

第三步：测试连接 ​

ssh myserver

首次连接会提示确认服务器指纹：

The authenticity of host '182.92.95.136' can't be established.
ED25519 key fingerprint is SHA256:xxxxxxxxxxx.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

输入yes回车即可。指纹会被保存到~/.ssh/known_hosts，下次不再提示。

第四步：调试（如果连不上） ​

加上-v参数查看详细日志：

ssh -v myserver

-v输出会告诉你：

  • 读取了哪个配置文件
  • 匹配了哪个 Host 区块
  • 尝试了哪个密钥
  • 在哪一步失败了

进阶技巧 ​

1. 通配符匹配 ​

Host支持*和?通配符：

# 所有局域网服务器用同一个密钥
Host 192.168.1.*
    User admin
    IdentityFile ~/.ssh/lan_key

# 所有生产服务器
Host prod-*
    User deploy
    StrictHostKeyChecking no

2. 参数继承与覆盖 ​

全局默认 + 特定覆盖：

# 全局默认配置（放在文件顶部）
Host *
    User root
    ServerAliveInterval 60
    ServerAliveCountMax 3

# 特定服务器覆盖默认值
Host vps
    HostName 182.92.95.136
    User ubuntu          ← 覆盖了全局的 root
    IdentityFile ~/.ssh/blog_deploy_key

3. 端口映射（本地转发） ​

在本地访问远程服务，就像访问本地一样：

Host dbserver
    HostName 10.0.0.100
    User admin
    LocalForward 3306 localhost:3306
    LocalForward 6379 localhost:6379

配置后，执行ssh dbserver连接后：

  • 访问本地localhost:3306→ 等价于访问 VPS 的 MySQL
  • 访问本地localhost:6379→ 等价于访问 VPS 的 Redis

4. 代理跳板（Jump Host） ​

通过一台跳板机连接内网服务器：

# 跳板机（公网可访问）
Host bastion
    HostName 1.2.3.4
    User jump
    IdentityFile ~/.ssh/bastion_key

# 内网服务器（只能通过跳板机访问）
Host internal
    HostName 10.0.0.50
    User admin
    ProxyJump bastion    ← 关键配置
    IdentityFile ~/.ssh/internal_key

执行ssh internal时，SSH 会自动：

整个过程对你是透明的，一条命令搞定。

5. 为 SCP 和 SFTP 自动生效 ​

SSH Config 不仅对ssh命令生效，scp和sftp同样遵循：

# 上传文件
scp ~/本地文件.txt myserver:/远程目录/

# 下载文件
scp myserver:/远程文件.txt ~/本地目录/

# SFTP 交互式传输
sftp myserver

不需要额外配置，别名自动复用。

故障排查速查 ​

总结 ​

SSH 别名不是什么高深的技术，它只是 SSH 客户端的一个内置功能：

  • 原理：SSH 客户端读取~/.ssh/config文件，将配置参数翻译为命令行参数
  • 格式：Host <别名>+ 缩进参数，简单直观
  • 效果：把一长串命令缩短成一个词
  • 覆盖范围：ssh、scp、sftp、VS Code Remote 全部自动生效

花五分钟配一次，以后每次连接节省十秒钟。日积月累，这就是开发效率的差距。

参考资料：OpenSSH ssh_config 官方文档

Powered by Horizon & VitePress