必须使用attach模式连接本地映射端口，Node.js容器需启用--inspect=0.0.0.0:9229，Kubernetes YAML中声明containerPort，配合kubectl port-forward，并在launch.json中配置type为pwa-node、request为attach、port为9229、host为localhost。

直接能用，但必须手动暴露调试端口、配好 port-forward 规则、且 launch.json 里不能用 launch 模式——得切到 attach 模式连本地映射端口。

Node.js 容器必须启用 --inspect 参数并监听 0.0.0.0

默认 node --inspect 只绑定 127.0.0.1，容器内无法被转发流量访问。不改就永远连不上。

• 在 Pod 的 container 启动命令中显式加 --inspect=0.0.0.0:9229（不是 --inspect-brk，除非你真要启动即断）
• 确保容器镜像里 Node.js 版本 ≥ v8.0.0（旧版不支持远程 attach）
• YAML 中必须通过 ports 声明该端口，否则 Kubernetes 不允许 kubectl port-forward 绑定：

  ports:
  - containerPort: 9229
    protocol: TCP

kubectl port-forward 和 VSCode 端口转发别混用

VS Code Kubernetes 插件的 “Forward Port” 功能底层调的就是 kubectl port-forward，但它只对当前 Pod 生效、不持久、关插件就断。而你如果已在终端手动执行过 kubectl port-forward pod/name 9229:9229，VS Code 再点一次会报错 “address already in use”。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 推荐统一用命令行方式：保持一个终端常驻运行 kubectl port-forward，更可控
• 不要在 VS Code 里右键 Pod → Forward Port 同时又在终端跑同一条命令
• 若要用插件转发，先确认没其他进程占着本地 9229 端口：lsof -i :9229（macOS/Linux）或 netstat -ano | findstr :9229（Windows）

launch.json 必须配置为 attach 模式且 host 设为 localhost

launch 模式会尝试在本地起 Node 进程，完全无效；attach 才是连远端调试器的正确姿势。而且 host 不能写成 0.0.0.0 或容器 IP——它连的是你本地被转发后的端口。

• 关键字段必须是："request": "attach"、"port": 9229、"host": "localhost"
• 完整最小配置示例：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "type": "pwa-node",
        "request": "attach",
        "name": "Attach to Kubernetes Node",
        "port": 9229,
        "host": "localhost",
        "skipFiles": ["<node_internals>/**"],
        "trace": true
      }
    ]
  }

• 如果断点不命中，打开 "trace": true 查看 VS Code 调试器日志，常见原因是源码路径映射不一致（localRoot/remoteRoot 在 attach 场景下通常不需要设，除非你用的是编译后代码）

Minikube / Kind 环境下容易忽略的网络权限问题

本地单节点集群（如 Minikube、Kind）默认运行在虚拟机或容器中，--inspect=0.0.0.0:9229 虽然绑定了所有接口，但宿主机防火墙或虚拟网卡策略可能拦截入向连接。

• Minikube 用户：执行 minikube ssh -- sudo iptables -P INPUT ACCEPT 临时放行（仅开发用，勿用于正式环境）
• Kind 用户：检查 kind 集群的 extraPortMappings 是否把 9229 映射进来了（默认不映射）
• 无论哪种，都建议先在容器内用 curl http://localhost:9229/json 验证 Delve/Node 调试服务是否真的在响应——这是最靠前的验证点

真正卡住的地方往往不是配置写错，而是容器没真正监听 0.0.0.0，或者 kubectl port-forward 进程意外退出没人发现，又或者 launch.json 里手滑选成了 launch 模式。每次连不上，按顺序查这三处，90% 的问题当场解决。