如何利用 VSCode 的 SSH 配置文件连接和管理多台远程服务器？-VSCode-PHP中文网

<p>首先，确保安装 VSCode 的 Remote - SSH 扩展；其次，配置本地 ~/.ssh/config 文件，通过定义别名、主机信息、私钥路径等参数简化连接流程。该方法不仅提升开发效率，还支持连接复用（ControlMaster）、跳板机访问（ProxyJump）和保持连接活跃（ServerAliveInterval），并适用于所有 SSH 客户端，实现跨工具一致性。</p>

如何利用 vscode 的 ssh 配置文件连接和管理多台远程服务器？

VSCode 结合其 Remote - SSH 扩展，通过配置本地的

~/.ssh/config

登录后复制

文件，能够高效、安全地管理和连接多台远程服务器，极大地简化了远程开发的工作流程。这不仅提升了开发效率，也让复杂的远程环境变得触手可及。

要实现这一点，核心在于两步：首先，确保你已经安装了 VSCode 的 Remote - SSH 扩展；其次，也是最关键的，是精心配置你的本地 SSH 配置文件，通常位于

~/.ssh/config

登录后复制

。

坦白说，刚开始接触远程开发时，每次手动输入

ssh user@host -p port

登录后复制

这种命令，不仅繁琐，还容易出错。但自从我深入了解并实践了 SSH 配置文件后，整个远程工作流简直是焕然一新。

配置文件的工作原理其实很简单：你为每个远程服务器定义一个别名（Host），然后在这个别名下指定所有连接所需的参数，比如主机名、用户名、端口、私钥路径等等。当你在 VSCode 中选择连接一个远程主机时，它会读取这个配置文件，并自动使用你定义好的参数去建立连接。

以下是一个基础的

~/.ssh/config

登录后复制

示例：

# 我的第一个开发服务器
Host dev-server-01
  HostName 192.168.1.100
  User myuser
  Port 22
  IdentityFile ~/.ssh/id_rsa_dev_01
  # 保持连接活跃，避免长时间不操作断开
  ServerAliveInterval 60
  ServerAliveCountMax 3

# 我的第二个测试服务器
Host test-server-02
  HostName test.example.com
  User anotheruser
  Port 2222
  IdentityFile ~/.ssh/id_rsa_test_02
  # 启用连接复用，加快后续连接速度
  ControlMaster auto
  ControlPath ~/.ssh/cm_socket/%r@%h:%p
  ControlPersist 600

# 通过跳板机连接的生产服务器
Host prod-server-03
  HostName 10.0.0.50
  User produser
  Port 22
  IdentityFile ~/.ssh/id_rsa_prod_03
  # 通过 dev-server-01 作为跳板机
  ProxyJump dev-server-01

登录后复制

配置好这个文件后，你只需要打开 VSCode，点击左下角的远程连接图标，选择“Connect to Host...”，然后你就会看到

dev-server-01

登录后复制

、

test-server-02

登录后复制

、

prod-server-03

登录后复制

这些别名出现在列表中。点击即可连接，所有复杂的参数都由 SSH 配置文件代劳了。

SSH 配置文件有哪些核心优势，能让远程开发更高效？

在我看来，SSH 配置文件带来的效率提升是多方面的，绝不仅仅是少敲几行命令那么简单。

首先，它极大地简化了连接流程。试想一下，如果你有十台服务器，每台的 IP、端口、用户名、私钥都不一样，每次连接都要翻找笔记或者记忆，那效率可想而知。但有了配置文件，你只需要记住一个短小精悍的别名，比如

dev-server

登录后复制

，然后 VSCode 就能帮你搞定一切。这是一种心智负担的解放。

其次，提升了安全性与规范性。私钥路径集中管理，避免了将私钥散落在各个项目文件夹的风险。而且，当团队协作时，一份规范的

config

登录后复制

文件可以确保所有成员都以正确且一致的方式连接到服务器，减少因配置不当引发的问题。

再者，提供了更高级的连接优化选项。比如

ControlMaster

登录后复制

和

ControlPersist

