Docker插件必须启用且重启WebStorm;连接需匹配实际环境(如Colima路径或TCP地址);私有镜像须在IDE内配置registry;macOS/Windows需提前配置路径映射白名单。
确认 Docker 插件已启用,不是“装了就行”
WebStorm 默认自带 Docker 插件,但可能被手动禁用——这是最常被忽略的第一步。插件未启用时,服务窗口里压根看不到
节点,后续所有操作都卡死。
打开
→
Plugins
→ 切到
Installed
标签页
搜索
,确保复选框已勾选(哪怕显示“Bundled”)
重启 WebStorm,否则改动不生效
常见错误现象:
里没有 Docker 图标;右键项目无
相关菜单。别急着配远程、拉镜像,先过这一关。
本地 Docker 连接失败?重点查路径映射和守护进程地址
Windows/macOS 上 WebStorm 默认连的是 Docker Desktop 的 socket,但一旦你用的是 Colima、Rancher Desktop 或自建 dockerd,地址就不是默认值——连不上时,90% 是这里错了。
进入
→
Build, Execution, Deployment → Docker
点击
添加配置,类型选
/
/
(根据你实际环境)
若用 TCP 方式(比如远程开发机),填
,**必须确保远端 Docker 已开启
并放行防火墙**
macOS 使用 Colima 时,Socket 路径通常是
,不能写成
连接成功前,对话框底部会显示
。没这行字,别往下走。
拉镜像或运行容器时提示 “no basic auth credentials”
这是私有 registry 或 Docker Hub 登录态缺失的典型报错。WebStorm 不会自动复用 CLI 的
凭据,必须在 IDE 内单独配置。
打开
工具窗口(
),右键
节点 →
选
类型,输入账号密码(注意:不是邮箱,是 Docker ID)
如果用公司私有 registry(如
),类型选
,URL 填完整地址(含
),并勾选
配置后,在
节点下展开对应 registry,才能看到私有镜像列表
不配 registry 就直接输
拉镜像?必然失败。WebStorm 不会猜你用哪个仓库。
文件映射失效、容器内代码不更新?检查路径映射白名单
Linux 主机上无此问题,但 macOS/Windows 用户常遇到:改了本地代码,容器里
却没反应——根本原因是 Docker Desktop 虚拟机只认“白名单路径”,你项目不在其中,挂载就静默失败。
进
→
Build, Execution, Deployment → Docker → Configurations
找到你的 Docker 连接,点
(小齿轮图标)
在
Path mappings
表里添加你项目所在的本地路径,例如
→ 映射到虚拟机中任意路径(如
)
之后创建容器时,绑定目录必须用这个映射后的路径(
),而不是原始本地路径
这个映射表只对 macOS/Windows 生效,且**必须提前配好**。等你建完容器再补,旧容器不会自动重挂——得删掉重建。
最麻烦的其实是路径映射 + 远程 Docker + 私有 registry 三者叠加:一个没配对,整个链路就断。建议按顺序验证:插件 → 连接 → registry → 映射,每步看到绿色成功提示再动下一步。
DockerCtrl+Alt+SDockerView → Tool Windows → ServicesDockerCtrl+Alt+S+Docker for MacDocker for WindowsTCP sockettcp://192.168.x.x:2375-H tcp://0.0.0.0:2375/Users/xxx/.colima/docker.sock/var/run/docker.sockConnection successfuldocker loginServicesAlt+8DockerDocker Registry…Docker Hubregistry.example.comOtherhttps://Use HTTPSImagesmy-privaterepo/app:latestnpm run devCtrl+Alt+SConfigure paths/Users/me/my-vue-app/project/project