WebStorm 默认已内置 Docker 插件,无需手动安装;需在 Plugins 页面勾选“Show bundled plugins”后启用 Docker 插件,并配置 Docker daemon 连接(如 Unix socket 或 TCP)才能正常使用。

WebStorm 默认已内置 Docker 插件,无需手动安装
WebStorm 自 2016.3 起就将 Docker 插件作为默认捆绑插件(bundled),只要没被主动禁用,它就在那里。你不需要去 Marketplace 搜索、下载或“安装”它——这不是一个第三方插件,而是 IDE 原生支持的一部分。
常见误判场景:Plugins 页面里搜不到 Docker,往往是因为:搜索框输入了 “docker plugin” 或 “docker support” 这类非官方名称;或者误切到了 Installed 标签页却没勾选“Show bundled plugins”复选框(默认隐藏)。
检查并启用 Docker 插件的正确路径
打开 Settings / Preferences(Ctrl+Alt+S),进入 Plugins 页面:
- 点击右上角齿轮图标 → 勾选
Show bundled plugins - 在搜索框中输入
Docker(注意大小写不敏感,但别加空格或符号) - 找到名为
Docker的插件,确认其右侧复选框已勾选 - 如果之前被禁用过,勾选后需重启 WebStorm 才生效
重启后,Services 工具窗口(Alt+8)里应出现 Docker 节点;若仍不显示,说明插件未真正启用或 Docker daemon 连接未配置。
启用后必须配置 Docker 连接才能使用
插件启用 ≠ 功能可用。Docker 插件依赖本地或远程 Docker daemon 提供服务,WebStorm 需要知道怎么连上去:
- 进入
Settings → Build, Execution, Deployment → Docker - 点击
+添加配置,选择连接方式:Unix socket(Linux/macOS 默认)、TCP socket(远程服务器)或Docker for Windows(Windows Desktop) - 路径或地址填对是关键:
/var/run/docker.sock(Linux)、unix:///var/run/docker.sock(macOS)、tcp://localhost:2375(若启用了 Docker daemon 的 TCP 接口) - 点击
Test Connection,看到Connection successful才算真正就绪
没配好连接,即使插件开着,Services 窗口里 Docker 节点会灰显或报错,右键菜单里也看不到 Create container 或 Run Dockerfile。
Mac 和 Windows 用户最容易忽略的权限与路径问题
尤其 macOS 上,Docker Desktop 启动后,docker CLI 可用不代表 WebStorm 就能通——常卡在两个地方:
-
docker.sock权限不足:运行sudo chmod 666 /var/run/docker.sock(临时方案,长期建议用 Docker Desktop 用户组管理) - 项目路径不在 Docker Desktop 的
Resources → File Sharing白名单里:比如项目在/Users/xxx/projects/my-app,但该路径未添加进白名单,后续 volume 挂载会静默失败,docker exec -it xxx ls /app里啥都看不到 - Windows 用户若用 WSL2 后端,需确保 WebStorm 运行在 Windows 原生环境(而非 WSL 内),且 Docker Desktop 设置里启用了
Use the WSL 2 based engine
这些不是插件装没装好的问题,而是环境链路断在了 OS 层——插件只是个通道,它没法绕过系统级限制。


















