---
url: /zh/workspaces/jetbrains.md
description: >
  介绍如何配置云原生开发环境以支持 JetBrains Gateway 连接， 包括 IDEA、GoLand、PyCharm 等多款 IDE
  的准备工作和连接方式。
---
云原生开发环境配置后，即可通过 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、VS Code、Cursor 等客户端连接
RUN apt-get update && apt-get install -y wget unzip openssh-server

# 创建 `/ide_cnb` 目录，用于安装 IDE。系统通过此目录自动识别已安装的 IDE，安装路径必须为 `/ide_cnb`。
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)。