Node-RED 入门

最近更新:

介绍

Node-RED 是一款开源的流程式开发工具，可用于连接设备、API 和在线服务。通过浏览器中的编辑器，用户可以拖放并连接节点，构建数据处理与自动化流程，适合物联网及工业边缘应用。

本教程介绍如何在 reComputer RK 系列设备上安装 Node-RED、完成初始配置、打开 Web 编辑器，并部署一个简单的测试流程。

硬件与软件要求

项目要求
边缘设备reComputer RK 系列设备
操作系统64 位 Debian 系 Linux，例如 Debian 或 Armbian
网络安装时可访问互联网；客户端可通过局域网访问设备
访问方式具有 sudo 权限的终端或 SSH 账户
客户端一台运行现代浏览器的电脑

步骤 1：连接 reComputer RK 设备

通过终端或 SSH 连接设备，例如：

bash
ssh seeed@<DEVICE_IP>

将 <DEVICE_IP> 替换为设备的 IP 地址。如果登录用户名不是 seeed，请替换为实际用户名。

检查系统架构和 Linux 发行版：

bash
uname -m
cat /etc/os-release

64 位 RK 系统的架构应显示为 aarch64。

步骤 2：安装 Node-RED

安装官方脚本所需的软件包：

bash
sudo apt update
sudo apt install -y curl git build-essential ca-certificates

运行 Node-RED 官方 Debian 安装脚本：

bash
bash <(curl -fsSL https://github.com/node-red/linux-installers/releases/latest/download/install-update-nodered-deb) --node22 --skip-pi

--node22 用于安装 Node.js 22，--skip-pi 用于跳过 RK 系列不需要的 Raspberry Pi 专用节点。脚本会安装 Node-RED 并配置系统服务。

请使用具有 sudo 权限的普通 Linux 用户执行这条命令，不要在整条命令前添加 sudo。按提示确认安装，并完成屏幕上的操作。

步骤 3：完成初始配置

首次安装时，按照出现的 Node-RED 设置初始化提示完成配置。如果此前跳过了初始化，且尚未生成设置文件，可使用安装 Node-RED 时的同一用户执行：

bash
node-red admin init

Node-RED 设置初始化界面

配置保存在 Node-RED 用户目录中。对于名为 seeed 的 Linux 用户，默认路径为：

text
/home/seeed/.node-red/settings.js

请在可信网络中使用编辑器，不要将 1880 端口直接暴露到公网。此处配置的管理员密码用于登录 Web 编辑器。

步骤 4：验证安装并启动 Node-RED

检查已安装的版本：

bash
node -v
npm -v
node-red --version

启动 Node-RED 服务：

bash
node-red-start

这条命令会启动后台服务并持续显示日志。按 Ctrl+C 可退出日志查看，服务仍会在后台运行。

退出日志查看后，可在当前终端或另一个终端中确认服务状态：

bash
sudo systemctl status nodered.service --no-pager

服务应显示 active (running)。

启用开机自动启动：

bash
sudo systemctl enable nodered.service

步骤 5：访问 Node-RED Web 编辑器

查看 reComputer RK 设备的 IP 地址：

bash
hostname -I

在同一网络中的电脑上打开：

text
http://<DEVICE_IP>:1880

Node-RED 默认使用 1880 端口。如果在初始化时启用了用户安全设置，请使用刚创建的账户登录。

进入流程编辑器后，左侧为节点面板，中间为工作区，右侧为侧栏面板。

Node-RED 流程编辑器

步骤 6：创建并运行第一个流程

使用内置的 Inject 和 Debug 节点创建一个简单流程。

  1. 在左侧节点面板中找到 inject 节点，并将其拖入工作区。

  2. 双击 Inject 节点，将 msg.payload 类型设为 string，内容设为 Hello from reComputer RK Series!，然后点击 Done。

    设置 Inject 节点的消息内容

  3. 将一个 debug 节点拖入工作区。

  4. 将 Inject 节点的输出端连接到 Debug 节点的输入端。

  5. 点击右上角 Deploy，部署流程。

  6. 打开 Debug messages 侧栏，点击 Inject 节点左侧的小按钮。

Debug 侧栏应显示：

text
Hello from reComputer RK Series!

Inject 连接 Debug 后输出测试消息

这表示 Node-RED 编辑器已经能够在 RK 设备上部署并执行流程。

步骤 7：常用 Node-RED 服务命令

操作命令
启动 Node-REDnode-red-start
停止 Node-REDnode-red-stop
重启 Node-REDnode-red-restart
查看日志node-red-log
检查服务状态sudo systemctl status nodered.service --no-pager
启用开机启动sudo systemctl enable nodered.service

小结

至此，已完成 reComputer RK 系列设备上的 Node-RED 安装、编辑器配置、后台服务启用及简单流程部署。后续可基于 Node-RED 扩展 MQTT、Modbus TCP 等边缘物联网应用。

参考资料