Node-RED 5 для Home Assistant и умного дома: что изменилось и как обновиться без поломки автоматизаций
Node-RED 5.0 стал крупнейшим обновлением редактора за историю проекта. Новый интерфейс, улучшенная отладка, дополнительные возможности Function и Delay nodes, изменения TLS и авторизации полезны для домашней автоматизации, но перед обновлением есть важное ограничение: Node-RED 5 требует Node.js 22.9 или новее, а разработчики рекомендуют Node.js 24.
Что такое Node-RED и зачем он нужен в умном доме
Node-RED представляет собой low-code платформу для событийной автоматизации. Логика собирается из узлов на визуальном поле: один узел получает событие, другой проверяет условие, третий изменяет данные, четвёртый отправляет команду устройству.
В Home Assistant Node-RED обычно используют не вместо самой платформы, а как дополнительный движок сложных сценариев. Он удобен, когда автоматизация содержит много условий, таймеров, ветвлений, MQTT-сообщений, HTTP-запросов или взаимодействует сразу с несколькими системами.
При этом переносить в Node-RED абсолютно все автоматизации нет необходимости. Простая логика Home Assistant часто понятнее и легче обслуживается штатными средствами.
Что нового в Node-RED 5.0
Разработчики называют Node-RED 5 крупнейшим изменением пользовательского интерфейса редактора за всю историю проекта. Обновление затрагивает не только внешний вид, но и отладку, работу отдельных nodes, TLS, авторизацию и базовую программную платформу.
Новый интерфейс
Переработанные боковые панели, лучшее использование пространства, встроенная тёмная тема и улучшения доступности.
Удобнее Debug
Вывод Debug теперь можно приостанавливать, что полезно при интенсивных потоках датчиков и MQTT.
Function + Link
Function node получил возможность программно вызывать Link Call node через node.linkCall().
Delay burst mode
Новый режим ограничения потока позволяет пропускать сообщения пачкой до заданного лимита.
TLS
Добавлена работа с PFX/P12, загрузка сертификатов из переменных окружения и настройка TLS SNI для HTTP Request.
Авторизация
Изменена OAuth-схема и ужесточены стандартные правила доступа к административному интерфейсу.
Новый редактор: изменение заметнее, чем кажется
В старых версиях большая часть служебных панелей находилась справа и переключалась через меню. В Node-RED 5 обе стороны редактора получили более гибкую систему панелей. Панели можно перемещать и одновременно показывать две, разделив область по вертикали.
Для реальной автоматизации это удобно: например, оставить Debug постоянно открытым снизу, а сверху одновременно смотреть информацию об узле или структуру flow.
Также появилась встроенная тёмная тема, обновлено выделение элементов, pan/zoom и отображение документации nodes непосредственно в редакторе.
Какие изменения Node-RED 5 полезны именно для умного дома
Пауза Debug
При диагностике датчика мощности, счётчика Modbus или MQTT-шины сообщения могут поступать несколько раз в секунду. Раньше Debug быстро заполнялся новыми событиями. Теперь поток вывода можно остановить и спокойно изучить нужное сообщение.
Link nodes из Function
Link nodes позволяют связывать части проекта без длинных визуальных проводов между вкладками. В Node-RED 5 Function node может вызывать Link Call программно. Это даёт больше возможностей для повторно используемой логики.
Delay в режиме burst
Режим полезен там, где события разрешено пропускать до определённого лимита, а после его достижения нужно ждать следующего интервала. Например, при ограничении частоты запросов к API или внешнему устройству.
Документация узлов
На больших инсталляциях часто используются сторонние nodes. Более доступная документация непосредственно в интерфейсе снижает вероятность ошибочной настройки входов, выходов и параметров.
Главное перед обновлением: Node-RED 5 требует новый Node.js
Это важнее большинства визуальных изменений. Если Node-RED установлен давно на Raspberry Pi, Debian, Ubuntu или отдельном сервере, сначала необходимо проверить версию Node.js.
node --version
node-red --versionЕсли после обновления Node.js используются сторонние nodes с бинарными зависимостями, разработчики Node-RED предупреждают о возможной необходимости пересборки зависимостей командой npm rebuild в соответствующих каталогах.
Что изменилось для старых Raspberry Pi
Официальные Docker-образы Node-RED 5 на Node.js 24 доступны для AMD64 и ARM64. Проект отдельно указывает на прекращение официальной поддержки старых 32-битных ARM-платформ в таком варианте, поскольку Node.js больше не предоставляет необходимые arm/v7 контейнеры.
Поэтому обновление старого Raspberry Pi нельзя выполнять вслепую. Сначала нужно проверить архитектуру ОС и процессора, текущую версию Node.js и способ установки Node-RED.
Как безопасно обновить Node-RED 4.x до 5.x
- 1
Сделайте резервную копию
Сохраните flows, credentials,
settings.js,package.jsonи каталог пользовательских данных Node-RED. Для контейнера отдельно сохраните persistent volume. - 2
Запишите текущие версии
Node-RED, Node.js, npm, Home Assistant nodes и критичные сторонние пакеты.
- 3
Проверьте сторонние nodes
Особое внимание пакетам, которые давно не обновлялись. Major-релиз Node-RED и смена Node.js могут выявить старые зависимости.
- 4
Проверьте Node.js
Для Node-RED 5 требуется как минимум 22.9.0. Предпочтительный вариант для новой установки — поддерживаемая Node.js 24.
- 5
Не обновляйте критичный дом перед отъездом
После major upgrade должно оставаться время проверить свет, отопление, протечки, ворота и другие сценарии в реальных условиях.
- 6
Проверяйте flows по группам
Не ограничивайтесь тем, что редактор открылся. Проверьте входные события, таймеры, MQTT, Home Assistant, Modbus/API и исполнительные команды.
Node-RED 5 и Home Assistant
Сам Node-RED не становится частью Home Assistant автоматически. Связь обычно обеспечивает набор интеграционных nodes, через которые flow получает состояния сущностей, события и вызывает сервисы Home Assistant.
Поэтому при переходе на Node-RED 5 проверять нужно сразу три уровня: Node-RED, версию Node.js и совместимость установленного набора Home Assistant nodes.
Node-RED особенно полезен как интеграционный слой. Например, он может получить состояние из Home Assistant, данные счётчика через MQTT, проверить тариф и мощность, а затем сформировать команду для другого сервиса.
Стоит ли переносить всю автоматику Home Assistant в Node-RED
Нет. Хорошая архитектура не определяется количеством flows. Логику следует размещать там, где она проще, надёжнее и понятнее обслуживается.
| Задача | Где логичнее |
|---|---|
| Простое включение света по датчику | Home Assistant automation |
| Сложная цепочка условий и таймеров | Node-RED может быть удобнее |
| Интеграция нескольких API/MQTT-систем | Node-RED |
| Аварийная защита котла или нагревателя | Независимая штатная автоматика |
| Защита кабельной линии | Автомат, УЗО/дифавтомат и другие аппараты по проекту, не программный flow |
| Критичная защита от протечки | Предпочтительно локальная логика, способная работать без облака и пользовательского интерфейса |
Что изменилось в безопасности
В Node-RED 5 расширены TLS-настройки. Сертификаты и ключи можно получать из PFX/P12-файлов или переменных окружения, а HTTP Request получил возможность задавать TLS SNI server name. Это полезно для интеграций с внутренними HTTPS-сервисами и инфраструктурой, где используются собственные сертификаты.
Также разработчики усилили административную авторизацию: OAuth использует token-exchange подход, а стандартные admin CORS rules были убраны.
- не публикуйте редактор Node-RED напрямую в интернет;
- защитите административный интерфейс авторизацией;
- не храните API-токены непосредственно в Function nodes без необходимости;
- разделяйте пользовательскую и IoT-инфраструктуру там, где это оправдано;
- сохраняйте резервную копию flows и credentials вне самого сервера.
Node-RED 4.x ещё можно использовать?
Да, но ветка 4.x после выхода Node-RED 5 переведена в режим сопровождения. Согласно опубликованному плану проекта, для неё предусматриваются исправления ошибок и безопасности, а окончание жизненного цикла запланировано на 31 декабря 2026 года.
Это означает, что срочно обновлять рабочую систему в день релиза не требуется. Но для долгоживущей инсталляции уже стоит планировать переход на 5.x и современную версию Node.js.
Частые вопросы
Нужно ли обновлять Node-RED 4 до 5 прямо сейчас?
Нет. Сначала проверьте Node.js, архитектуру оборудования, сторонние nodes и резервную копию. Для рабочего умного дома контролируемое обновление важнее скорости перехода на новую major-версию.
Какая версия Node.js нужна для Node-RED 5?
Для Node-RED 5.0 минимально требуется Node.js 22.9.0. Проект рекомендует Node.js 24 для ветки 5.x.
Будет ли Node-RED 5 работать на Raspberry Pi?
На современных 64-битных Raspberry Pi — да при подходящей ОС и Node.js. Со старыми 32-битными ARM-системами ситуация сложнее: официальные Node-RED Docker images на Node.js 24 ограничены AMD64 и ARM64.
Node-RED лучше автоматизаций Home Assistant?
Не вообще, а для определённых задач. Node-RED удобен для сложных визуальных потоков и интеграционной логики. Простые автоматизации часто лучше оставить в Home Assistant.
Можно ли использовать Node-RED без Home Assistant?
Да. Node-RED является самостоятельной платформой и может работать с MQTT, HTTP, TCP, Modbus и множеством других систем.
Стоит ли переходить на Node-RED 5
Для новой установки разумно сразу ориентироваться на актуальную ветку Node-RED 5 и Node.js 24. Для существующей домашней автоматизации переход тоже оправдан, но только после проверки совместимости.
Главное изменение для владельца умного дома находится не в тёмной теме и новом интерфейсе, а под капотом: Node-RED перешёл на современную платформу Node.js, а старые ARM-системы и давно не обновлявшиеся сторонние nodes требуют отдельной проверки.
Если текущая система управляет отоплением, светом, водой или другим реальным оборудованием, major update следует воспринимать как техническое обслуживание инженерной системы: резервная копия, проверка зависимостей, тестирование и только затем ввод обновлённой версии в постоянную эксплуатацию.