VSCode 配置 SSH 远程连接与免密登录 (Win 连接 Linux)

在日常开发中,我们经常需要在 Windows 本地写代码,然后扔到 Linux 服务器上去跑。使用 VSCode 的 Remote-SSH 插件可以完美实现这一需求。

1. 准备工作

  1. 确保你的 Windows 本地安装了 Visual Studio Code
  2. 确保你的 Linux 服务器开启了 SSH 服务(通常默认开启,端口为 22)。

2. 安装 VSCode 插件

在 VSCode 的插件市场(左侧边栏的扩展图标)中搜索并安装:

  • Remote - SSH (由 Microsoft 提供)

3. 初次密码连接测试

安装完插件后,按下 F1Ctrl+Shift+P 打开命令面板,输入 Remote-SSH: Connect to Host...,然后选择 Add New SSH Host...

输入你的服务器连接命令,例如:

1
ssh root@192.168.1.100

(将 root 换成你的用户名,192.168.1.100 换成你的服务器 IP)

根据提示选择更新你的 C:\Users\你的用户名\.ssh\config 文件。然后再次点击连接,输入服务器密码。如果能成功打开远程服务器的文件目录,说明基础连接已经通了!

4. 配置 SSH 免密登录

每次都要输入密码非常繁琐,我们可以通过 SSH 密钥对实现免密登录。

第一步:在 Windows 本地生成密钥对

打开 Windows 的 PowerShell 或 CMD 终端,输入:

1
ssh-keygen -t rsa -b 4096

一路回车(不要设置密码)。这会在 C:\Users\你的用户名\.ssh\ 目录下生成两个文件:

  • id_rsa (私钥,千万不能泄露)
  • id_rsa.pub (公钥,要放到服务器上)

第二步:将公钥复制到 Linux 服务器

在 PowerShell 中执行以下命令(注意替换用户名和 IP):

1
Get-Content ~/.ssh/id_rsa.pub | ssh root@192.168.1.100 "cat >> ~/.ssh/authorized_keys"

(系统会最后一次要求你输入服务器密码)

第三步:修改 VSCode 配置文件

回到 VSCode,打开刚才的 SSH 配置文件 C:\Users\你的用户名\.ssh\config,确保它看起来像这样:

1
2
3
4
Host MyLinuxServer
HostName 192.168.1.100
User root
IdentityFile C:\Users\你的用户名\.ssh\id_rsa

5. 验证免密连接

重新启动 VSCode,点击左下角的绿色的 >< 远程连接图标,选择 Connect to Host... -> MyLinuxServer
如果你不需要输入任何密码就直接连上了服务器,并且终端提示符变成了 Linux 的样式,恭喜你,免密连接配置成功!


分享
VSCode 配置 SSH 远程连接与免密登录 (Win 连接 Linux)
https://asteriayx.github.io/2026/06/13/vscode-ssh-remote/
作者
Asteriayx
发布于
2026年6月13日
许可协议