超详细！VSCode 远程连接 SSH 服务器教程（2025 最新版）

超详细！VSCode 远程连接 SSH 服务器教程（2025 最新版）

在日常开发 / 运维工作中，VSCode 凭借强大的插件生态和可视化编辑能力，成为远程操作服务器的首选工具。本文将手把手教你通过 VSCode 连接 SSH 服务器，涵盖插件安装、多方式配置连接、密码 / 密钥登录、图标缺失兜底方案全流程，新手也能轻松上手！

一、前置条件

在开始前，请确认满足以下条件：

二、步骤 1：安装 Remote - SSH 插件

VSCode 本身不自带 SSH 连接功能，需安装官方核心插件：

1. 打开 VSCode，点击左侧边栏的「扩展」图标（快捷键 Ctrl+Shift+X/Cmd+Shift+X）；
2. 在扩展搜索框中输入 Remote - SSH，找到微软官方发布的「Remote - SSH」插件（作者：Microsoft，标识为「远程服务器 + SSH」样式）；
3. 点击「安装」按钮，安装完成后无需重启（若后续图标不显示再重启）。

注意：需确保安装的是微软官方版本，避免第三方仿冒插件导致功能异常。

三、步骤 2：SSH 连接入口（解决「远程资源管理器」图标缺失问题）

很多用户安装插件后找不到「远程资源管理器」图标，以下提供 3 种兜底入口，任选其一即可：

入口 1：欢迎页「Connect to...」（最直接，推荐）

若 VSCode 打开后显示欢迎页（如截图所示），直接点击「Start」区域下的 「Connect to...」（位于「Clone Git Repository...」下方），即可进入 SSH 连接配置流程。

入口 2：命令面板（万能兜底）

无论是否显示图标，按快捷键 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）打开命令面板，输入 Remote-SSH: Connect to Host...，回车后直接进入连接配置。

入口 3：远程资源管理器图标（若显示）

若安装插件并重启后，左侧边栏出现「远程资源管理器」图标（样式为「><」左右箭头），点击该图标即可打开 SSH 目标面板；若未显示，无需纠结，直接用入口 1/2 即可。

四、步骤 3：配置 SSH 连接信息

方式 1：可视化配置（新手推荐）

1. 通过上述任意入口进入「SSH 连接配置」后，选择「Add New SSH Host...」；
   • 示例（默认 22 端口）：ssh [email protected]
   • 示例（自定义端口，如 2222）：ssh [email protected] -p 2222
2. 按回车后，VSCode 会提示「选择要保存配置的文件」，选择默认的 config 文件（Windows 路径：C:\Users\你的用户名\.ssh\config；macOS/Linux 路径：~/.ssh/config），点击保存。

弹出输入框，输入 SSH 连接基础命令，格式如下：bash运行

ssh 用户名@服务器IP -p 端口号 

方式 2：手动编辑 SSH Config 文件（进阶，支持更多配置）

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

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

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

# 自定义连接别名（如 server-211，方便识别） Host server-211 HostName 211.71.149.62 # 服务器真实 IP User root # 登录用户名（如 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 或 [email protected]）；
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），自动复制公钥到服务器：bash运行

ssh-copy-id [email protected] 

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

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 211.71.149.62 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 支持可视化编辑、插件扩展、断点调试等功能，能大幅提升远程开发 / 运维效率。

若你是 Windows 7 等老系统，需先安装 OpenSSH 客户端（或 PuTTY），核心配置逻辑与上述一致，仅需适配本地 SSH 环境即可。