Visual Studio Code 服务器
Visual Studio Code 服务器是一种服务,您可以在远程开发机(如台式电脑或虚拟机 (VM))上运行它。它允许您通过本地 VS Code 客户端从任何地方安全地连接到该远程机器,而无需 SSH。
什么是 VS Code 服务器?
在 VS Code 中,我们希望用户能够无缝地利用那些能让他们最高效的环境。VS Code 远程开发扩展让您能够直接从 VS Code 中在适用于 Linux 的 Windows 子系统 (WSL)、通过 SSH 连接的远程机器以及开发容器中工作。这些扩展会在远程环境中安装一个服务器,从而使本地 VS Code 能够顺利地与远程源代码和运行时交互。
我们现在提供一个独立的“VS Code 服务器”,它是在远程扩展所使用的相同底层服务器的基础上构建的服务,并增加了一些额外功能,例如交互式 CLI 和促进与 vscode.dev 的安全连接。
架构
无论您如何使用编辑器,无论是本地还是远程,在桌面还是在浏览器中,我们都希望提供统一的 VS Code 体验。
VS Code 服务器的访问功能已内置到现有的 code
CLI 中。
CLI 在 VS Code 客户端和您的远程机器之间建立隧道。隧道安全地将数据从一个网络传输到另一个网络。
VS Code 服务器体验包含几个组件
- VS Code 服务器:支持 VS Code 远程体验的后端服务器。
- 远程 - 隧道扩展:自动加载到您的本地 VS Code 客户端中,它促进了与远程机器的连接。
场景
VS Code 服务器允许您以新的方式使用 VS Code,例如:
- 在 SSH 支持可能受限的远程机器上进行开发,或者您需要基于 Web 的访问。
- 在不支持安装 VS Code 桌面版的机器上进行开发,例如 iPad / 平板电脑或 Chromebook。
- 体验客户端安全优势,即所有代码都可以在浏览器沙盒中执行。
开始使用
您可以选择两种路径来启用隧道,其详细信息在其各自的文档内容中描述:
尝试事项
许可及其他命令
首次运行 VS Code 服务器时,系统会提示您许可条款。您可以在此处查看 VS Code 服务器的许可。
* 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 远程隧道扩展也提供其他命令,您可以在 VS Code 中打开命令面板 (F1
) 并输入 Remote Tunnels 来探索这些命令。您可以在远程隧道文档中了解更多信息。
遥测
如果您想禁用遥测,可以在启动 VS Code 服务器时传入 --disable-telemetry
:code tunnel --disable-telemetry
。另外,如果您想指定初始遥测级别,例如只收集错误,可以传入 --telemetry-level
后跟级别(例如 error
)。
如果未通过 CLI 禁用遥测,则 VS Code 服务器将在成功连接后开始遵守客户端遥测设置(您在 vscode.dev 或桌面版中的遥测设置)。
常见问题
VS Code 服务器是否支持多用户访问同一个远程实例?
否,服务器的实例设计为由单个用户访问。
我可以将 VS Code 服务器作为服务托管吗?
否,根据VS Code 服务器许可中的规定,不允许将其作为服务托管。
VS Code 服务器使用的端点列表在哪里?
如果您在受限环境中工作,可能需要确保 VS Code 服务器可以访问以下文章中列出的端点:
- 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 扩展,您可以在扩展作者的远程开发指南中了解更多信息。
存在浏览器限制吗?
在浏览器中工作时,需要考虑某些限制和配置步骤。您可以在Web 版 VS Code 文档中了解更多信息。
如何保持 VS Code 服务器最新?
如果有可用更新,当您连接到远程机器时,VS Code 中会显示通知,您可以通过此通知直接更新。
我看到了关于密钥环存储的错误。我该怎么做?
设置同步需要对设置同步服务器进行身份验证。相应的密钥会保留在服务器上。这需要在服务器上设置一个密钥环。如果未设置密钥环,VS Code 服务器将回退到存储在服务器内存中的密钥。在这种情况下,密钥仅在服务器的生命周期内持续存在。
此问题提供了更多背景信息,可能有助于您进行故障排除。如果您仍然遇到问题,请随时在VS Code Remote GitHub 仓库中提出新问题。
我在哪里可以提供反馈或报告问题?
如果您有任何问题或反馈,请在VS Code Remote GitHub 仓库中提交问题。提交问题时,请包含详细日志,您可以通过使用 -v
标志启动 VS Code 服务器来启用此功能:code -v tunnel
。
您可以使用 code-server
标签仅筛选 VS Code 服务器相关问题。