VSCode远程开发:使用SSH插件连接到你的服务器

1次阅读

Remote-ssh插件实现本地vscode界面远程开发,需安装插件、配置SSH主机(含密钥认证)、连接后自动部署vscode-server,支持远程执行、调试、端口转发及多窗口协作。

VSCode远程开发:使用SSH插件连接到你的服务器

VSCode 的 Remote-SSH 插件让你能像编辑本地文件一样,直接在远程服务器上开发、调试和运行代码,所有操作都在本地 VSCode 界面完成,无需手动上传下载或使用命令行编辑器。

安装与基础配置

在 VSCode 扩展市场中搜索并安装 Remote – SSH(由 microsoft 官方维护)。安装后,点击左侧活动栏的远程资源管理器图标(或按 Ctrl+Shift+P 输入 “Remote-SSH: Connect to Host…”),首次使用需配置 SSH 主机。

  • 确保你的本地机器已安装 OpenSSH 客户端(windows 10/11 可在“可选功能”中启用;macOS 和 linux 通常自带)
  • 确认远程服务器已开启 SSH 服务(默认端口 22),且你的用户有登录权限(推荐使用密钥认证,更安全)
  • 将服务器信息写入 ~/.ssh/config 文件,例如:
Host myserver     HostName 192.168.1.100     User john     IdentityFile ~/.ssh/id_rsa_server

保存后,VSCode 就能自动识别该主机名,点击连接即可。

连接与工作区选择

选择目标主机后,VSCode 会在远程服务器上自动部署一个轻量级服务端(vscode-server),整个过程通常几秒到十几秒,取决于网络和服务器性能。连接成功后,你看到的是一个全新的 VSCode 窗口,但文件浏览器、终端、调试器全部指向远程环境。

VSCode远程开发:使用SSH插件连接到你的服务器

极限网络办公Office Automation

专为中小型企业定制的网络办公软件,富有竞争力的十大特性: 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装,建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件,使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件,提供web方式的远程邮件服务。 4、集成语音会议组件,节省长途话费开支。 5、集成手机短信组件,重要信息可直接发送到员工手机。 6、集成网络硬

VSCode远程开发:使用SSH插件连接到你的服务器 0

查看详情 VSCode远程开发:使用SSH插件连接到你的服务器

  • 首次连接会提示你选择默认 shell(如 bash/zsh),建议保持默认
  • 连接后可直接用 File → Open Folder… 打开远程路径(如 /home/john/project),VSCode 会把该路径作为工作区
  • 所有扩展(如 python、ESLint、Prettier)需在远程环境中单独启用——点击右下角“Remote”状态栏,选择 Install on SSH: myserver

实用技巧与常见问题

Remote-SSH 不只是打开文件,它真正实现了本地 ui + 远程执行的无缝融合。比如你在本地写 Python 脚本,点运行按钮,实际是在服务器上执行;调试断点也实时生效。

  • 端口转发:启动本地 Web 服务(如 flask)后,在 VSCode 命令面板中运行 Remote-SSH: Forward a Port…,输入远程端口(如 5000),本地就能用 http://localhost:5000 访问
  • 多窗口协作:可以同时打开多个远程连接(不同服务器或同一服务器的不同目录),每个窗口完全独立
  • 连接失败? 检查 SSH 日志(命令面板 → Remote-SSH: Show Log),常见原因包括:服务器磁盘满、~/.vscode-server 目录权限错误、防火墙拦截、或 sshd 配置禁用了 TTY 分配(需确保 PermitTTY yes

基本上就这些。Remote-SSH 把远程开发变得和本地一样顺手,不复杂但容易忽略配置细节——尤其密钥权限(chmod 600 ~/.ssh/id_rsa_server)和 ~/.ssh/config 的格式规范。

text=ZqhQzanResources