Docker镜像配Node环境是为解决本地Node版本冲突、依赖隔离和团队环境一致三大痛点；推荐node:18-alpine或node:20-alpine镜像，挂载需配-v和-w确保路径一致，调试须配置--inspect和sourceMapPathOverrides。

直接用 Docker 镜像配 Node 环境，不是为了“看起来高级”，而是为了解决「本地 Node 版本冲突」「依赖隔离」「团队环境一致」这三类真实痛点。只要镜像选对、挂载写准、调试打通，比手动装 Node + npm 全局配置更稳。

选哪个 Node 镜像？别直接拉 node:latest

官方 node:latest 实际指向的是当前最新稳定版（比如 20.x），但 CI/CD 或协作时容易因版本漂移导致 npm install 失败或 require() 报错。LTS 版本才是生产友好选择。

• 开发阶段推荐 node:18-alpine 或 node:20-alpine：体积小、启动快，alpine 基础镜像不含完整 bash，但够跑 npm 和 node
• 避免用 node:slim：虽然比 full 轻，但缺 curl、git 等常用工具，后续装私有包或调试时容易卡住
• 如果项目依赖 Python 或 C++ 插件（如 bcrypt），必须用 node:18（非 alpine）：alpine 的 musl libc 和 glibc 不兼容，编译会失败

docker run 启动容器时，-v 和 -w 怎么配才不丢文件？

常见错误是只挂载代码目录，却没指定工作目录，结果 npm install 装到容器根目录，重启容器就没了；或者挂载路径写错，VSCode 里改的文件根本没同步进容器。

Rydberg Agent Node

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

下载

• 挂载命令必须带 -v $PWD:/home/app（macOS/Linux）或 -v %cd%:/home/app（Windows CMD），确保本地当前目录映射到容器内固定路径
• 务必加 -w /home/app，让所有命令（npm install、node server.js）都在挂载点下执行
• 不要用 /app 作挂载目标：某些基础镜像（如 node:alpine）默认 USER node，而 /app 权限可能不允许写入，/home/app 更稳妥
• 如果用 VSCode Remote-Containers，挂载逻辑由 devcontainer.json 控制，此时要检查 "mounts" 字段是否覆盖了 "workspaceFolder"

VSCode 调试容器内 Node 进程，为什么断点不生效？

断点不命中，90% 是源码映射（source map）没对上，而不是 Docker 配置错了。容器里跑的代码路径和本地路径不一致，VSCode 就找不到对应行。

• 启动 Node 时必须加 --inspect=0.0.0.0:9229（不是 localhost:9229），否则调试器连不上容器内端口
• launch.json 中 "sourceMapPathOverrides" 得显式声明路径映射，例如：

  {
    "sourceMapPathOverrides": {
      "/home/app/*": "${workspaceFolder}/*"
    }
  }

• 确保 package.json 的 "scripts": { "dev": "node --inspect=0.0.0.0:9229 server.js" }，而不是靠 nodemon 自动加 —— 某些版本的 nodemon 会忽略 --inspect
• 如果用 Dockerfile 构建镜像，COPY 指令后别加 RUN npm install 再 COPY . .，会导致 node_modules 在镜像层里，但源码在挂载卷里，路径错位

真正麻烦的从来不是写几行 Dockerfile，而是当 node_modules 里某个包突然 require 失败、npm install 在容器里卡住不动、或者 VSCode 断点标红却不触发——这些时刻，你得知道该看容器日志、查挂载权限、还是翻 sourceMapPathOverrides 的键值对。动手前先确认镜像 tag、挂载路径、调试端口三者是否闭环，比事后 debug 快得多。