VSCode 远程连接 SSH 服务器教程

若需自定义别名、密钥登录、防超时等，手动编辑配置文件更灵活：

1. 打开命令面板（Ctrl+Shift+P），输入 Remote-SSH: Open SSH Configuration File...，选择默认的 config 文件；
2. 保存 config 文件，VSCode 会自动加载新配置。

在打开的 config 文件中，粘贴以下模板并修改参数：

# 自定义连接别名（如 server-211，方便识别）
Host server-211
HostName 服务器 IP # 服务器真实 IP
User 用户名 # 登录用户名（如 root、admin）
Port 22 # SSH 端口，默认 22，修改后同步此处
# 可选：密钥登录（替换为本地私钥路径，注释取消即可生效）
# IdentityFile C:\Users\用户名\.ssh\id_rsa # Windows 私钥路径
# IdentityFile ~/.ssh/id_rsa # macOS/Linux 私钥路径
# 可选：防止连接超时（每 60 秒发心跳包）
ServerAliveInterval 60 

五、步骤 4：连接 SSH 服务器

方式 1：密码登录（最基础）

1. 通过「Connect to...」/ 命令面板进入「SSH Target」列表，找到你配置的服务器（如 server-211 或 用户名@服务器 IP）；
2. 点击服务器名称旁的「连接」图标，或右键选择「在新窗口中连接」/「在当前窗口中连接」；
3. 首次连接时，VSCode 会弹出「选择平台」提示（根据服务器系统选择，如 Linux）；
4. 随后弹出输入框，输入服务器登录密码（输入时无字符显示，属于正常安全机制），按回车；
5. 等待 3-5 秒，若 VSCode 左下角状态栏显示「SSH: 服务器 IP / 别名」，说明连接成功！

方式 2：密钥登录（免密码，更安全）

密钥登录可避免频繁输入密码，且安全性更高，步骤如下：

1. 将公钥上传到服务器：
   • 方法 2（手动）：若 ssh-copy-id 不可用，打开本地 id_rsa.pub 文件（公钥），复制全部内容；登录服务器，将内容粘贴到 /root/.ssh/authorized_keys 文件（无该文件则新建），并执行 chmod 600 /root/.ssh/authorized_keys 确保权限。
2. VSCode 启用密钥登录：回到 config 文件，取消 IdentityFile 行的注释，填写本地私钥路径，保存后重新连接服务器，即可免密码登录。

方法 1（推荐）：终端执行以下命令（替换用户名和 IP），自动复制公钥到服务器：

ssh-copy-id 用户名@服务器 IP 

本地生成密钥对（若已有则跳过）：打开 VSCode 终端（快捷键 `Ctrl+``），执行以下命令：

ssh-keygen -t rsa -b 4096 

按回车默认保存路径（Windows：C:\Users\用户名\.ssh\id_rsa；macOS/Linux：~/.ssh/id_rsa），无需设置密钥密码（或按需设置）。

六、连接成功后的常用操作

1. 打开服务器文件夹：点击左侧「资源管理器」→「打开文件夹」，选择服务器上的目录（如 /usr/local），可可视化编辑文件；
2. 打开远程终端：快捷键 `Ctrl+``（反引号），或点击「终端」→「新建终端」，直接执行服务器命令（如 FIO 测试、文件操作）；
3. 安装服务器端插件：连接成功后安装的插件会自动部署到服务器（如 Python、Docker、语法高亮插件），无需重复配置；
4. 断开连接：点击左下角「SSH: 服务器 IP / 别名」→「关闭远程连接」，或直接关闭 VSCode 窗口。

七、常见问题与解决

问题 1：「远程资源管理器」图标始终不显示

• 原因：VSCode 插件加载缓存问题；
• 解决：无需纠结图标，直接用「欢迎页 Connect to...」或「命令面板 Ctrl+Shift+P」操作，功能完全一致；也可尝试：关闭 VSCode → 右键以管理员身份运行 → 重新安装 Remote - SSH 插件。

问题 2：「ssh: connect to host 服务器 IP port 22: Connection refused」

• 原因：服务器 SSH 服务未启动、端口错误、防火墙拦截；
• 解决：
  1. 登录服务器（物理机 / 控制面板）执行 systemctl status sshd 检查 SSH 服务，未启动则执行 systemctl start sshd；
  2. 确认服务器 SSH 端口（修改后同步到 config 文件的 Port 参数）；
  3. 服务器防火墙放行端口：ufw allow 22（Ubuntu/Debian）或 firewall-cmd --add-port=22/tcp --permanent（CentOS）。

问题 3：「Permission denied (publickey,password)」

• 原因：用户名 / 密码错误、服务器禁止密码登录、密钥权限错误；
• 解决：
  1. 核对用户名和密码，确保无误；
  2. 若服务器禁用密码登录，必须配置密钥登录（参考步骤 4 方式 2）；
  3. 本地私钥文件权限需为 600（Windows 右键属性设置，Linux/macOS 执行 chmod 600 ~/.ssh/id_rsa）。

问题 4：连接超时

• 原因：网络延迟高，服务器未配置心跳包；
• 解决：在 config 文件中添加 ServerAliveInterval 60，保存后重新连接。

八、总结

VSCode 连接 SSH 服务器的核心是「安装 Remote - SSH 插件 + 配置连接信息 + 验证登录」，无需纠结「远程资源管理器」图标，通过「欢迎页 Connect to...」或「命令面板」即可完成所有操作。相比纯命令行，VSCode 支持可视化编辑、插件扩展、断点调试等功能，能大幅提升远程开发 / 运维效率。

若使用旧版操作系统，需先安装 OpenSSH 客户端（或 PuTTY），核心配置逻辑与上述一致，仅需适配本地 SSH 环境即可。