Node-RED 用可视化节点和连线组织事件驱动流程,适合把 HTTP API、MQTT、数据库、设备、定时任务和自定义 JavaScript 串成一条可观察、可重复部署的自动化链路。它既能跑在个人电脑和树莓派上,也能通过 Docker 部署到服务器。

Node-RED 官方项目图标
Node-RED 使用浏览器编辑器编排事件驱动流程。

适合处理什么

  • 定时请求 API,清洗返回值后写入数据库、文件或消息队列。
  • 连接 MQTT、串口、GPIO 与 Webhook,快速搭建设备和服务联动。
  • 用 Inject、Change、Function、Switch、Debug 等节点拼装可视化流程。
  • 把流程保存为 JSON,便于备份、迁移和代码审查。

环境与依赖

  • 当前稳定版:4.1.10。
  • 平台:Windows、macOS、Linux、Raspberry Pi、Docker。
  • 依赖:本地安装需要受支持的 Node.js 与 npm;容器方式需要 Docker。
  • 许可:Apache License 2.0。

五分钟验证

已经安装 Node.js 的环境可执行:

npm install -g node-red
node-red
  1. 浏览器打开 http://127.0.0.1:1880/
  2. 从左侧拖入一个 Inject 节点和一个 Debug 节点,并把两者连起来。
  3. 点击右上角 Deploy,再点击 Inject 节点左侧按钮。
  4. 右侧 Debug 面板出现时间戳或消息对象,即说明运行时、编辑器和基础流程都正常。

Docker 用户可先用官方快速命令验证,并用命名卷保留流程:

docker run -it -p 1880:1880 -v node_red_data:/data --name mynodered nodered/node-red

隐私与安全

流程文件和运行配置默认位于 Node-RED 的用户目录,具体数据是否离开本机取决于流程中连接的 API、数据库、MQTT 或其他外部服务。不要把未配置认证的编辑器直接暴露到公网;对外部署时应按官方安全指南启用账号认证、HTTPS、反向代理和最小权限,并妥善保护流程中的凭据。

资源入口

打开 Node-RED 官方本地安装文档

查看 Node-RED 4.1.10 官方发布说明

核验日期:2026-07-15