Node-RED 5.0.4: почему не стоит ставить 5.0.2 или 5.0.3 и что проверить перед обновлением

Почему за один день вышли Node-RED 5.0.2, 5.0.3 и 5.0.4

Утром 30 июля вышла версия 5.0.2. В ней обновили библиотеку JSONata и добавили очистку сообщений сессионных ошибок перед отображением в редакторе.

После обнаружения изменения поведения JSONata разработчики выпустили 5.0.3 и попытались вернуть предыдущую версию библиотеки. Затем выяснилось, что откат выполнен недостаточно далеко. Через несколько минут вышла 5.0.4 с дополнительным откатом JSONata.

Что именно могло измениться в работе потоков

JSONata используется в Change, Switch и других узлах для преобразования сообщений, фильтрации данных и вычислений. Регрессия затрагивала создаваемые JSONata объекты: они могли возвращаться с нулевым прототипом вместо обычного прототипа JavaScript Object.

[Object: null prototype] { a: 1, b: 2 }

Такой объект выглядит почти как обычный, но у него может отсутствовать метод hasOwnProperty(). Если следующий Function node, пользовательский node или библиотека вызывает этот метод напрямую, поток способен завершиться ошибкой:

TypeError: result.hasOwnProperty is not a function

Какие потоки проверить в первую очередь

• Change nodes с выражениями JSONata, которые формируют новый объект;
• Function nodes, расположенные сразу после JSONata-преобразования;
• потоки, где проверяется obj.hasOwnProperty(...);
• сторонние nodes, получающие объект из Change или Switch;
• формирование JSON для HTTP API, MQTT и баз данных;
• шаблоны, где результат JSONata передаётся в пользовательский JavaScript;
• обработку Modbus-регистров и телеметрии, собираемой в объект.

Как сделать Function node устойчивее

Вместо прямого вызова метода объекта безопаснее использовать вызов через прототип:

Object.prototype.hasOwnProperty.call(obj, "property")

Это полезная общая практика, но она не отменяет обновление Node-RED. Исправлять все функции только ради временной регрессии не требуется, если логика была корректной до обновления.

Node-RED 5 не запускается на Node.js 20

Node-RED 5.0 требует Node.js 22.9.0 или новее. Проект рекомендует Node.js 24, и официальные Docker-образы ветки 5 основаны именно на Node.js 24.

Проверить среду можно командами:

node --version
node-red --version
npm --version

Что изменилось для старых Raspberry Pi

Официальные образы Node.js 24 больше не выпускаются для 32-битной архитектуры ARMv7. Поэтому старые установки на 32-битной системе могут не перейти на Node-RED 5 без обновления операционной системы или замены оборудования.

Разные установки обновляются по-разному

Что сохранить, чтобы восстановить Node-RED

1. Весь пользовательский каталог. Обычно это ~/.node-red или каталог /data внутри контейнера и дополнения.
2. Файл потоков. Например, flows.json или файл с именем хоста.
3. Файл credentials. Храните его вместе с соответствующим файлом потоков и значением credentialSecret.
4. settings.js. В нём могут находиться авторизация, HTTPS, ключ шифрования, пути и пользовательские функции.
5. package.json и package-lock.json. Они фиксируют установленные сторонние nodes и зависимости.
6. Экспорт важных flows. Дополнительная JSON-копия удобна для быстрого просмотра и частичного восстановления.
7. Версии. Node-RED, Node.js, npm, Docker-образ, дополнение и сторонние nodes.
8. Переменные окружения. MQTT, базы данных, API, TLS и пути к сертификатам.
9. Проекты и Git. Проверьте незакоммиченные изменения, ветку и доступ к удалённому репозиторию.
10. Способ отката. Предыдущий Docker-тег, snapshot LXC, backup Home Assistant или резервная копия сервера.

Как обновлять Node-RED на разных платформах

Home Assistant Add-on

Создайте полную резервную копию Home Assistant и отдельный экспорт критичных потоков. Обновляйте дополнение через его страницу. Node.js находится внутри образа дополнения, поэтому устанавливать Node.js в Home Assistant OS вручную не нужно.

