PyCharm 2025.3 Help

完全离线模式

由于贵公司的安全规定,Internet 访问可能受到限制。 不过,公司可以配置物理隔离环境,使您能够处理远程项目。

尽管在这种情况下物理隔离环境是最佳解决方案,但请注意,客户端需要下载并保存在本地。 此外,每当您希望使用 PyCharm 的新版本时,都需要再次下载并保存它们。

设置物理隔离环境

  1. 下载并解压 JetBrains Client Downloader。

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

  2. 在可通过 Internet 访问 JetBrains 服务器的服务器上,使用产品(IDE)、版本或构建号、平台(开发者本地使用的机器)等筛选器运行脚本。 另外,使用 --download-backends 标志下载与给定筛选条件匹配的后端。

    请查看以下示例:

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

    • --build-filter 223.7255.1 :这是最新的 EAP 发行编号。

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

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

    • Desktop/backends :这是您下载客户端归档的目标目录

    如果未使用任何筛选器,则默认会下载所有内容。 如需详细语法,请运行以下命令:

    jetbrains-clients-downloader -h
  3. 在不带 --download-backends 标志的情况下运行脚本。

    下载后端、客户端和 JBR 之后,您可以根据公司策略在内部托管它们。

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

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

  5. 要为物理隔离环境配置 JetBrains Gateway,请为描述您已下载内容的每个设置创建单独的文件:

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

    • clientDownloadUrl :您从客户端下载器获得的客户端路径(可以是 http://https://

    • jreDownloadUrl :您从客户端下载器获得的 JBR 路径(可以是 http://https://

    • pgpPublicKeyUrl :指向随客户端构建一同下载的 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. 请确保您已设置 Web 服务器以处理创建的 URL。 在承载后端/客户端存储的机器上设置 Web 服务器,例如 nginx

  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

写入一个 JSON 对象,包含参数 versionManagementEnabled ,其值为 "true"

如果要禁用此参数,请添加 "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

写入一个 JSON 对象,包含参数 versionManagementEnabled ,其值为 "true"

{ "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年 12月 2日