VS Code Remote Tunnels 完全指南:免 SSH 通过安全隧道访问任意远程开发机
VS Code Remote Tunnels 完全指南:免 SSH 通过安全隧道访问任意远程开发机
本文基于 VS Code 官方文档仓库中的 Remote Tunnels 文档,系统讲解 Remote Tunnels 扩展的工作原理、两种开启隧道的方式(code CLI 与 VS Code Desktop UI)、通过 vscode.dev 或桌面客户端连接远程机器的完整流程,以及安全机制、用量限制、组织策略配置与常见运维问题的解答。读完本文,你将掌握如何在无需配置 SSH、无需修改防火墙的情况下,从任意客户端安全地连接到远程开发环境,并将 Remote Tunnels 与 Dev Containers 等远程开发能力组合使用。
Remote Tunnels 是如何工作的
VS Code 的 Remote - Tunnels 扩展让你通过一条安全隧道连接到远程机器(桌面 PC 或虚拟机),并可以从任意位置的 VS Code 客户端接入该机器,无需 SSH。隧道的底层传输由 Microsoft dev tunnels 服务承载,将数据从一个网络安全地转发到另一个网络。
这一模型带来两个关键特性:
- 源码无需拷贝到本地。扩展在远程机器上直接运行命令和其他扩展,VS Code 会在远程操作系统上安装 VS Code Server;该 Server 独立于远程机器上已有的任何 VS Code 安装。因此,无论代码托管在哪里,你都能获得本地级的开发体验——完整的 IntelliSense(补全)、代码导航和调试能力。
- 不需要网络监听器。无论托管隧道还是连接隧道,VS Code 都只向 Azure 上托管的服务发起出站连接,通常无需任何防火墙变更,VS Code 本身也不会设置任何网络监听端口。这一点对于处于 NAT 之后或防火墙受管制的远程机器尤其重要。
从架构上看,访问 VS Code Server 涉及几个组件:
| 组件 | 作用 |
|---|---|
| VS Code Server | 后端服务器,是 VS Code 各种远程体验(SSH、WSL、Dev Containers、Tunnels)的底层支撑 |
| Remote - Tunnels 扩展 | 促成本地客户端与运行着 Server 的远程机器之间建立连接的扩展 |
| dev tunnels 服务 | 微软提供的隧道中转与鉴权服务(开源实现) |
VS Code Server 本身已被开放为一个可自托管的服务,你可以阅读 VS Code Server 文档 了解其独立运行方式;而 VS Code Remote Development 则描述了容器、远程机器与 WSL 作为完整开发环境的整体图景,Remote - Tunnels 是 Remote Development 扩展包中的第四个扩展(与 Remote - SSH、Dev Containers、WSL 并列)。
快速开始:两条开启隧道的路径
官方文档给出了两条等价的路径,殊途同归,最终都提供相同的隧道功能,你可以按场景任选:
- 运行
code命令行界面(CLI) 的tunnel命令; - 通过 VS Code Desktop 的 UI 开启隧道。
如何选择:如果远程机器无法安装完整的 VS Code Desktop(例如无图形界面的服务器),CLI 是理想选择;如果你已经在 VS Code 中工作,只想为当前这台机器开启隧道访问,用 Desktop UI 更方便。
路径一:使用 code CLI
你可以通过 code CLI 创建并使用隧道。
第 1 步:在远程机器上安装 code CLI。
该 CLI 负责在 VS Code 客户端与远程机器之间建立隧道。CLI 已内置于 VS Code Desktop,无需额外安装。若远程机器没有 Desktop 环境,有两种替代方式:
- 从 VS Code 下载页的 "Alternative downloads" 获取独立的 CLI 安装包(独立于 VS Code Desktop 安装);
- 直接在远程机器的终端中下载并解压 CLI(对无 UI 的机器尤其有用):
curl -Lk 'https://code.visualstudio.com/sha/download?build=stable&os=cli-alpine-x64' --output vscode_cli.tar.gz
tar -xf vscode_cli.tar.gz
注意:如果使用独立安装包或终端安装方式,后续命令的开头将是
./code而不是code。
第 2 步:用 tunnel 命令创建安全隧道。
code tunnel
该命令会在这台机器上下载并启动 VS Code Server,然后创建通往它的隧道。
注意:首次在某台机器上启动隧道时,会被提示接受 Server 许可条款;也可以在命令行传入
--accept-server-license-terms参数跳过交互提示。
第 3 步:打开输出的 vscode.dev URL。
CLI 会输出一个绑定到该远程机器的 vscode.dev URL,形如 https://vscode.dev/tunnel/<machine_name>/<folder_name>,你可以在任意客户端中打开它。
第 4 步:完成 GitHub 账号登录。
首次在该客户端打开 vscode.dev URL 时,会被引导到 https://github.com/login/oauth/authorize... 授权页登录你的 GitHub 账号。该认证用于向隧道服务证明你对相应那组远程机器的访问权限。
CLI 常用选项补充。运行 code tunnel --help 可以查看全部隧道子命令与选项,命令手册中展示了 help 输出的示例。除本文主线外,VS Code Server 文档 还记录了若干实用参数:
code tunnel --disable-telemetry:禁用遥测。若不通过 CLI 禁用,Server 在客户端成功连接后会开始遵循客户端的遥测设置;code tunnel --telemetry-level <level>:指定初始遥测级别(例如error,仅收集错误);code tunnel --no-sleep:防止远程机器进入睡眠,见下文"保持隧道存活"。
路径二:使用 VS Code Desktop UI
-
在希望开启隧道访问的远程机器上打开 VS Code。
-
在 VS Code 的 Account 菜单中选择 Turn on Remote Tunnel Access;也可以打开命令面板(
F1)运行命令 Remote Tunnels: Turn on Remote Tunnel Access...: -
按提示登录 GitHub。登录成功后,当前机器上会启动一个隧道,你就可以从远程连接这台机器。
-
在任意客户端打开通知中给出的 vscode.dev 链接,开始编码。
注意:只要 VS Code 不在该远程机器上运行,隧道就不存在。退出 VS Code 后,机器将不再可被隧道访问,直到你再次在那台机器上启动 VS Code 或运行
code tunnelCLI 命令。这也是选择 CLI 路径的一个理由:code tunnel作为前台进程可以长期驻留(详见下文service命令)。
通过 Remote - Tunnels 扩展连接隧道
通过 code CLI 或 VS Code UI 打开的 vscode.dev 实例已预装 Remote - Tunnels 扩展。
如果你已经在 VS Code(桌面或 Web)中工作并希望连接某个远程隧道,也可以直接安装 Remote - Tunnels 扩展。安装后,打开命令面板(F1)运行 Remote Tunnels: Connect to Tunnel 命令,即可连接到任何拥有活跃隧道的远程机器。
你还可以通过 Remote Explorer 视图查看远程机器列表,使用命令 Remote Explorer: Focus on Remote View 聚焦到该视图:
与其他 Remote Development 扩展一致,已连接远程机器的名称会显示在左下角的绿色远程指示器中。点击该指示器是探索 Remote Tunnels 命令的另一种方式,其中还包含关闭远程连接、安装 VS Code Desktop 等选项。
在容器内打开远程宿主机上的文件夹
Remote - Tunnels 与 Dev Containers 扩展可以组合使用:把远程宿主机上的某个文件夹直接放进容器里打开——而且本地甚至不需要安装 Docker 客户端。操作步骤:
- 按 Dev Containers 文档 中的安装步骤,在远程宿主机上安装 Docker,并在本地安装 VS Code 与 Dev Containers 扩展;
- 按上文 快速开始 的流程为 Remote - Tunnels 建立隧道、连接并在远程机器上打开一个文件夹;
- 从命令面板(
F1)运行 Dev Containers: Reopen in Container 命令。
之后 Dev Containers 快速开始 的其余流程原样适用。若该模型不能满足需求,remote/advancedcontainers/develop-remote-host.md 介绍了通过 Remote - Tunnels 等扩展连接远程 Docker 宿主机的其他选项。
隧道安全与授权机制
官方文档对安全性的说明可以归纳为三点:
- 双端账号认证:托管隧道与连接隧道,都需要在两端使用同一个 GitHub 或 Microsoft 账号完成认证;
- 纯出站连接,端到端加密:两端都只向 Azure 上托管的服务发起出站连接,一般无需修改防火墙,VS Code 也不设置任何网络监听。从远程 VS Code 实例建立连接后,会在隧道之上创建一条 SSH 连接以提供端到端加密;当前首选加密算法为 AES 256 CTR 模式,实现该加密的代码(dev tunnels 项目)是开源的;
- 服务级限制防滥用:为避免滥用底层隧道服务,服务对隧道数量、带宽等资源设有使用限制,绝大多数用户不会触及。以隧道数量为例:当前一个账号最多可注册 10 个隧道;若已有 10 个注册隧道还想创建新隧道,CLI 会随机挑选一个未使用的隧道并将其删除。该限制可能随时调整。
组织级策略配置
如果你所在组织需要管控端口转发访问,可以通过允许或拒绝访问 global.rel.tunnels.api.visualstudio.com 这一域名来实现。对于运行 Windows 设备中的用户,还可以配置并部署 dev tunnels 的组策略(Group Policy)设置。
常见运维问题与解答
以下小节继承原文档 "Common questions" 章节的完整解答,并补充了可操作的命令细节。
Remote Tunnels、VS Code Server 与 Remote Development 是什么关系?
VS Code Remote Development 允许你使用容器、远程机器或 WSL 作为功能完整的开发环境。它让本地 VS Code 安装透明地与"别处"的源码和运行时环境交互——方法是将部分命令的执行转移到远程服务器(即 VS Code Server)上。VS Code Server 会在连接远程端点时被快速安装,并可以托管那些直接操作远程工作区、机器和文件系统的扩展。
VS Code Server 的后端组件现已发布为可自行运行的服务(详见 VS Code Server 文档),而不再仅仅由 Remote Development 扩展安装和管理。访问它的组件包括:VS Code Server(后端服务器)与 Remote - Tunnels 扩展(促成本机与运行着 Server 的远程机器连接的扩展)。
作为扩展作者,我需要做什么?
VS Code 扩展 API 对本地/远程细节做了抽象,大多数扩展无需修改即可工作。但由于扩展可以引用任意 node 模块或运行时,仍可能存在需要调整的情况。官方建议扩展作者测试自己的扩展以确认无需更新,细节见 Supporting Remote Development。
多个用户或客户端可以同时访问同一远程实例吗?
不能。一个 Server 实例的设计目标是同一时间只被一个用户或一个客户端访问。
如何删除隧道或机器?
- 停止 CLI 运行的隧道:
Ctrl + C结束当前隧道进程; - 停止通过 UI 开启的隧道:在 VS Code 中运行命令 Remote Tunnels: Turn off Remote Tunnel Access...;
- 解除机器与隧道的关联:在该机器上运行
code tunnel unregister;或者在任意 VS Code 客户端中打开 Remote Explorer 视图,右键点击目标机器并选择 unregister。
如何让隧道长期保持运行?
官方给出几个选项:
- 以服务方式运行:
code tunnel service install安装系统服务,code tunnel service uninstall卸载,适合需要 7x24 在线的远程机器; - 使用
--no-sleep选项防止远程机器休眠:code tunnel --no-sleep; - 完整的 CLI 命令与选项清单可通过
code tunnel --help查看,命令手册中的 Create remote tunnel 一节 也收录了隧道 help 输出。
隧道期间能配合其他 Remote Development 扩展或开发容器使用吗?
可以。当前可以通过 Remote - Tunnels 连接到 WSL 以及 开发容器,实现"隧道 + WSL/容器"的叠加组合。
小结与延伸阅读
Remote Tunnels 的核心价值在于:以"客户端—dev tunnels 服务—VS Code Server"的纯出站连接模型,替代传统的 SSH 可达性要求,让你从任何浏览器或桌面客户端安全地操作远程开发机。关键命令速查:
| 目的 | 命令 / 操作 |
|---|---|
| 创建隧道 | code tunnel |
| 跳过许可提示 | code tunnel --accept-server-license-terms |
| 防休眠 | code tunnel --no-sleep |
| 装为系统服务 | code tunnel service install |
| 解除机器注册 | code tunnel unregister |
| 关闭 UI 开启的隧道 | 命令面板:Remote Tunnels: Turn off Remote Tunnel Access... |
| 连接已有隧道 | 命令面板:Remote Tunnels: Connect to Tunnel |
延伸阅读(均为本仓库文档):
- VS Code Server:Server 独立运行的架构、遥测参数与许可说明;
- Remote Development 总览:Remote Development 扩展包(SSH、Dev Containers、WSL、Tunnels)的全景介绍;
- code CLI 文档:
code tunnel在命令行手册中的完整上下文; - Dev Containers 文档:与隧道组合的容器化开发流程;
- Supporting Remote Development:扩展作者适配远程环境的 API 指引。


