VSCode远程隧道是通过微软中继服务实现免配置安全连接,远端只需安装VSCode并登录微软账户,本地即可一键连接,无需SSH或公网IP。

VSCode 的远程隧道(Remote Tunnels)功能,本质是让你本地的 VSCode 客户端安全、免配置地连接到任意一台能联网的远端机器(比如家里的电脑、云服务器、甚至树莓派),无需手动搭 SSH、开防火墙、配公网 IP 或内网穿透工具。
它解决的核心问题
传统远程开发常卡在“连不上”:公司电脑没公网、家里路由器不支持端口映射、SSH 密钥配置麻烦、IT 策略禁用 SSH……远程隧道绕过了所有这些,靠微软提供的中继服务自动建立加密通道。
- 远端机器只需安装 VSCode(或仅 VS Code Server)并登录同一 Microsoft 账户
- 本地 VSCode 自动发现并列出该账户下所有已启用隧道的设备
- 点击即连,编辑、终端、调试、扩展(部分)全部可用,体验接近本地
怎么开启和使用
远端机器(被连接方)操作最简:打开 VSCode → 左下角状态栏点击“>Open Tunnel” → 登录 Microsoft 账户 → 允许授权 → 等待状态变为 “Tunnel active”。此时设备名会出现在你所有登录了同一账户的 VSCode 实例的命令面板里。
本地机器(主控方)只需:Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)→ 输入 “Remote-Tunnels: Connect to Tunnel...” → 选择目标设备 → 确认。
- 首次连接会自动安装 VS Code Server 到远端(~/.vscode-server),无需 sudo 权限
- 支持多设备同名区分(如 “MyMac (Work)” 和 “MyMac (Home)”)
- 断开后隧道默认保持活跃 24 小时(可设置为“始终在线”)
和 Remote-SSH、Codespaces 的区别
远程隧道不是替代,而是补位:
- Remote-SSH 需要你能直接 ssh 到目标机;隧道不需要,只要有网络+账户即可
- Codespaces 是微软托管的云端开发环境;隧道连接的是你自己的物理/虚拟机器
- 它不提供计算资源,只提供“安全通道 + 远程服务代理”,资源完全由你控制
注意事项和常见限制
虽然易用,但有些细节会影响体验:
- 远端机器必须运行 VSCode 桌面版(1.85+)或 VS Code CLI(
code tunnel命令) - 扩展兼容性:GUI 类扩展(如主题、图标包)正常;依赖本地 GUI 的调试器可能受限
- 文件传输走隧道,大文件操作(如 git clone、npm install)建议在远端终端执行,避免拉取延迟
- 企业环境若严格限制外联,需确认能否访问
tunnels.api.visualstudio.com
基本上就这些。它不复杂,但容易忽略——尤其适合临时救急、跨网络协作、或给非技术同事快速共享一个可编辑的开发环境。










