需启用 VS Code Remote Tunnels 服务：1. 安装 1.85+ 版本；2. 命令面板开启 Remote-Tunnels；3. GitHub 登录授权；4. 获取 https://.vscode.dev 链接；5. 管理 GitHub 用户访问权限；6. 其他设备通过链接或 VS Code 客户端连接。
如果您希望在外部网络环境下安全地连接到本地开发机并进行远程开发，则可能是由于本地开发机未暴露在公网或 防火墙 策略限制了直接访问。以下是实现此目标的步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、启用 Remote Tunnels 服务
Remote Tunnels 依赖于 GitHub 账户认证和 VS Code 官方中继服务，启用后会为本地机器生成唯一隧道 URL，并通过加密通道代理流量。
1、确保已安装 VS Code 1.85 或更高版本。
2、打开 VS Code，按下 Cmd + Shift + P（Mac）调出命令面板。
3、输入并选择 Remote-Tunnels: Turn on Remote Tunnel。
4、按提示登录 GitHub 账户，授权 VS Code Remote Tunnels 应用。
5、等待隧道建立完成，状态栏右下角将显示 Tunnel Active 及一个以 https://
二、配置身份验证与访问权限
Remote Tunnels 默认启用基于 GitHub 身份的细粒度访问控制，仅允许已授权的 GitHub 用户通过 浏览器 或 VS Code 桌面客户端连接。
1、在命令面板中执行 Remote-Tunnels: Manage Access。
2、选择 Add GitHub User 并输入对方 GitHub 用户名。
3、确认该用户已启用两步验证（2FA），否则无法获得连接权限。
4、可选：执行 Remote-Tunnels: Revoke All Access 清除全部已有授权。
三、从其他设备连接隧道
连接端无需安装额外服务，只需支持现代浏览器或 VS Code 桌面客户端，且能访问 GitHub 认证页面。
1、在另一台设备上打开浏览器，访问上一步获取的 https://
2、点击 Open in Visual Studio Code 按钮，自动跳转至本地安装的 VS Code 客户端（若已安装）。
3、若使用未安装 VS Code 的设备，点击 Continue in browser，进入 Web 版 VS Code 界面。
4、首次连接时需再次完成 GitHub 登录，系统将校验是否已在主机端授权该账户。
四、禁用自动隧道与离线保活设置
Remote Tunnels 默认在 VS Code 关闭后终止隧道；如需延长活跃时间或避免意外断连，可调整后台行为策略。
1、打开 VS Code 设置（Cmd + ,），搜索 remote.tunnels.autostart。
2、勾选该项，使隧道在 VS Code 启动时自动激活。
3、搜索 remote.tunnels.keepAlive，将其值设为 true。
4、在终端中运行 code –tunnel 可手动启动无 GUI 的隧道进程，适用于 headless 场景。
五、排查常见连接失败原因
连接失败通常源于认证链中断、网络拦截或本地服务未就绪，而非 端口 或防火墙配置问题。
1、检查 VS Code 状态栏是否显示 Tunnel Active；若显示 Tunnel Error，点击后查看具体错误代码。
2、确认系统时间准确，误差超过 5 分钟会导致 GitHub JWT 认证失败。
3、在终端执行 npx vscode-tunnels-cli status（需全局安装 vscode-tunnels-cli）验证服务健康状态。
4、若使用公司网络，确认其未屏蔽 vscode.dev 域名或 SNI 过滤了 *.vscode.dev。
