用 vscode 的 dev containers 功能 + 自定义 dockerfile 更可靠，因其自动挂载源码、复用 node_modules、原生支持断点调试，并避免本地 node 版本污染；而 docker run + remote ssh 存在 node_modules 重复安装、调试器无法自动 attach、路径映射不一致三大硬伤。
Dockerfile，比手动 docker run 或插件管理容器更可靠，尤其对 Node 项目——它能自动挂载源码、复用 node_modules、支持断点调试，且避免本地 Node 版本污染。
为什么不用 docker run + VSCode Remote SSH？
常见误区是起个裸容器再连 SSH。这会遇到三个硬伤：
• node_modules 每次重建都重装，耗时且易出错（比如 native addon 编译失败）
• VSCode 的调试器无法自动 attach 到进程，得手动配 launch.json 并暴露端口
• 工作区路径映射不一致，Git 和 ESLint 常报路径不存在
devcontainer.json 必须配的 4 个字段
放在项目根目录的 .devcontainer/devcontainer.json 里，这些不是可选：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
-
"build": { "dockerfile": "Dockerfile" }—— 必须指向你写的构建文件，不能只写镜像名 -
"workspaceFolder": "/workspace"—— VSCode 默认挂载点，所有相对路径（如require('./src')）都基于此 -
"customizations": { "vscode": { "extensions": ["esbenp.prettier-vscode"] } }—— 扩展在容器内安装，不是本地；不写这个，插件不会生效 -
"remoteUser": "node"—— 镜像里必须存在该用户，否则权限错误（npm install写入失败、git提交报 Permission denied）
Dockerfile 里 Node 相关的坑怎么绕开
Node.js 官方镜像默认用 root 用户，但 Dev Containers 强制要求非 root 用户运行。直接 USER node 会触发 npm 权限错误，因为全局 node_modules 是 root 写的。正确解法：
- 用
FROM node:20-bookworm（别用-slim，缺python3和build-essential，canvas类 native 模块编译不过） - 加
RUN mkdir -p /home/node/.npm && chown -R node:node /home/node/.npm - 加
USER node之前，先WORKDIR /workspace并COPY --chown=node:node package*.json . - 不要在
Dockerfile里跑npm install—— 改用postCreateCommand在容器启动后执行，这样能复用本地node_modules（如果已存在）或按需安装
调试时 localhost:3000 访问不到？检查这三点
Node 服务起来但浏览器打不开，90% 是网络或配置问题：
- 确认
devcontainer.json有"forwardPorts": [3000]—— 不是ports字段，Dev Containers 不认 Docker 原生端口映射 - Node 启动命令必须绑定
0.0.0.0:3000，不是localhost:3000（容器内localhost指自己，不是宿主机） - 如果用了
nodemon，确保package.json的scripts是"dev": "nodemon --host 0.0.0.0 server.js"，否则重启后监听地址会重置
postCreateCommand 的执行时机和用户上下文——它在 USER node 之后运行，但环境变量（比如 NODE_ENV）默认不继承，需要显式写进 devcontainer.json 的 "remoteEnv" 里。不然 npm run dev 可能走错配置分支。