Docker и Docker Compose

Убедитесь, что каталог /data подключён к постоянному тому. Зафиксируйте предыдущий тег образа, скачайте новый образ 5.0.4 или более новый и пересоздайте контейнер. Не используйте latest, если нужен понятный откат.

Raspberry Pi и Debian

Проверьте Node.js и архитектуру ОС. Официальный скрипт установки поддерживает выбор актуальной Node.js, но перед запуском нужно изучить его параметры и сохранить каталог .node-red. После обновления проверьте, какой бинарный файл Node.js использует systemd.

Wiren Board

Node-RED не должен становиться единственной точкой отказа критичных сценариев. Перед обновлением остановите экспериментальные потоки, сохраните данные и проверьте совместимость выбранного способа установки с Debian и штатными пакетами контроллера. Критичную защиту котла, насоса и электрики нельзя переносить только в Node-RED.

Proxmox LXC или виртуальная машина

Создайте snapshot, затем обновите Node.js и Node-RED внутри гостевой системы. Отдельно проверьте сеть, DNS, MQTT, Modbus TCP и последовательные порты.

Какие потоки нужно протестировать вручную

Проверяйте не только Deploy

Успешный запуск редактора и отсутствие красных узлов не доказывают правильную работу автоматики. Нужно физически проверить свет, реле, котёл, клапан, вентиляцию, ворота или другое оборудование в безопасном режиме.

Что полезного появилось в Node-RED 5

Эти функции делают переход полезным, но не требуют обновлять производственную систему без тестов. Надёжность потоков и совместимость nodes важнее нового оформления редактора.

Как откатиться, если Node-RED 5 не запускается

1. Остановите Node-RED. Не выполняйте повторные Deploy и автоматическую установку nodes.
2. Сохраните журнал ошибки. Он поможет отличить Node.js, JSONata, npm и несовместимый node.
3. Верните предыдущую среду. Docker-тег, snapshot, backup дополнения или версию пакета.
4. Восстановите пользовательский каталог. Потоки, credentials, settings и package files должны соответствовать сохранённому состоянию.
5. Проверьте credentialSecret. Без него сохранённые credentials могут не расшифроваться.
6. Установите зависимости. Используйте package-lock и совместимые версии nodes.
7. Запустите без Deploy. Сначала изучите журнал и состояние узлов.
8. Проверьте критичные сценарии. Только после этого возвращайте автоматический режим.

Что не стоит делать

• обновлять до 5.0.2 или 5.0.3 вместо 5.0.4 и более новой версии;
• обновлять Node-RED 5 на Node.js 20;
• сохранять только экспорт flows без credentials и settings.js;
• использовать плавающий Docker-тег без записи предыдущей версии;
• обновлять все palette nodes одной кнопкой одновременно с Node-RED;
• удалять неизвестные узлы до сохранения списка пакетов;
• обновлять основной контроллер удалённо без человека на объекте;
• переносить критичные защиты только в визуальный поток;
• открывать редактор Node-RED напрямую в интернет;
• публиковать flows и credentials в открытом доступе.

Что полезно изучить перед обновлением

Подробнее: Wiren Board для умного дома, Home Assistant в частном доме, домашний сервер и умный дом, монтаж и настройка умного дома в Туле.

Стоит ли обновляться до Node-RED 5.0.4

Да, если система готова к Node.js 22.9 или новее и проверена совместимость сторонних nodes. Версия 5.0.4 предпочтительнее 5.0.2 и 5.0.3, поскольку содержит более полный откат проблемного изменения JSONata.

Для работающего дома, котельной или коммерческого объекта обновление нужно проводить с резервной копией, тестовым окном и ручным управлением. Особенно внимательно проверяются JSONata, Function nodes, MQTT, Modbus и сценарии, управляющие реальным оборудованием.

Безопасный порядок: backup, проверка Node.js, обновление Node-RED, запуск без массового обновления палитры, тест потоков, затем обновление сторонних nodes по одному.