VSCode远程开发：使用SSH插件连接到你的服务器-VSCode-PHP中文网

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

P粉986688829

发布： 2025-12-14 18:08:56

原创

340人浏览过

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 窗口，但文件浏览器、终端、调试器全部指向远程环境。

极限网络办公Office Automation

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

查看详情

首次连接会提示你选择默认 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）