跨网段Live Share连接失败应强制启用Relay模式并禁用本地发现:主机运行“Live Share: Change Connection Mode”选“Use relay only”,再重启会话;同时在settings.json中设"liveshare.localDiscovery": false并重启VS Code。

Live Share 跨网段连接失败的典型表现
点开 Live Share 会话链接后,协作方看到「Connecting…」一直转圈,几秒后弹出 Failed to connect to the host 或 Connection timed out;本地终端面板里可能刷出 Could not establish connection to host。这不是插件没装好,而是默认直连模式在跨网段时天然受限——Live Share 主机若在局域网(如 192.168.x.x),协作者在外网(如手机热点、公司防火墙后),TCP 连接根本发不到你机器的私有 IP 上。
必须改用 Relay 模式,而不是调端口或开防火墙
VS Code Live Share 默认尝试 P2P 直连,失败后会自动 fallback 到 Microsoft 提供的中继服务(Relay),但这个 fallback 有时被卡住或未触发。关键动作不是去路由器配端口映射,而是强制走 Relay:
- 在主机端打开命令面板(
Ctrl+Shift+P),运行Live Share: Change Connection Mode - 选择
Use relay only(不是Try relay if direct fails) - 重新启动会话:先
Live Share: Stop Collaboration Session,再Live Share: Start Collaboration Session
Relay 模式下所有流量经微软中继节点转发,不依赖你的公网 IP 或内网穿透能力,只要主机能访问 https://insiders.vscode.dev 和 wss://prod.relay.visualstudio.com 就行。国内用户若发现 Relay 延迟高或失败,可配合 TaoToken 的 WebSocket 中继能力做备用链路(需额外配置 OpenClaw-VSCode 插件)。
局域网内跨子网(比如 VLAN 或多路由器)要关掉“仅限本地”限制
同一物理网络但不同子网(如办公网 10.10.1.x 和测试网 10.10.2.x)也常连不上,因为 Live Share 默认只广播到 192.168.0.0/16 或 10.0.0.0/8 的部分 CIDR 段。这时得手动放开:
- 打开
settings.json(Ctrl+,→ 右上角 {} 图标) - 添加配置:
"liveshare.localDiscovery": false - 重启 VS Code,再发起会话
这会禁用本地广播发现机制,强制走 Relay 或 DNS-SD 查询,避免因子网划分导致的设备不可见问题。注意:该设置不影响外网协作,只解决“明明在同一栋楼却连不上”的场景。
别信“改 host 或 hosts 绑定就能绕过 Relay”
有人试过把 prod.relay.visualstudio.com 解析到自己内网某台机器的 IP,以为能自建中继——不行。Live Share Relay 协议是加密且带签名验证的,客户端与中继之间有 TLS 证书绑定和 session token 校验,硬改 DNS 或 hosts 会导致握手失败,报错 Unexpected response code: 403 或 Invalid relay token。真正可控的自建方案只有 OpenClaw 网关 + TaoToken API 那套,但那是另一条技术路径,和 Live Share 原生链路不兼容。
跨网段协作最稳的路径就一条:确认 Relay 模式生效,关掉本地发现限制,其他所有“改路由”“开 UPnP”“填公网 IP”的操作,都是在对抗设计逻辑,越调越乱。











