在服务器或无界面 Linux 环境中使用IntelliJ IDEA一直是个痛点。
借助Docker + linuxserver/intellij-idea 镜像，我们可以非常方便地通过浏览器远程使用 IDEA，实现「即开即用、环境隔离」。
本文将详细介绍如何通过一条docker run命令部署 IntelliJ IDEA，并解释每个参数的作用。
一、准备环境
在开始之前，请确保你的系统已经安装：
- Docker（20.x 及以上）
- Linux / macOS / Windows（WSL2）
验证 Docker 是否安装成功：
docker -v二、docker run 启动 IntelliJ IDEA
下面是一条完整、推荐的启动命令：
docker run -d\--name=intellij-idea\-ePUID=1000\-ePGID=1000\-eTZ=Etc/UTC\-p3000:3000\-p3001:3001\-v ./config:/config\--shm-size="4gb"\--restart unless-stopped\linuxserver/intellij-idea:42025.2.5执行完成后，容器会在后台启动。
三、参数详解（重点）
1️⃣ 容器运行模式
-d- 后台运行容器（daemon 模式）
--name=intellij-idea- 指定容器名称，方便后续管理
2️⃣ 用户权限映射（非常重要）
-ePUID=1000-ePGID=1000- 指定容器内进程使用的用户 ID 和组 ID
- 避免挂载目录出现权限问题
1000通常是 Linux 默认用户的 UID/GID
你可以通过以下命令查看本机 UID / GID：
id3️⃣ 时区设置
-eTZ=Etc/UTC- 设置容器时区
- 可按需修改，例如中国大陆可用：
-eTZ=Asia/Shanghai4️⃣ 端口映射
-p3000:3000 -p3001:30013000：IDEA Web UI 访问端口3001：WebSocket / 辅助服务端口
访问方式示例：
http://localhost:3000/5️⃣ 数据持久化（配置目录）
-v ./config:/config- 将 IDEA 的配置、插件、缓存持久化到宿主机
- 容器删除后，配置仍然保留
- 建议使用绝对路径，例如：
-v /data/intellij/config:/config6️⃣ 共享内存设置（性能关键）
--shm-size="4gb"- 提高共享内存大小
- 强烈建议设置 ≥ 2GB
- 否则 IDEA 可能出现卡顿、崩溃、白屏等问题
7️⃣ 自动重启策略
--restart unless-stopped- Docker 或服务器重启后自动启动
- 手动
docker stop时不会再自动拉起
8️⃣ 使用的镜像版本
linuxserver/intellij-idea:42025.2.5- 来自
linuxserver.io官方维护 - 指定版本号，避免 latest 带来的不确定性
- 可按需替换为其他版本
四、访问 IntelliJ IDEA
启动完成后，浏览器访问：
http://<服务器IP>:3000首次进入时：
- 会加载 Web 桌面
- 可进行 IntelliJ IDEA 初始化
- 支持安装插件、登录 JetBrains 账号
五、常用 Docker 管理命令
查看容器状态
dockerps查看日志
docker logs -f intellij-idea停止 / 启动容器
docker stop intellij-idea docker start intellij-idea删除容器（不删除配置）
dockerrmintellij-idea六、适用场景
✔ 远程服务器开发
✔ 云 IDE / 内网开发环境
✔ 多人共享开发主机
✔ 不想在本机安装 IDEA
七、总结
通过 Docker 部署 IntelliJ IDEA：
- ✅ 环境隔离
- ✅ 无需本地安装
- ✅ 支持浏览器访问
- ✅ 配置可持久化
- ✅ 适合长期运行
