讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

VSCode实时协作怎么在企业内网环境下正常运行

雨涛酱_5421

雨涛酱_5421

发布时间:2026-11-21 06:55:18

|

944人浏览过

|

来源于php中文网

原创

Live Share 内网协作失败主因是默认连接微软云服务被拦截,须改用自托管信令服务器并禁用云端服务;需统一 VSCode 版本、校准时钟、配置 DNS/防火墙、透传 WebSocket 头,且通过 /health 接口验证服务可用。

vscode实时协作怎么在企业内网环境下正常运行

Live Share 无法连接内网服务器的典型表现

你点击“Start Collaboration Session”后,状态栏一直显示 Starting...,几秒后弹出错误:Failed to start collaboration session: Unable to connect to Live Share service。这不是你网络没连上,而是 VSCode 默认尝试连接微软云服务(https://prod.liveshare.vsengsaas.visualstudio.com),而企业防火墙或代理策略直接拦截了该域名或其 CDN 节点。

必须关闭云端中继,改用本地信令服务器

Live Share 默认依赖微软托管的信令/中继服务,这在内网不可行。你需要强制切换为“自托管信令模式”,所有连接协商都走你自己的内网服务器:

VSCode节点工具(专业版)
VSCode节点工具(专业版)

面向团队的企业级IDE远程操作平台,含调试、测试、终端、Agent委托与团队协作能力。

下载
  • 在 VSCode 中打开命令面板(Ctrl+Shift+P),运行 Live Share: Configure Local Relay Server
  • 按提示输入内网可访问的地址,例如 http://liveshare.internal:3218(该地址需提前部署好 liveshare-server 实例)
  • 编辑工作区 .vscode/settings.json,显式禁用云端服务:
    {
      "liveshare.localRelayServer": "http://liveshare.internal:3218",
      "liveshare.allowHttpConnections": true,
      "liveshare.enableCloudServices": false
    }
  • 确保所有协作成员都使用同一台信令服务器,并且该服务器能被所有人通过 HTTP 直达(无需反向代理或额外跳转)

内网信令服务器部署与验证要点

微软官方提供开源的 liveshare-server,但企业部署时容易忽略三个关键点:

  • 它不自带 HTTPS,若用 HTTPS 反向代理(如 Nginx),必须透传 Upgrade 和 Connection 头,否则 WebSocket 升级失败
  • 启动时必须指定 --allowed-origins,例如 --allowed-origins="vscode://*" --allowed-origins="http://localhost:*",否则浏览器端拒绝连接
  • 信令服务器和 VSCode 客户端的时钟误差不能超过 5 分钟,否则 JWT 鉴权失败 —— 内网机器常因未配置 NTP 同步导致静默失败
  • 验证是否就绪:在浏览器中直接访问 http://liveshare.internal:3218/health,返回 {"status":"ok"} 才算真正可用

协作会话建立后仍卡在“Waiting for guest”

信令通了,但参与者始终看不到对方光标或文件树,常见于以下两种情况:

  • VSCode 版本不一致:发起方是 1.85.0,加入方是 1.79.2 —— Live Share 的 P2P 协议版本不兼容,必须统一到同一大版本(如全部 ≥1.84.0)
  • 内网 DNS 解析异常:VSCode 尝试用主机名(如 dev01.internal)建立直连,但部分机器 hosts 未映射或 DNS 缓存过期;建议在 settings.json 中强制指定 "liveshare.hostName": "10.1.2.3"(填实际 IP)
  • Windows 防火墙默认阻止入站 UDP 流量 —— Live Share P2P 使用 UDP 打洞,需手动放行端口范围 3216-3220 或临时关闭防火墙测试
内网 Live Share 最难调试的不是连接失败,而是连接成功后数据不通——因为问题分散在信令、P2P、DNS、防火墙、时钟、版本六个层面,任一环节偏差都会导致“看起来连上了,实则无法协作”。建议先用两台同网段虚拟机最小化复现,再逐步放开网络策略。

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

1695

2023.06.30

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3712

2023.07.21

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2209

2024.03.14

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1787

2024.03.14

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2667

2024.03.15

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1878

2024.03.15

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1322

2024.03.15

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1176

2024.03.15

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn