localhost在容器中只指向自身，因网络命名空间隔离；跨主机调用需用目标容器的IP+端口，且其须监听0.0.0.0、开放防火墙、配置正确服务发现与路径映射。
跨主机调试时 localhost 为什么连不到其他容器
因为每个容器的 localhost 只指向自己，不是宿主机，更不是远程机器上的另一个容器。你在本地 VSCode 里 debug 一个跑在远程服务器 A 上的 api 容器，它想调用服务器 B 上的 auth 容器，http://localhost:3001 根本不经过网络路由，直接失败。
真实链路是：本地 VSCode → 远程服务器 A 的 api 容器 → 服务器 B 的 auth 容器。中间这一步必须显式走公网或内网 IP + 端口，不能靠服务发现或 Docker 内网 DNS。
- 服务器 B 的
auth容器必须监听0.0.0.0:3001（不是127.0.0.1:3001） - 服务器 B 的防火墙要放行
3001端口（如ufw allow 3001） -
api容器代码里请求地址得写死成http://:3001/xxx，别用环境变量 alias 欺骗自己 - 如果用了 TLS，证书 CN 必须匹配服务器 B 的公网域名或 IP，否则 Node.js 的
https.request会拒绝连接
devcontainer.json 的 service 名必须和 docker-compose.yml 严格一致
VSCode 不解析 container_name 或 aliases，只认 docker-compose.yml 里 services 下的原始键名，且大小写敏感。写错一个字母，VSCode 就 fallback 到本地构建，根本不会连上远程容器。
比如 docker-compose.yml 是：
services:
auth:
image: my-auth:latest
container_name: auth-service
那 .devcontainer/devcontainer.json 里必须写：
"service": "auth"
不能写 "service": "auth-service"，也不能写 "service": "AUTH"。另外，如果 compose 文件不在项目根目录（比如在 ./infra/docker-compose.yml），必须显式声明：
"dockerComposeFile": "./infra/docker-compose.yml"
Node 进程必须是 PID 1 且监听 0.0.0.0:9229
VSCode 调试器 attach 前会检查容器是否“就绪”，其中关键两条：进程树里 PID 1 是 node，且 netstat -tuln | grep 9229 输出含 0.0.0.0:9229。漏掉任一，断点就不命中，日志也无报错提示。
- Dockerfile 启动命令别用
CMD ["npm", "run", "dev"]—— npm 在某些版本下 fork 子进程后让父进程 exit，PID 1 变成/bin/sh - 改成
CMD ["sh", "-c", "exec npm run debug"]，并在package.json加脚本："debug": "node --inspect=0.0.0.0:9229 server.js" - 验证方式：进容器执行
ps -o pid,comm -A | head -5，第一行 PID 对应的 comm 必须是node；再执行netstat -tuln | grep 9229，确认有0.0.0.0:9229
launch.json 的 port 和 address 容易配反
很多人以为 "address": "localhost" 是指容器里的 localhost，其实它指宿主机（也就是你本地电脑）的 localhost。而 "port": 9229 必须和你运行容器时 -p 映射的宿主机端口完全一致。
例如你在远程服务器 A 上运行：
docker run -p 9230:9229 my-api-image
那 launch.json 就得写：
"address": "localhost", "port": 9230
而不是 9229。同时，sourceFileMap 或 pathMappings 必须精确一对一映射，比如容器里报错显示 /workspace/server.js:12，你就得写 "remoteRoot": "/workspace"，不能多一个 / 或少一个层级。
跨主机场景下最常被忽略的是路径映射失效——本地代码改了，容器里跑的还是旧文件，断点自然不触发。务必确认 docker-compose.yml 的 volumes 挂载路径和 devcontainer.json 的 remoteRoot 完全对齐。
