必须用 docker exec 而非 attach 进入容器,因 attach 直接附着主进程,exit 会终止容器;exec 启动新进程,退出不影响容器运行,且需加 -it 参数并指定用户,极简镜像用 sh 替代 bash。

能直接 attach 进去,但必须满足三个硬性条件:容器内 Node 启用了 --inspect 且监听 0.0.0.0、宿主机端口正确映射、launch.json 中的路径映射(localRoot/remoteRoot)完全匹配。
node --inspect 必须绑定 0.0.0.0,不能是 localhost
这是最常被忽略的点。Node 默认用 --inspect 时监听 127.0.0.1:9229,容器内 localhost 指向的是容器自身回环,宿主机根本连不上。
- 错误写法:
CMD ["node", "--inspect", "server.js"]→ 实际监听127.0.0.1:9229 - 正确写法:
CMD ["node", "--inspect=0.0.0.0:9229", "server.js"]→ 允许外部连接 - 如果用
--inspect-brk,同样要加地址:--inspect-brk=0.0.0.0:9229 - 验证方式:进容器执行
netstat -tuln | grep 9229,看到0.0.0.0:9229才算对
docker run 必须显式映射调试端口,且不能只靠 EXPOSE
EXPOSE 只是文档声明,不触发端口映射;VSCode 调试器从宿主机发起连接,必须靠 -p 把容器端口暴露到宿主机。
- 必须加:
-p 9229:9229(或自定义端口如-p 3001:9229) - 如果应用本身也占端口(如 Express 的 3000),要一并映射:
-p 3000:3000 -p 9229:9229 - 别用
network_mode: host:虽然能绕过端口映射,但会丢失网络隔离,且在 macOS/Windows 上 Docker Desktop 不完全兼容 host 网络 - 挂载源码卷(如
-v ${PWD}:/app)不是必须的,但没它就无法命中断点——因为 VSCode 找不到对应源码位置
launch.json 的 attach 配置必须匹配容器运行时状态
配置错一个字段,VSCode 就会显示 “Cannot connect to runtime process” 或静默失败。
当代理需要在设计或调试工作流时结构化访问 n8n 节点、属性、操作和模板示例时,请使用 n8n-MCP,而不是通过原始文档猜测或手动点击 n8n UI。
-
"type": "node"和"request": "attach"缺一不可 -
"port"必须和容器内--inspect=0.0.0.0:XXXX的端口号一致(默认 9229) -
"address": "localhost"是对的——VSCode 连的是宿主机 localhost,再由 Docker 转发到容器 -
"localRoot"指你本地项目根目录(如"${workspaceFolder}") -
"remoteRoot"指容器内代码所在路径(如"/app"),必须和-v挂载路径终点完全一致 - 示例片段:
{ "type": "node", "request": "attach", "name": "Attach to Docker", "port": 9229, "address": "localhost", "localRoot": "${workspaceFolder}", "remoteRoot": "/app" }
断点不生效?先检查 source map 和构建路径
即使 attach 成功,断点变为空心红圈,说明 VSCode 找不到源码对应关系——这通常不是 Docker 问题,而是构建产物没带 source map 或路径错位。
- 用 TypeScript 或 Webpack?确保生成了
.map文件,并且sourceRoot指向正确(比如"sourceRoot": "../src") - 如果用
tsc --outDir dist,remoteRoot应该是/app/dist,而localRoot对应${workspaceFolder}/dist,否则断点无法绑定 - Express/Koa 等框架中,路由处理函数里的断点容易跳过,优先在
app.listen()后或async函数首行设断点 - 启动容器后,先在浏览器或 curl 访问一次接口,确认 Node 进程真正在跑、调试端口已就绪,再点 VSCode 的 attach 按钮
真正卡住的地方往往不在 Dockerfile 或 docker run 命令里,而在 remoteRoot 和实际挂载路径之间差了一个 /,或者 --inspect 后少写了 =0.0.0.0:9229 —— 这些细节不报错,但会让整个调试链路彻底失效。










