Visual Studio Code Server
Visual Studio Code Server 是一项服务,您可以在远程开发机器(如桌面 PC 或虚拟机 (VM))上运行它。它允许您通过本地 VS Code 客户端从任何位置安全地连接到该远程机器,而无需 SSH。
什么是 VS Code Server?
在 VS Code 中,我们希望用户能够无缝地利用使他们最高效的环境。VS Code 远程开发扩展允许您直接从 VS Code 在适用于 Linux 的 Windows 子系统 (WSL)、通过 SSH 的远程机器和开发容器中工作。这些扩展在远程环境中安装服务器,使本地 VS Code 能够与远程源代码和运行时平滑地交互。
我们现在提供独立的“VS Code Server”,它是一项基于远程扩展使用的相同底层服务器构建的服务,外加一些其他功能,例如交互式 CLI 和促进与 vscode.dev 的安全连接。
架构
我们希望提供统一的 VS Code 体验,无论您如何在编辑器中使用它,无论是在本地还是远程,在桌面还是在浏览器中。
对 VS Code Server 的访问内置于现有的 code
CLI 中。
CLI 在 VS Code 客户端和您的远程机器之间建立隧道。隧道安全地将数据从一个网络传输到另一个网络。
VS Code Server 体验包括几个组件
- VS Code Server:使 VS Code 远程体验成为可能的后端服务器。
- Remote - Tunnels 扩展:自动加载到您的本地 VS Code 客户端中,它有助于连接到远程机器。
场景
VS Code Server 允许您以新的方式使用 VS Code,例如
- 在 SSH 支持可能受限或您需要基于 Web 的访问的远程机器上进行开发。
- 在不支持安装 VS Code 桌面的机器(例如 iPad/平板电脑或 Chromebook)上进行开发。
- 体验客户端安全优势,即所有代码都可以在浏览器沙箱中执行。
入门指南
您可以从两条路径中选择一条来启用隧道,这两条路径在其各自的文档内容中都有更详细的描述
尝试事项
许可和其他命令
首次运行 VS Code Server 时,系统会提示您接受许可条款。您可以在此处查看 VS Code Server 的许可证。
* Visual Studio Code Server
*
* By using the software, you agree to
* the Visual Studio Code Server License Terms (https://aka.ms/vscode-server-license) and
* the Microsoft Privacy Statement (https://privacy.microsoft.com/en-US/privacystatement).
您可以通过运行 code -h
来探索 CLI 的其他命令,并通过运行 code tunnel -help
来专门探索隧道命令
扩展命令
与 CLI 一样,VS Code Remote Tunnels 扩展也有其他命令,您可以通过在 VS Code 中打开命令面板 (F1
) 并键入 Remote Tunnels 来探索这些命令。您可以在远程隧道文档中了解更多信息。
遥测
如果您想禁用遥测,您可以在启动 VS Code Server 时传入 --disable-telemetry
:code tunnel --disable-telemetry
。或者,如果您想指定初始遥测级别(例如仅收集错误),您可以传入 --telemetry-level
,后跟级别(例如 error
)。
如果未通过 CLI 禁用遥测,则 VS Code Server 将在成功连接后开始遵守客户端遥测设置(您在 vscode.dev 或桌面中的遥测设置)。
常见问题
VS Code Server 是否设计为允许多个用户访问同一远程实例?
否,服务器的实例设计为由单个用户访问。
我可以将 VS Code Server 作为服务托管吗?
否,不允许将其作为服务托管,这在VS Code Server 许可证中指定。
是否有 VS Code Server 使用的端点列表?
如果您在受限环境中工作,您可能需要确保 VS Code Server 可以访问以下文章中列出的端点
- https://vscode.js.cn/docs/setup/network#_common-hostnames
- https://vscode.js.cn/docs/remote/ssh#_what-are-the-connectivity-requirements-for-the-vs-code-server-when-it-is-running-on-a-remote-machine-vm
是否有任何其他扩展限制?
当使用基于 Web 的 VS Code 实例时,不支持纯 UI 扩展,您可以在扩展作者的远程开发指南中了解更多信息。
是否有浏览器限制?
在浏览器中工作时,需要考虑某些限制和配置步骤。您可以在VS Code Web 版文档中阅读有关此内容的更多信息。
如何保持 VS Code Server 最新?
当您连接到远程机器时,如果更新可用,您将在 VS Code 中收到通知,并且您将能够直接通过此通知进行更新。
我看到有关密钥环存储的错误。我该怎么办?
设置同步需要针对设置同步服务器进行身份验证。相应的密钥持久保存在服务器上。这需要在服务器上设置密钥环。当未设置密钥环时,VS Code Server 将回退到存储在服务器上的内存中密钥。在这种情况下,密钥仅在服务器的生命周期内持久保存。
此问题提供了更多上下文,可能有助于您进行故障排除。如果您仍然遇到问题,请随时在VS Code Remote GitHub 存储库中提交新问题。
我在哪里可以提供反馈或报告问题?
如果您有任何问题或反馈,请在VS Code Remote GitHub 存储库中提交问题。提交问题时,请包括详细日志记录,您可以通过使用 -v
标志启动 VS Code Server 来启用详细日志记录:code -v tunnel
。
您可以使用 code-server
标签仅筛选 VS Code Server 问题。