Cursor/Vscode通过SSH免密远程连接服务器

第一步：安装 SSH 插件
💻 适用于 VS Code 或 Cursor 编辑器
打开 VS Code 或 Cursor

点击左侧边栏的插件图标（四个方块图标 “Extensions”）

在搜索框中输入：Remote – SSH

找到插件，全名为：Remote – SSH（by Microsoft）

点击 安装 按钮

安装成功后，左下角会出现一个绿色连接图标（><）或 SSH 字样按钮。

第二步：添加 SSH 主机（使用密码连接）
打开命令面板：

快捷键：Ctrl + Shift + P（Windows / Linux）或 Cmd + Shift + P（macOS）

输入并选择：Remote-SSH: Connect to Host…

系统提示：”No SSH hosts are configured.” (还没有添加过任何主机)

选择：Add New SSH Host…

输入你的 SSH 连接命令(根据你自己的信息替换）： ​​​

ssh root(服务器用户名)@192.168.1.100(服务器IP地址)

系统会问你：Add this host to which SSH config file? 默认选择即可，例如：

Windows: C:\Users\你的用户名\.ssh\config

macOS/Linux: ~/.ssh/config

添加完毕后，在Cursor中使用Ctrl + Shift + P再次打开命令面板 →

选择：Remote-SSH: Connect to Host…

或者点击左下角绿色按钮，选择你刚刚添加的主机名进行连接。

第三步：首次连接服务器（使用密码登录）
首次连接时，会提示你：Are you sure you want to continue connecting (yes/no)?

输入 yes

然后会提示输入密码，输入你的服务器密码，即可连接成功。

成功后 Cursor 左下角状态栏会变为绿色，显示 [SSH: root@192.168.1.100]，终端窗口会默认打开远程终端。

📌 此时你已经连接到远程服务器，终端和资源管理器都运行在服务器上。

第四步：生成并上传 SSH 公钥，实现免密登录
在本地生成 SSH 密钥对
打开 VS Code / Cursor 本地终端：

输入命令生成密钥对：ssh-keygen -t rsa -b 4096

终端提示如下内容时，全部按回车即可：

Enter file in which to save the key (/home/你的用户名/.ssh/id_rsa): [回车]
Enter passphrase (empty for no passphrase): [回车]
Enter same passphrase again: [回车]

生成成功后将得到以下两个文件：

私钥：~/.ssh/id_rsa（保密，不能上传）

公钥：~/.ssh/id_rsa.pub （用于上传到服务器）

文件位置（Windows 是：C:\Users\你的用户名\.ssh\id_rsa）

上传公钥到服务器
方法一：自动上传（Linux）

ssh-copy-id root@192.168.1.100

方法二：手动上传 (Windows、Linux)

（Linux命令）查看公钥内容：cat ~/.ssh/id_rsa.pub

（Windows命令）

使用 PowerShell 查看内容 Get-Content $env:USERPROFILE\.ssh\id_rsa.pub

或者 打开文件资源管理器 路径栏输入:C:\Users\你的用户名\.ssh\
右键 id_rsa.pub → “使用记事本打开” 全选复制内容

全选复制内容

在 Cursor/VS Code 的远程终端中执行：mkdir -p ~/.ssh
vim/nano ~/.ssh/authorized_keys（vim/nano两编辑方式）
Vim 插入：i 保存并退出：:wq 不保存退出：:q!
Nano 插入：直接输入 保存：Ctrl + O，然后回车 退出：Ctrl + X

粘贴公钥内容，保存退出：

📌 **注意：设置权限(远程服务器中执行)： chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

第五步：测试免密登录是否成功
Ctrl + Shift + P打开命令面板 选择Remote-SSH: Close Remote Connection断开当前连接

再次打开命令面板：选择Remote-SSH: Connect to Host…
点击之前添加的主机 root@192.168.1.100（不再要求输入密码）

成功后状态栏显示 [SSH: root@192.168.1.100]

第六步（可选）：手动编辑 .ssh/config 文件
🎁 加分技巧（建议配置）

在Cursor中Ctrl + Shift + P打开面板选择Remote-SSH: Connect to Host…

选择Configure SSH Hosts..

Host myserver
HostName 192.168.1.100
User root
Port 22
IdentityFile ~/.ssh/id_rsa

eg:

# Linux/macOS:
IdentityFile ~/.ssh/id_rsa(私钥)

# Windows:
IdentityFile C:/Users/你的用户名/.ssh/id_rsa(私钥)

以后你在 VS Code / Cursor 里只需要选 myserver，即可一键连接。