使用Docker部署IntelliJ IDEA(linuxserver/intellij-idea)的完整指南

温三胖

目录

• 一、准备环境
• 二、docker run 启动 IntelliJ IDEA
• 三、参数详解（重点）
• 容器运行模式
• 用户权限映射（非常重要）
• 时区设置
• 端口映射
• 数据持久化（配置目录）
• 共享内存设置（性能关键）
• 自动重启策略
• 使用的镜像版本
• 四、访问 IntelliJ IDEA
• 五、常用 Docker 管理命令
• 查看容器状态
• 查看日志
• 停止 / 启动容器
• 删除容器（不删除配置）
• 六、适用场景
• 七、总结

在服务器或无界面 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 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v ./config:/config \
  --shm-size="4gb" \
  --restart unless-stopped \
  linuxserver/intellij-idea:42025.2.5

执行完成后，容器会在后台启动。

三、参数详解（重点）

容器运行模式

-d

后台运行容器（daemon 模式）

--name=intellij-idea

指定容器名称，方便后续管理

用户权限映射（非常重要）

-e PUID=1000
-e PGID=1000

• 指定容器内进程使用的用户 ID 和组 ID
• 避免挂载目录出现 权限问题
• 1000 通常是 Linux 默认用户的 UID/GID

你可以通过以下命令查看本机 UID / GID：

id

时区设置

-e TZ=Etc/UTC

• 设置容器时区
• 可按需修改，例如中国大陆可用：

-e TZ=Asia/Shanghai

端口映射

-p 3000:3000
-p 3001:3001

• 3000：IDEA Web UI 访问端口
• 3001：WebSocket / 辅助服务端口

访问方式示例：http://localhost:3000/

数据持久化（配置目录）

-v ./config:/config

• 将 IDEA 的配置、插件、缓存持久化到宿主机
• 容器删除后，配置仍然保留
• 建议使用绝对路径，例如：

-v /data/intellij/config:/config

共享内存设置（性能关键）

--shm-size="4gb"

• 提高共享内存大小
• 强烈建议设置 ≥ 2GB
• 否则 IDEA 可能出现卡顿、崩溃、白屏等问题

自动重启策略

--restart unless-stopped

• Docker 或服务器重启后自动启动
• 手动 docker stop 时不会再自动拉起

使用的镜像版本

linuxserver/intellij-idea:42025.2.5

• 来自 linuxserver.io 官方维护
• 指定版本号，避免 latest 带来的不确定性
• 可按需替换为其他版本

四、访问 IntelliJ IDEA

启动完成后，浏览器访问：http://<服务器IP>:3000

首次进入时：

• 会加载 Web 桌面
• 可进行 IntelliJ IDEA 初始化
• 支持安装插件、登录 JetBrains 账号

五、常用 Docker 管理命令

查看容器状态

docker ps

查看日志

docker logs -f intellij-idea

停止 / 启动容器

docker stop intellij-idea
docker start intellij-idea

删除容器（不删除配置）

docker rm intellij-idea

六、适用场景

远程服务器开发

云 IDE / 内网开发环境

多人共享开发主机

不想在本机安装 IDEA

七、总结

通过 Docker 部署 IntelliJ IDEA：

• 环境隔离
• 无需本地安装
• 支持浏览器访问
• 配置可持久化
• 适合长期运行

到此这篇关于使用Docker部署IntelliJ IDEA(linuxserver/intellij-idea)的完整指南的文章就介绍到这了,更多相关Docker部署IntelliJ IDEA内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！