VSCode 远程连接 SSH 服务器配置指南
在日常开发 / 运维工作中,VSCode 凭借强大的插件生态和可视化编辑能力,成为远程操作服务器的首选工具。本文将手把手教你通过 VSCode 连接 SSH 服务器,涵盖插件安装、多方式配置连接、密码 / 密钥登录、图标缺失兜底方案全流程,新手也能轻松上手!
一、前置条件
在开始前,请确认满足以下条件:
| 环境 / 设备 | 要求说明 |
|---|---|
| 本地机器 | 安装最新版 VSCode(下载地址),支持 Windows/macOS/Linux 系统 |
VSCode 远程连接 SSH 服务器需安装 Remote - SSH 插件,支持密码和密钥登录。配置涉及添加 SSH Host 或编辑 config 文件设置别名与端口。常见问题如图标缺失可通过命令面板解决,连接失败需检查服务状态及防火墙。连接后可在资源管理器中操作文件并使用远程终端提升效率。
在日常开发 / 运维工作中,VSCode 凭借强大的插件生态和可视化编辑能力,成为远程操作服务器的首选工具。本文将手把手教你通过 VSCode 连接 SSH 服务器,涵盖插件安装、多方式配置连接、密码 / 密钥登录、图标缺失兜底方案全流程,新手也能轻松上手!
在开始前,请确认满足以下条件:
| 环境 / 设备 | 要求说明 |
|---|---|
| 本地机器 | 安装最新版 VSCode(下载地址),支持 Windows/macOS/Linux 系统 |
| 远程服务器 | 1. 开启 SSH 服务(默认端口 22,若修改需记录新端口);2. 服务器 IP 可正常访问(示例用 <服务器 IP>,替换为你的真实 IP);3. 拥有服务器登录用户名 + 密码 / 私钥 |
| 网络 | 本地与服务器网络互通(可 ping 通服务器 IP,或确认 22 端口开放) |
VSCode 本身不自带 SSH 连接功能,需安装官方核心插件:
Ctrl+Shift+X/Cmd+Shift+X);Remote - SSH,找到微软官方发布的「Remote - SSH」插件(作者:Microsoft,标识为「远程服务器 + SSH」样式);注意:需确保安装的是微软官方版本,避免第三方仿冒插件导致功能异常。
很多用户安装插件后找不到「远程资源管理器」图标,以下提供 3 种兜底入口,任选其一即可:
若 VSCode 打开后显示欢迎页(如截图所示),直接点击「Start」区域下的 「Connect to...」(位于「Clone Git Repository...」下方),即可进入 SSH 连接配置流程。
无论是否显示图标,按快捷键 Ctrl+Shift+P(macOS 为 Cmd+Shift+P)打开命令面板,输入 Remote-SSH: Connect to Host...,回车后直接进入连接配置。
若安装插件并重启后,左侧边栏出现「远程资源管理器」图标(样式为「><」左右箭头),点击该图标即可打开 SSH 目标面板;若未显示,无需纠结,直接用入口 1/2 即可。
ssh root@<服务器 IP>ssh root@<服务器 IP> -p 2222config 文件(Windows 路径:C:\Users\你的用户名\.ssh\config;macOS/Linux 路径:~/.ssh/config),点击保存。弹出输入框,输入 SSH 连接基础命令,格式如下:
ssh 用户名@<服务器 IP> -p <端口号>
若需自定义别名、密钥登录、防超时等,手动编辑配置文件更灵活:
Ctrl+Shift+P),输入 Remote-SSH: Open SSH Configuration File...,选择默认的 config 文件;config 文件,VSCode 会自动加载新配置。在打开的 config 文件中,粘贴以下模板并修改参数:
# 自定义连接别名(如 server-211,方便识别)
Host server-211
HostName <服务器 IP> # 服务器真实 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
server-211 或 root@<服务器 IP>);密钥登录可避免频繁输入密码,且安全性更高,步骤如下:
ssh-copy-id 不可用,打开本地 id_rsa.pub 文件(公钥),复制全部内容;登录服务器,将内容粘贴到 /root/.ssh/authorized_keys 文件(无该文件则新建),并执行 chmod 600 /root/.ssh/authorized_keys 确保权限。config 文件,取消 IdentityFile 行的注释,填写本地私钥路径,保存后重新连接服务器,即可免密码登录。方法 1(推荐):终端执行以下命令(替换用户名和 IP),自动复制公钥到服务器:
ssh-copy-id root@<服务器 IP>
本地生成密钥对(若已有则跳过):打开 VSCode 终端(快捷键 Ctrl+),执行以下命令:
ssh-keygen -t rsa -b 4096
按回车默认保存路径(Windows:C:\Users\你的用户名\.ssh\id_rsa;macOS/Linux:~/.ssh/id_rsa),无需设置密钥密码(或按需设置)。
/usr/local),可可视化编辑文件;Ctrl+(反引号),或点击「终端」→「新建终端」,直接执行服务器命令(如 FIO 测试、文件操作);systemctl status sshd 检查 SSH 服务,未启动则执行 systemctl start sshd;ufw allow 22(Ubuntu/Debian)或 firewall-cmd --add-port=22/tcp --permanent(CentOS)。chmod 600 ~/.ssh/id_rsa)。ServerAliveInterval 60,保存后重新连接。VSCode 连接 SSH 服务器的核心是「安装 Remote - SSH 插件 + 配置连接信息 + 验证登录」,无需纠结「远程资源管理器」图标,通过「欢迎页 Connect to...」或「命令面板」即可完成所有操作。相比纯命令行,VSCode 支持可视化编辑、插件扩展、断点调试等功能,能大幅提升远程开发 / 运维效率。
若你是 Windows 7 等老系统,需先安装 OpenSSH 客户端(或 PuTTY),核心配置逻辑与上述一致,仅需适配本地 SSH 环境即可。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online