提示
Victron 帮助中心
CAD 在线设计免费
Node-RED

如何在 Cerbo GX 上启用 Node-RED

从将 GX 固件切换为 Venus OS Large 到首次打开编辑器,以及建议立即设置的项目:密码、流程备份和预留空间。依据 Victron 手册“Venus OS Large image: Signal K and Node-RED”。

所需条件

  • 运行 Venus OS Large 的 GX 设备——Cerbo GX、Cerbo-S GX、Ekrano GX、Venus GX、Octo GX、MultiPlus-II GX 或 EasySolar-II GX。Color Control GX 和 CanVU GX 不支持 Venus OS Large。性能比较参见:本栏目首页的系统要求。
  • GX 可连接互联网——用于通过更新菜单下载 Venus OS Large,以及安装附加节点。
  • 同一网络中的计算机——Node-RED 编辑器在浏览器中打开。

准备工作:Cerbo GX、MultiPlus-II GX 和 EasySolar-II GX 无需额外准备。Venus GX 必须先安装并运行 v2.73 或更新版本,然后再安装 Venus OS Large,以建立 Venus OS Large 所需的闪存分区。

安装 Venus OS Large

  1. 更新。请将 GX 更新至最新版本:Settings → General → Firmware → Online updates(较早版本为 Settings → Firmware → Online updates)。
  2. 选择“Large”镜像类型。在同一菜单中将 Image type 设为“Large”,返回上一级,检查是否有新版本并安装。下载时间取决于网络连接,随后 GX 会重启,安装本身通常约需 2 分钟。
  3. 检查。重启后,Settings 菜单的集成设置中应显示 Venus OS Large 设置,表明镜像已正确安装。
  4. 启用 Node-RED。在集成设置中启用 Node-RED。启用和禁用 Node-RED 及 Signal K 需要安装人员访问权限。

后续更新方式不变,仍可在线或离线更新。Image type 设置决定更新哪种镜像。

首次打开编辑器

  • 地址:https://venus.local:1881。如果无法访问,请将 venus.local 替换为 GX 设备在局域网中的 IP 地址,例如 https://192.168.178.224:1881。如何查找 IP 地址,请参阅 GX 设备手册中关于局域网 Remote Console 的章节。
  • 浏览器警告——GX 上的 Node-RED 使用自签名证书建立加密连接,因此浏览器会提示“您的连接不是私密连接”。请点击“高级”或“详细信息”后继续访问。这样,用户名和密码就不会以明文在网络中传输。
  • 旧 http 地址与端口 1880——切换到 https 后,地址必须以 https 开头,端口为 1881。使用旧方式连接会出现 ERR_EMPTY_RESPONSE 错误。如需为仅支持 http 连接的节点额外监听端口 1880,可在用户设置文件中启用,参见仪表板与最佳实践。
  • 通过 VRM 访问——也可通过 VRM 门户中的 Venus OS Large 菜单远程访问编辑器。运行速度可能较慢,取决于连接质量。

编辑器密码

Venus OS 版本Node-RED 的密码保护方式
v3.50 及更新版本使用安全配置文件密码(Settings → General → Security Profile),即为“weak”或“secured”配置文件设置的密码。用户名:admin。
早于 v3.50使用 Remote Console 密码(如果已设置)。用户名:admin。

安全模式与重启

您可以在 GX 菜单中以安全模式(safe mode)启用 Node-RED:Node-RED 会启动,但不会运行流程。此时可打开编辑器并修正流程,而不会触发任何操作;只有部署更改(Deploy)后,流程才会运行。当某个流程导致 GX 处理器负载过高或引发其他问题时,可用此方式恢复。

重启 Node-RED:在 Venus OS Large Features → Node-RED 菜单中先禁用,再重新启用。

流程备份

  • 导出:编辑器菜单 → Export →“all flows”,将 flows.json 文件保存到计算机。手册建议定期导出,并在每次更新 GX 固件前额外备份一次。
  • 恢复:在新安装的系统中,通过 Import 导入同一文件。如果流程使用了节点面板中尚未安装的节点,编辑器会提示;您需要先安装这些节点。
  • 导出不包含的内容:Node-RED 本身的配置,保存在 /data/home/nodered/.node-red/ 目录中的 .config.*.json 文件内。
  • 备份整个数据分区与重置:将 venus-data-00-backup-data-partition.tgz 文件放在 U 盘上,可将整个 /data 分区复制到 U 盘;venus-data-20-node-red-reset.tgz 则会删除 /data/home/nodered/ 中的文件,让您从零开始配置 Node-RED。将 U 盘插入 GX 后重启设备;完成时会发出三声提示音(MultiPlus-II GX 会在显示屏上显示消息)。

数据分区空间

附加节点安装在 GX 的数据分区中,因此更新 Venus OS 后仍会保留。该分区必须始终保留至少 30 MB 可用空间。当可用空间低于 5% 时,GX 会发出 #46 Data partition full 警告;准确数值可在 Settings → General → Modifications 菜单中查看。分区已满时,Node-RED 可能完全无法启动,Venus OS 也会无法正常运行。

Victron 节点面板是 Venus OS Large 的组成部分,只能随其一起更新。如果网上已有更新版节点面板,但 Venus OS Large 尚未包含该版本,手册建议等待;新版 Venus OS Large 通常会在节点面板更新后不久发布。节点面板内容:Victron 节点。第一个可运行的流程:按电池荷电状态控制继电器。

不提供 Victron 技术支持

对于使用 Node-RED 实现高级功能的系统,Victron 不提供技术支持。可在 Victron Community 的“Modifications”版块使用 Node-RED 标签寻求帮助。

适用设备

资料来源

内容已与 Victron Energy 文档(数据表和说明书)核对,截至 2026年9月22日。报告内容错误 · 修订记录