---
url: /zh/workspaces/jetbrains.md
---
在进行必要配置后，云原生开发环境支持通过 JetBrains Gateway 连接

::: warning 注意
使用 JetBrains 客户端前，需要先自定义开发环境（在 Dockerfile 中配置相关依赖），详见下方[准备工作](#准备工作)。
:::

支持以下 IDE：

* IntelliJ IDEA
* GoLand
* PyCharm
* WebStorm
* PhpStorm
* RubyMine
* CLion
* RustRover
* Rider

## 核心要求

JetBrains 入口是否显示，取决于开发环境镜像是否满足以下条件：

| 条件 | 说明 |
| --- | --- |
| 安装 `openssh-server` | Gateway 通过 SSH 连接，必须安装 |
| IDE 安装到 `/ide_cnb` | 系统通过此目录自动识别已安装的 IDE |

## 准备工作

如果需要使用 Jetbrains 客户端访问云原生开发环境，需要做如下准备：

### 1. 安装 JetBrains Gateway

在本地电脑下载并安装 [JetBrains Gateway](https://www.jetbrains.com/remote-development/gateway/)（支持 Mac/Windows）。

### 2. 配置 Dockerfile

**获取 IDE 下载地址**：[JetBrains 产品页](https://www.jetbrains.com/products/) → 选择 IDE → **Download** → **Linux** 版本 → 右键 **direct link** 复制连接地址

**Dockerfile 示例**：

```Dockerfile{7,10,14-57}
# .ide/Dockerfile
FROM node:22

WORKDIR /root

# 安装 ssh 服务，用于支持 JetBrains Gateway/vscode/cursor 等客户端连接
RUN apt-get update && apt-get install -y wget unzip openssh-server

# 创建 /ide_cnb 目录，用于安装 IDE，注意安装路径必须是这个，便于自动识别环境中支持哪些 ide
RUN mkdir -p /ide_cnb

# ========== 按需选择安装以下 IDE（支持安装多个，建议注释掉不需要的） ==========
# GoLand
RUN wget https://download.jetbrains.com/go/goland-2025.2.5.tar.gz \
    && tar -zxvf goland-2025.2.5.tar.gz -C /ide_cnb \
    && rm goland-2025.2.5.tar.gz

# IntelliJ IDEA
RUN wget https://download.jetbrains.com/idea/ideaIU-2025.2.5.tar.gz \
    && tar -zxvf ideaIU-2025.2.5.tar.gz -C /ide_cnb \
    && rm ideaIU-2025.2.5.tar.gz

# PhpStorm
RUN wget https://download.jetbrains.com/webide/PhpStorm-2025.2.5.tar.gz \
    && tar -zxvf PhpStorm-2025.2.5.tar.gz -C /ide_cnb \
    && rm PhpStorm-2025.2.5.tar.gz

# PyCharm
RUN wget https://download.jetbrains.com/python/pycharm-2025.2.5.tar.gz \
    && tar -zxvf pycharm-2025.2.5.tar.gz -C /ide_cnb \
    && rm pycharm-2025.2.5.tar.gz


# RubyMine
RUN wget https://download.jetbrains.com/ruby/RubyMine-2025.2.5.tar.gz \
    && tar -zxvf RubyMine-2025.2.5.tar.gz -C /ide_cnb \
    && rm RubyMine-2025.2.5.tar.gz

# WebStorm
RUN wget https://download.jetbrains.com/webstorm/WebStorm-2025.2.5.tar.gz \
    && tar -zxvf WebStorm-2025.2.5.tar.gz -C /ide_cnb \
    && rm WebStorm-2025.2.5.tar.gz
# CLion
RUN wget https://download.jetbrains.com/cpp/CLion-2025.2.5.tar.gz \
    && tar -zxvf CLion-2025.2.5.tar.gz -C /ide_cnb \
    && rm CLion-2025.2.5.tar.gz

# RustRover
RUN wget https://download.jetbrains.com/rustrover/RustRover-2025.2.5.tar.gz \
    && tar -zxvf RustRover-2025.2.5.tar.gz -C /ide_cnb \
    && rm RustRover-2025.2.5.tar.gz

# Rider
RUN wget https://download.jetbrains.com/rider/JetBrains.Rider-2025.3.0.3.tar.gz \
    && tar -zxvf JetBrains.Rider-2025.3.0.3.tar.gz -C /ide_cnb \
    && rm JetBrains.Rider-2025.3.0.3.tar.gz

# ========== 可选：安装 VSCode WebIDE ==========

RUN curl -fsSL https://code-server.dev/install.sh | sh \
    && code-server --install-extension cnbcool.cnb-welcome \
    && code-server --install-extension redhat.vscode-yaml \
    && code-server --install-extension orta.vscode-jest \
    && code-server --install-extension dbaeumer.vscode-eslint \
    && code-server --install-extension waderyan.gitblame \
    && code-server --install-extension mhutchie.git-graph \
    && code-server --install-extension donjayamanne.githistory

ENV LANG C.UTF-8
```

## 访问开发环境

环境创建完成后，点击 **JetBrains** 按钮即可打开 Gateway 连接。

入口位置：

* **启动页**：点击「启动云原生开发」环境创建成功后显示 IDE 入口选择页
* **开发环境列表**：头像 → 我的云原生开发
* **分支列表**：已创建环境的分支右侧按钮打开 IDE 入口选择页

## 常见问题

| 现象 | 可能原因 |
| --- | --- |
| 未显示 JetBrains 按钮 | IDE 未安装到 `/ide_cnb` 目录 |
| Gateway 连接失败 | 镜像中未安装 `openssh-server` |
| 本地无法打开 | 未安装 JetBrains Gateway |

## 进阶

上述流程已经足以正常使用 JetBrains IDE 连接云原生开发环境。如需自定义云开发环境启动流程，详见 [自定义环境创建流程](./custom-dev-pipeline.md)。