IntelliJ IDEA中Docker插件需先启用或安装：Community版须手动从Marketplace安装并重启，Ultimate版默认捆绑但可能被禁用，应通过Ctrl+Alt+S→Plugins→Installed中勾选Docker；启用后Services窗口（Alt+8）才显示Docker节点。
插件没启用或根本不存在？先确认 Docker 插件状态
IntelliJ IDEA Community Edition 默认不带 Docker 插件，Ultimate 版本虽默认捆绑但可能被手动禁用。如果 Services 工具窗口里看不到 Docker 图标，或 Run → Edit Configurations… 里没有 Docker 分类，就说明插件没生效。
检查路径：按 Ctrl+Alt+S（Windows/Linux）或 Cmd+, （macOS）→ Plugins → 切换到 Installed 标签页 → 搜索 Docker → 确保复选框已勾选。若列表中无此插件，需切换到 Marketplace 标签页安装。
- Community 版用户必须手动安装，安装后需重启 IDE
- Ultimate 用户若发现插件消失，可能是误点了
Disable，重新勾选即可 - 插件启用后，
View → Tool Windows → Services或快捷键Alt+8才会显示 Docker 节点
Docker 连接失败：Unix socket、TCP 还是 Docker Desktop？
插件启用后，Services 窗口里 Docker 节点显示红色叉号或 “Connection failed”，说明 IDE 没连上本地 Docker 守护进程。这不是网络问题，而是连接方式配置错误。
常见配置组合：
- macOS / Linux 使用 Docker Desktop：选
Docker for Mac或Docker for Linux，无需改路径 - Linux 命令行装的 Docker（非 Desktop）：选
Unix socket，路径填unix:///var/run/docker.sock - rootless 模式（常见于新版 Linux）：路径得改成类似
unix:///run/user/1000/docker.sock，UID 要和当前登录用户一致 - 远程 Docker 主机：选
TCP socket，URL 填tcp://xxx.xxx.xxx.xxx:2375（注意：Docker daemon 必须显式开启 TCP 监听，且通常需 TLS 认证）
验证是否连通：终端执行 docker version 成功，不代表 IDE 就能连——IDE 用的是独立配置，不是复用 CLI 的上下文。
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
从 Dockerfile 启动容器总卡在 build 阶段？上下文路径和标签名是关键
右键点击项目里的 Dockerfile → Run Dockerfile，结果构建失败或找不到 target/*.jar，大概率是上下文（build context）设错了。
Dockerfile 中的 COPY、ADD 指令都基于上下文根目录解析路径，IDEA 默认把 Dockerfile 所在目录当上下文，但多数 Java 项目需要把整个项目根目录（含 target/ 或 build/）作为上下文。
- 创建运行配置时，在
Context folder字段明确指定项目根路径，比如$ProjectFileDir$ -
Image tag别留空，否则默认为latest，容易因缓存导致旧镜像被重复使用 - 如果
Dockerfile里写了COPY target/app.jar /app.jar，确保构建前已执行过mvn package或gradle build - 构建日志卡在
Sending build context to Docker daemon？说明上下文目录过大（如含node_modules、.git），建议加.dockerignore
容器跑起来了却连不上应用？端口映射和启动命令要对齐
容器在 Services 里显示 “Up”，但浏览器访问 localhost:8080 无响应，问题常出在两处：端口没暴露，或应用根本没监听。
IDEA 的 Docker 运行配置里，Ports 设置只是声明容器端口映射关系，不等于应用自身监听了该端口。比如 Spring Boot 默认监听 8080，但若 application.yml 改成了 server.port: 9000，而你只映射了 8080:8080，那必然连不通。
- 检查容器日志：
Services → Docker → Containers → 右键容器 → Logs，确认应用是否成功启动、监听哪个端口 - 端口映射格式写成
8080:8080（主机:容器），不要漏冒号 - Java 应用若用
ENTRYPOINT ["java", "-jar", "app.jar"]，确保 jar 包内嵌 Web 容器（如 Tomcat）已启用 - 容器 IP 不是
localhost—— 映射到主机端口后，一律用localhost访问，不用查容器 IP
最易被忽略的一点：Docker Desktop 在 macOS 和 Windows 上实际运行在 Linux VM 里，localhost 指向的是该 VM，不是宿主机本身；但端口映射机制已自动处理这层转发，只要映射正确，localhost 就是对的——别去查容器 IP 或尝试 172.17.0.x。
