Express是最直接的Node.js Web框架选择，需初始化package.json、安装express、启用express.json()和express.urlencoded()中间件以支持JSON数据，再通过app.listen()启动服务。

express 是最直接的选择，不用纠结框架选型。Node 原生 http 模块也能跑，但路由、JSON 解析、错误处理都得手写，实际项目里没人这么干。

创建项目并初始化 package.json

别跳过这步——不是仪式感，是后续所有依赖和脚本的基础。

• 在 VSCode 中新建文件夹（比如叫 my-api），右键 → “在终端中打开”
• 运行 npm init -y，生成最小可用的 package.json
• 检查生成的 package.json 里是否有 "type": "commonjs" 字段；没有就手动加上，避免 import 报错（Node 默认不支持 ES 模块）

安装并使用 express 快速启动服务

express 不是黑盒，它本质就是一个函数：调用 express() 返回一个 app 对象，你往上面挂路由、中间件，最后用 app.listen() 启动。

Rydberg Agent Node

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

下载

• 执行 npm install express（不用加 --save，npm 7+ 默认保存到 dependencies）
• 新建 server.js，写入基础代码：

  const express = require('express');
  const app = express();
  const PORT = 3000;
  
  app.get('/', (req, res) => {
    res.send('Hello, API is running');
  });
  
  app.listen(PORT, () => {
    console.log(`Server listening on http://localhost:${PORT}`);
  });

• 终端运行 node server.js，浏览器访问 http://localhost:3000 就能看见响应

让 API 能接收和返回 JSON 数据

前端发 POST 请求带 JSON body？默认情况下 express 会把 body 当作原始字符串，req.body 是 undefined——这是新手最常卡住的地方。

• 必须显式启用两个中间件：express.json() 和 express.urlencoded({ extended: true })
• 它们要放在所有路由定义之前，顺序不能错
• 示例：

  app.use(express.json());
  app.use(express.urlencoded({ extended: true }));
  
  app.post('/user', (req, res) => {
    console.log(req.body); // 现在能正确拿到 { name: 'Alice', age: 25 }
    res.json({ success: true, data: req.body });
  });

调试时别忽略端口冲突和控制台输出

VSCode 终端里反复看到 EADDRINUSE 错误？或者改了代码没反应？多半是旧进程没关干净。

• 每次修改 server.js 后，先按 Ctrl+C 停掉正在运行的 node 进程，再重新 node server.js
• 不要靠刷新浏览器判断是否生效——看终端有没有打印 Server listening on... 这行日志
• 如果想自动重启，临时装个 nodemon：npm install -D nodemon，然后用 npx nodemon server.js 替代 node

真正容易被忽略的是：Node 的模块系统默认走 CommonJS，require/module.exports 是安全路径；一旦你尝试用 import，就得配 "type": "module" 并处理 __dirname 缺失等问题——第一版 API，绕开它。