WebStorm 2025.2 Help

完全离线模式

由于贵公司的安全规定,可能会限制访问互联网。 然而,公司可以配置一个隔离网络环境,使您能够处理远程项目。

虽然隔离网络环境是此类情况下的最佳解决方案,但请注意,client 需要下载并保存在本地。 此外,每次您要使用 WebStorm 的新版本时,都需要重新下载并保存它们。

设置隔离网络环境

  1. 下载并解压 JetBrains Client Downloader。

    JetBrains Client Downloader 的版本须为 1849 或更高版本。

  2. 在可访问 JetBrains 服务器的服务器上,使用产品(IDE)、版本或构建号、本地开发机平台作为筛选条件运行脚本。 同时运行 --download-backends 标志以下载匹配这些筛选条件的 backend。

    请查看以下示例:

    /bin/bash jetbrains-clients-downloader --products-filter WS --build-filter 223.7255.1 --include-eap-builds --platforms-filter linux-x64 --download-backends Desktop/backends
    • --products-filter WS :这是 WebStorm

    • --build-filter 223.7255.1 :这是最新 EAP 版本号。

      由于构建号经常变化,请使用 WebStorm 的官方 下载页面 以获取正确的构建号。

    • --platforms-filter linux-x64 :这是您的本地 Linux 笔记本电脑,因此将下载 Linux 归档文件

    • Desktop/backends :这是您下载 client 归档文件的目标目录

    如果未使用筛选条件,则默认情况下会下载所有内容。 有关详细语法,请运行以下命令:

    jetbrains-clients-downloader -h
  3. 运行脚本时不要使用 --download-backends 标志。

    下载 backend、client 和 JBR 后,您可以根据公司政策将其内部托管。

  4. 安装或更新独立的 JetBrains Gateway

    JetBrains Gateway 的版本须为 223.7571.203 或更高版本。

  5. 要将 JetBrains Gateway 配置为隔离网络环境,请为每一个已下载内容的设置创建一个单独文件:

    • productsInfoUrl :backend 下载器生成的 products.json 的路径(可能是 http://https://

    • clientDownloadUrl :通过 client 下载器获取的 client 路径(可能是 http://https://

    • jreDownloadUrl :通过 client 下载器获取的 JBR 路径(可能是 http://https://

    • pgpPublicKeyUrl :通过 client build 下载的 KEYS 文件的 URL

    请查看以下示例:

    • $ cat productsInfoUrl

      https://internal.site/backends/<PRODUCT_CODE>/products.json

    • $ cat clientDownloadUrl

      https://internal.site/clients/

    • $ cat jreDownloadUrl

      https://internal.site/jre/

    • $ cat pgpPublicKeyUrl

      https://internal.site/KEYS

  6. 确保已设置可处理生成 URL 的 Web 服务器。 在托管 backend/client 存储的机器上设置如 nginx 的 Web 服务器。

  7. 创建的文件 放置于开发者本地计算机上的系统路径下:

    • 针对特定用户的设置:

      /Users/UserName/Library/Application Support/JetBrains/RemoteDev/

    • 针对整个系统的设置:

      /Library/Application Support/JetBrains/RemoteDev/

    • 针对特定用户的设置:

      $HOME/.config/JetBrains/RemoteDev/

    • 针对整个系统的设置:

      /etc/xdg/JetBrains/RemoteDev/

    • 针对特定用户的设置:

      使用 HKEY_CURRENT_USER 注册表

    • 针对整个系统的设置:

      使用 HKEY_LOCAL_MACHINE 注册表

    SOFTWARE\JetBrains\RemoteDev 中,为每个设置创建一个字符串及其对应值。

    Windows

配置 JetBrains Client 的版本管理

在某些情况下,您可能需要控制本地 JetBrains Client 的版本。

为此,您需要在名为 OsRegistryConfigProvider 的操作系统注册表中为 versionManagementEnabled 参数设置一个值。 注册表的位置取决于您的操作系统。

针对整个系统:

/Library/Application Support/JetBrains/JetBrainsClient/config.json

针对特定用户:

~/Library/Application Support/JetBrains/JetBrainsClient/config.json

编写一个包含参数 versionManagementEnabled 和值 "true" 的 json 对象。

如果您想禁用该参数,请添加 "false" 以替代 "true"

json 文件示例:

{ "versionManagementEnabled": "true" }

针对整个系统:

/etc/xdg/JetBrains/JetBrainsClient/config.json

针对特定用户:

~/.config/JetBrains/JetBrainsClient/config.json

或其他通过 XDG_CONFIG_HOME 指定的位置:https://specifications.freedesktop.org/basedir-spec/basedir-spec-0.6.html

编写一个包含参数 versionManagementEnabled 和对应值 "true" 的 JSON 对象。

{ "versionManagementEnabled": "true" }

如果您希望禁用此参数,请使用 "false" 替代 "true"

适用于整个系统:

HKEY_LOCAL_MACHINE/SOFTWARE/JetBrains/JetBrainsClient

适用于特定用户:

HKEY_CURRENT_USER/SOFTWARE/JetBrains/JetBrainsClient

创建一个 REG_SZREG_EXPAND_SZ 项,使用 versionManagementEnabled 作为键, true 作为值。

故障排除

如果遇到问题,请确保检查以下内容:

  • 请确保已下载与当前正在使用的 IDE 匹配的正确客户端。

  • 向支持团队提交 JetBrains Gateway 日志时,请一并包含来自本地计算机的日志。

  • 请截取配置文件步骤的屏幕截图。

最后修改日期: 2025年 9月 26日