Cerbo GX 上的 Node-RED
无需编写代码即可实现 Victron 系统自动化:按电池状态或时间控制继电器,在浏览器中创建自定义仪表板,让非 Victron 设备显示在 GX 和 VRM 中。所有功能均在运行 Venus OS Large 的 GX 设备上执行。

像 PLC 一样使用功能块编程
Node-RED 是一种通过浏览器编辑器连接设备、网络服务和数据的工具:通过组合现成的功能块(节点)构建“流程”,而不是编写代码。Victron 为其提供了一套专用节点,可读取连接到 GX 的设备测量值并控制这些设备。Victron 手册给出的示例是:结合温度测量值与时间条件控制继电器。
- 继电器控制 — 根据任意条件控制 GX、较大型 MPPT 控制器、RS 设备或电池监控器的继电器。
- 定时任务 — 例如在固定时间开启和关闭逆变充电器,或在夜间电池电量低时启动发电机(编辑器内置示例)。
- 虚拟设备 — 第三方传感器、电表或开关可像 Victron 设备一样显示在 GX 和 VRM 中。
- 仪表板 — 包含图表、指示器和开关的自定义面板,可在本地浏览器中访问,也可通过 VRM 远程访问。

支持哪些设备
Node-RED 是 Venus OS Large 的一部分。Venus OS Large 是 GX 设备软件的扩展版本,增加了 Node-RED 和 Signal K 服务器。安装时需在更新菜单中更改镜像类型,具体步骤见首次启动文章。
Node-RED 和 Signal K 会占用较多 GX 设备处理器及内存资源,具体负荷取决于流程。内存不足或处理器过载时,设备最终会重启,可能导致整个系统运行不稳定。在受支持设备中速度最慢的 Venus GX 上,同时运行 Signal K 和 Node-RED 很可能造成过载。
| GX 设备 | Venus OS Large |
|---|---|
| Ekrano GX | 支持 — 处理器最快 |
| MultiPlus-II GX, EasySolar-II GX | 支持 — 处理器最快 |
| Cerbo GX | 支持 — 处理器速度第二 |
| Cerbo-S GX, Octo GX | 是 |
| Venus GX | 支持 — 处理器最慢 |
| Color Control GX, CanVU GX | 否 |
依据 Venus OS Large 手册(截至 2026年9月22日)。Venus OS Large 也支持部分 Raspberry Pi 型号。
Node-RED 是 Venus OS Large 中稳定运行的组成部分,已用于数万个系统,但 Victron 不为使用它实现高级方案的系统提供技术支持。您可在 Victron Community 的“Modifications”版块提问,并添加 Node-RED 标签。
手册建议定期将全部流程导出为 flows.json 文件,并在更新 GX 软件前额外备份一次,详情见首次启动。
文章

Node-RED 流程生成器
请您描述系统需要执行的操作,助手会进一步询问细节,并生成可导入 Node-RED 的 JSON 文件。
打开
如何在 Cerbo GX 上启用 Node-RED
Venus OS Large、启用 Node-RED、编辑器地址、密码、安全模式及流程备份。
打开
Node-RED 中的 Victron 节点
Victron 节点库包含哪些内容:输入与控制节点、D-Bus 路径、继电器、虚拟设备、通知和事件。
打开
按电池荷电状态控制 Cerbo GX 继电器
Battery → 滞回 → Relay:通过电池荷电状态控制 Cerbo GX 继电器。提供分步说明和可直接导入的流程。
打开
仪表板、VRM 访问与实用建议
Dashboard 2.0 分步教程,通过 VRM 远程访问编辑器和仪表板,获取 VRM API 数据,以及如何避免耗尽 GX 内存。
打开