登录后复制

参数，允许你复用已有的 SSH 连接。这意味着当你第一次连接到服务器后，后续的连接（比如在同一个 VSCode 窗口中打开多个终端，或者在另一个 VSCode 窗口连接同一台服务器）会瞬间完成，几乎没有延迟，这对于频繁进行远程操作的开发者来说，简直是神来之笔。还有

ProxyJump

登录后复制

，完美解决了跳板机（堡垒机）的连接需求，让多级跳转变得透明且简单。

最后，通用性强。

~/.ssh/config

登录后复制

是 SSH 协议的标准配置方式，这意味着你不仅能在 VSCode 中利用它，在任何其他支持 SSH 协议的客户端（比如你的终端、Git Bash 等）中，这些配置都是通用的。这种跨工具的一致性，让你的远程工作流更加顺畅。

在

~/.ssh/config

登录后复制

中，有哪些关键参数可以优化我的远程连接体验？

除了前面提到的

Host

登录后复制

、

HostName

登录后复制

、

User

登录后复制

、

Port

登录后复制

和

IdentityFile

登录后复制

这些基础参数，还有一些高级参数，它们能显著提升你的远程连接体验，我个人觉得这些都是值得深入了解和使用的：

```
ProxyJump
```
登录后复制
(或
ProxyCommand
登录后复制
): 这个参数是为跳板机场景设计的。如果你需要通过一台中间服务器才能连接到目标服务器，
```
ProxyJump
```
登录后复制
就能派上用场。
```
Host target-server
  HostName 10.0.0.10
  User remoteuser
  ProxyJump jump-server # jump-server 必须在 config 中有定义
```
登录后复制
它让多级 SSH 连接变得像直接连接一样简单。
```
ControlMaster auto
```
登录后复制
/
ControlPath
登录后复制
/
ControlPersist
登录后复制
: 这组参数用于实现 SSH 连接复用。

Hour One
AI文字到视频生成

37

查看详情
- ```
ControlMaster auto
```
  登录后复制
  ：告诉 SSH 客户端，如果可能，尝试复用已有的连接。
- ```
ControlPath
```
  登录后复制
  ：指定用于连接复用的 socket 文件路径。通常我会放在
```
~/.ssh/cm_socket/%r@%h:%p
```
  登录后复制
  这种模式下，确保每个连接有独立的 socket。
- ```
ControlPersist
```
  登录后复制
  ：定义 socket 文件保持活跃的时间。比如
```
600
```
  登录后复制
  表示 600 秒（10 分钟），即使所有客户端都断开，socket 也会保持这么长时间，等待新的连接复用。
```
Host my-fast-server
HostName 192.168.1.50
User dev
ControlMaster auto
ControlPath ~/.ssh/cm_socket/%r@%h:%p
ControlPersist 600
```
  登录后复制
  这组参数对于需要频繁打开新终端或重新连接的场景，简直是质的飞跃。
```
ServerAliveInterval
```
登录后复制
/
ServerAliveCountMax
登录后复制
: 这两个参数用来防止 SSH 连接因为长时间不活动而被服务器或中间网络设备断开。
- ```
ServerAliveInterval 60
```
  登录后复制
  ：每隔 60 秒向服务器发送一个空包，保持连接活跃。
- ```
ServerAliveCountMax 3
```
  登录后复制
  ：如果连续 3 次发送空包没有收到响应，则认为连接已断开。
```
Host keep-alive-server
HostName 172.16.0.20
User admin
ServerAliveInterval 60
ServerAliveCountMax 3
```
  登录后复制
  这在网络环境不稳定或者服务器有空闲断开策略时特别有用。
```
LocalForward
```
登录后复制
/
RemoteForward
登录后复制
: 用于端口转发。
- ```
LocalForward local_port remote_host:remote_port
```
  登录后复制
  ：将本地端口转发到远程服务器上的某个端口。
- ```
RemoteForward remote_port local_host:local_port
```
  登录后复制
  ：将远程服务器上的端口转发到本地。这在需要访问远程内网服务或者调试特定端口时非常方便。