WebStorm Docker连接失败95%是daemon未就绪，先运行docker ps验证；检查服务状态、socket权限、用户组、Docker Desktop登录及资源；确认WebStorm中Docker插件启用且CLI路径正确；容器退出需查Logs；端口映射后仍无法访问需检查宿主机端口占用、防火墙、容器内监听地址及挂载路径。
WebStorm 的 Docker 工具连接失败，95% 是因为 Docker daemon 本身没通，不是 WebStorm 配置错了。 它不会弹窗说“连不上 socket”，只会让 Docker 运行配置灰掉、Services 工具窗口空着、点 Run Dockerfile 没反应——先别调 WebStorm 设置，去终端敲 docker ps 看是否报错。
检查 docker daemon 是否真正就绪
WebStorm 的 Docker 插件依赖本地 docker CLI 能正常通信，而 CLI 又依赖 dockerd 正在监听 /var/run/docker.sock。很多“WebStorm 连不上 Docker”本质是 daemon 启动失败或权限卡住。
- 在终端运行
docker ps：如果报cannot connect to the docker daemon，说明问题不在 WebStorm - 查服务状态：
systemctl status docker（Linux）或看 Docker Desktop 是否已启动并显示绿色图标（macOS/Windows） - 常见静默失败点：
/var/run/docker.sock权限不对（应属root:docker），当前用户没加进docker用户组（sudo usermod -aG docker $USER，然后重登） - macOS/Windows 用户注意：Docker Desktop 必须已登录且资源分配足够（至少 2GB 内存），否则容器 build 会卡在
Step 1/10不动
WebStorm Docker 插件是否启用且识别到 CLI
即使 docker 命令能用，WebStorm 也可能没找到它——尤其当 CLI 不在默认 PATH 或你用了自定义安装路径（如 Homebrew 安装的 Docker Desktop CLI）。
- 打开
Settings → Tools → Docker，确认Connect to Docker daemon with选的是Unix socket（Linux/macOS）或TCP socket（Windows Docker Desktop 默认走 TCP） - Unix socket 路径默认是
/var/run/docker.sock，但某些发行版（如 Arch）可能用/run/docker.sock，手动改对 - TCP socket 地址默认是
tcp://localhost:2375，但 Docker Desktop 默认不暴露该端口；需在 Docker Desktop → Settings → General → ✔️Expose daemon on tcp://localhost:2375（⚠️仅开发环境启用，不用于生产） - CLI path 字段留空通常可自动探测，但如果不行，就填绝对路径：
/usr/bin/docker（Ubuntu）、/opt/homebrew/bin/docker（Apple Silicon macOS）、C:\Program Files\Docker\Docker\resources\bin\docker.exe（Windows）
运行 Dockerfile 时容器启动失败却无提示
WebStorm 点击 Run Dockerfile 后看似“没反应”，其实是容器启动后立刻退出了——比如 nginx 容器因配置错误崩溃、node 容器因入口命令缺失挂掉，WebStorm 默认不展示容器日志。
- 打开
Services工具窗口（Alt+8），展开Docker → Containers，看有没有刚创建但状态是Exited (1)的容器 - 右键该容器 →
Logs，重点看最后一行：是不是nginx: [emerg] invalid number of arguments in "root" directive或npm run dev: command not found - 如果是 nginx 静态服务，确保
nginx.conf里root指向容器内路径（如/usr/share/nginx/html），不是你本地的./dist - 如果是 node 开发服务，
Dockerfile的CMD必须带--host 0.0.0.0（否则只监听 localhost，WebStorm 映射的端口收不到请求）
端口映射成功但浏览器打不开页面
容器日志显示 listening on 0.0.0.0:3000，WebStorm 运行配置也加了 3000:3000，但 http://localhost:3000 仍是连接拒绝或 404——问题往往出在宿主机网络层或容器内部路径。
- 确认端口没被占：
lsof -i :3000（macOS/Linux）或netstat -ano | findstr :3000（Windows） - 防火墙是否放行：Linux 上
sudo ufw allow 3000；macOS 系统偏好设置 → 防火墙 → 高级 → 允许传入连接中勾选docker相关进程 - 容器内服务是否真在监听 0.0.0.0：进容器执行
netstat -tuln | grep 3000，如果只看到127.0.0.1:3000，说明服务绑定错了 - 静态文件路径错位：比如
volumes挂载写成./src:/app/src，但实际构建产物在./dist，结果 nginx 找不到 index.html
最常被忽略的一点：WebStorm 的 Docker 运行配置一旦创建，后续修改 Port mappings 或 volumes 并不会自动更新已运行的容器——必须删掉旧容器、重新运行配置，或者手动 docker stop && docker rm 再 docker run。别指望点一下 “Rerun” 就生效。
