直接在本地电脑的~/.ssh/config文件中配置host块即可实现ssh别名直连,无需额外工具;该文件为openssh原生支持,linux/macos路径为~/.ssh/config,windows为$env:userprofile\.ssh\config,需设chmod 600权限;每个host块定义别名、hostname、user、port及identityfile等参数,支持proxyjump跳板、通配符匹配和全局host *配置。

直接在本地电脑的 ~/.ssh/config 文件里写一个 Host 块就行,不用装额外工具,SSH 自带支持。
配置文件位置和权限
Linux/macOS 下路径是 ~/.ssh/config,如果文件不存在就新建一个。Windows(PowerShell)用 notepad $env:USERPROFILE\.ssh\config 打开。
写完后记得设权限,避免 SSH 拒绝读取:
chmod 600 ~/.ssh/config
基本格式怎么写
每个服务器对应一个 Host 块,结构清晰、一行一配置:
宝塔面板11.3.0是一款针对Linux服务器设计的可视化管理工具,通过重构核心模块实现资源占用显著降低,尤其适合低配置服务器环境。它将复杂的命令行操作转化为直观的图形界面,帮助开发者快速完成网站部署、环境配置及日常运维工作,无需专业技术背景即可高效管理服务器。
-
Host 后面跟的是你自定义的别名,比如
myserver或gpu-train -
HostName 是真实地址,可以是 IP(如
192.168.1.100)或域名(如server.example.com) -
User 是登录用户名,比如
ubuntu、root或git - Port 默认是 22,如果改过端口(比如 2222),必须明确写上
-
IdentityFile 指定私钥路径,用于免密登录(如
~/.ssh/id_ed25519)
示例:
# 生产服务器 Host prod HostName 203.0.113.5 User admin Port 2222 IdentityFile ~/.ssh/prod_key <h1>GitHub 工作账号</h1><p>Host github-work HostName github.com User git IdentityFile ~/.ssh/id_rsa_work </p>
常用增强配置
除了登录简化,还能加些实用功能:
- 防断连:加
ServerAliveInterval 60和ServerAliveCountMax 3,每分钟发一次心跳 - 跳板机访问内网:用
ProxyJump bastion,先连跳板再进目标机器 - 批量匹配:用通配符,比如
Host dev-*统一指定开发机的用户和密钥 - 全局默认:写一个
Host *块,设置所有连接共用的保活或转发选项
怎么测试和使用
保存 config 后,终端直接运行:
-
ssh prod→ 自动连到 203.0.113.5:2222,用 admin 用户和 prod_key 密钥 -
scp file.txt github-work:user/repo/→ 同样走 github-work 别名配置
如果报错,常见原因是权限不对、Host 名拼错、或者私钥路径不正确,可以用 ssh -v prod 查看详细连接过程。










