在服务器或无界面 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:
- ✅ 环境隔离
- ✅ 无需本地安装
- ✅ 支持浏览器访问
- ✅ 配置可持久化
- ✅ 适合长期运行