# 完全离线模式

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

由于贵公司的安全规定，互联网访问可能会受到限制。 但是，公司可以配置隔离网络环境，让您可以处理远程项目。

虽然隔离环境是在这种情况下的最佳解决方案，但请记住，客户端需要下载并保存在本地。 此外，每次您想要使用新版本的 IntelliJ IDEA 时，都需要再次下载并保存。

Procedure: 设置隔离网络环境

1. [下载并解压](https://data.services.jetbrains.com/products/download?code=JCD&platform=linux_x86-64) JetBrains Client Downloader。

> **Note:**
> JetBrains Client Downloader 的版本需要为   1849   或更高版本。
>
>
>
> 该脚本仅支持 Linux。

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

请查看以下示例：

```SHELL
/bin/bash jetbrains-clients-downloader --products-filter IU --build-filter 223.7255.1 --include-eap-builds --platforms-filter linux-x64 --download-backends Desktop/backends

```

* `--products-filter IU` ：这是 IntelliJ IDEA 旗舰版

* `--build-filter 223.7255.1` ：这是最新的 EAP 版本号。 由于构建号经常更改，请使用官方 IntelliJ IDEA [下载页面](https://www.jetbrains.com/zh-cn/idea/download/other.html)以获取正确的构建号。

* `--platforms-filter linux-x64` ：这是您的本地 Linux 笔记本电脑，因此下载的是 Linux 档案

* `Desktop/backends` ：这是您下载客户端存档的目标目录

> **Note:**
> 如果不使用过滤器，那么默认情况下，所有内容都会被下载。

要获取详细的语法，请运行以下命令：

```SHELL
jetbrains-clients-downloader -h

```

3. 在没有  `--download-backends`  标志的情况下运行脚本。

下载后端、客户端和 JBR 后，可以根据贵公司的政策在内部托管它们。

4. 在托管后端和客户端存储的机器上设置一个 Web 服务器，例如  `nginx` 。

此服务器的 URL 是在 JetBrains Gateway 设置文件中指定的值。

5. 安装或更新独立的 [JetBrains Gateway](jetbrains-gateway.html#manual_launch)。

更新 JetBrains Gateway 的另一种方法是使用 [Toolbox App](https://www.jetbrains.com/zh-cn/help/toolbox-app/introduction.html)。

> **Note:**
> JetBrains Gateway 的版本需要为   223.7571.203   或更高版本。

6. 要为隔离环境配置 JetBrains Gateway，请为描述已下载内容的每项设置创建单独的文件：

* `productsInfoUrl` ：由后端的下载器生成的 `products.json` 路径（可能是 `http://` 或 `https://` ） > **Note:** > `<PRODUCT_CODE>` 是 JetBrains Gateway 替换为相应产品代码的精确占位符。

* `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`

> **Note:**
> 创建单独的文件仅适用于 macOS 和 Linux。

将创建的文件放置在开发者本地机器上的系统位置：

macOS:

* 对于用户特定的设置： `/Users/UserName/Library/Application Support/JetBrains/RemoteDev/`

* 对于系统范围的设置： `/Library/Application Support/JetBrains/RemoteDev/`

Unix / Linux:

* 对于用户特定的设置： `$HOME/.config/JetBrains/RemoteDev/`

* 对于系统范围的设置： `/etc/xdg/JetBrains/RemoteDev/`

Windows:

* 对于用户特定的设置： 使用 `HKEY_CURRENT_USER` 注册表

* 对于系统范围的设置： 使用 `HKEY_LOCAL_MACHINE` 注册表

在  `SOFTWARE\JetBrains\RemoteDev`  中，为每个设置创建一个相应值的字符串。

![Windows](https://resources.jetbrains.com/help/img/idea/2026.3/offline_mode.png)

## 配置 JetBrains Client 的版本管理

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

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

macOS:

整个系统：

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

对于特定用户：

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

写入一个 json 对象，其中包含形参  `versionManagementEnabled`  和值  `"true"` 。

如果要禁用此形参，请添加  `"false"`  而不是  `"true"` 。

`json`  文件的示例：

```JSON
{
    "versionManagementEnabled": "true"
}

```

> **Note:**
> 或者，可以创建一个单独的配置文件，名称为  `versionManagementEnabled` ，并在其中包含值  `false` ，以禁用自动管理。

Unix / Linux:

整个系统：

```
/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"` 。

```JSON
{
    "versionManagementEnabled": "true"
}

```

如果要禁用此形参，请添加  `"false"`  而不是  `"true"` 。

> **Note:**
> 或者，可以创建一个单独的配置文件，名称为  `versionManagementEnabled` ，并在其中包含值  `false` ，以禁用自动管理。

Windows:

整个系统：

```
HKEY_LOCAL_MACHINE/SOFTWARE/JetBrains/JetBrainsClient
```

对于特定用户：

```
HKEY_CURRENT_USER/SOFTWARE/JetBrains/JetBrainsClient
```

创建  `REG_SZ`  或  `REG_EXPAND_SZ`  条目，使用  `versionManagementEnabled`  作为键，并将  `true`  作为值。

## 故障排除

如果您遇到问题，请确保检查以下内容：

* 请确保您已经下载了适用于您当前使用的 IDE 的正确客户端。

* 提交 JetBrains Gateway 日志给支持团队时，请包括本地机器上的日志。

* 请从配置文件所在的步骤截图。

