Node-RED w Home Assistant: zaawansowane automatyzacje wizualnie krok po kroku

Czym jest Node-RED i dlaczego warto go połączyć z Home Assistant

Node-RED to wizualne narzędzie do budowania automatyzacji, w którym zamiast pisać kod, łączysz ze sobą bloki zwane węzłami. Każdy węzeł robi jedną rzecz: odbiera stan czujnika, sprawdza warunek, wysyła powiadomienie albo wywołuje akcję w innym systemie. Cała logika powstaje na płótnie w przeglądarce, a gotowy scenariusz możesz uruchomić, zatrzymać i podejrzeć na żywo.

Home Assistant ma własny silnik automatyzacji i dla większości codziennych zadań wystarcza. Gdy jednak scenariusz rozrasta się do kilkunastu warunków, pętli i opóźnień, edytor YAML zaczyna przeszkadzać. Node-RED porządkuje taką logikę w formie grafu, który łatwiej ogarnąć wzrokiem niż kilkaset linii tekstu. Do tego dochodzi debugowanie: podglądasz dane na każdym etapie przepływu, zamiast zgadywać, gdzie warunek się wysypał.

Połączenie obu narzędzi działa w obie strony. Node-RED widzi wszystkie encje Home Assistanta przez wbudowaną integrację, odczytuje ich stany i wysyła do nich komendy. Home Assistant może też wywołać przepływ Node-RED jako akcję, więc oba systemy uzupełniają się bez konfliktów.

Uważam, że Node-RED warto włączać dopiero wtedy, gdy proste automatyzacje przestają wystarczać. Dla włączania światła o zachodzie słońca nie ma sensu dokładać kolejnej warstwy, ale przy harmonogramach nawadniania, scenariuszach z wieloma czujnikami i logice opartej na wielu warunkach równoległych graf wygrywa z listą akcji w YAML. Trzeba tylko pamiętać, że Node-RED to dodatkowa usługa, którą trzeba aktualizować i utrzymywać. Nie zawsze.

Instalacja Node-RED w Home Assistant – dodatek, integracja i pierwsza konfiguracja

Najprostsza droga prowadzi przez oficjalny sklep dodatków. W Home Assistant wystarczy wejść w Ustawienia → Dodatki → Sklep dodatków, wyszukać Node-RED i kliknąć Instaluj. Dodatek sam ciągnie obraz kontenera, zakłada katalog danych i podłącza się do magistrali HA.

Zanim uruchomisz Node-RED, ustaw hasło do panelu i sprawdź zakładkę sieci. Domyślny port to 1880. Jeśli korzystasz z dostępu zdalnego przez Nabu Casa albo reverse proxy, włącz opcję require_ssl dopiero po skonfigurowaniu certyfikatu. Inaczej panel przestanie odpowiadać.

Po instalacji dodaj integrację Node-RED Companion. To ona odpowiada za mostek w drugą stronę: encje, sensory i przyciski tworzone w Node-RED pojawiają się w Home Assistant jak zwykłe urządzenia. Bez niej przepływy działają, ale nie widać ich efektów w dashboardzie.

Ostatni krok to pierwszy przepływ. W panelu Node-RED przeciągnij węzeł events: state, ustaw encję czujnika ruchu i podłącz go do call service z usługą light.turn_on. Wystarczy wkleić token API w konfiguracji węzła server. Kliknięcie Deploy i test.

Brzmi prosto. Pierwsza konfiguracja zwykle zajmuje kilkanaście minut, więcej czasu schodzi na ogarnięcie tokenów i uprawnień niż na samo kliknięcie instalacji.

Podstawy pracy w edytorze Node-RED: flow, węzły i debugowanie

Edytor Node-RED otwierasz z panelu dodatku w Home Assistant i od razu widzisz płótno robocze. Na nim budujesz flow, czyli graficzny ciąg połączeń między węzłami. Każdy węzeł robi jedną rzecz: odbiera stan encji, przekształca dane, wysyła komendę albo czeka na zdarzenie.

Połączenia rysujesz przeciągając linię od wyjścia jednego węzła do wejścia kolejnego. Węzeł inject uruchamia przepływ ręcznie lub cyklicznie, call service wywołuje akcję w Home Assistant, a events: state nasłuchuje zmian. Trzy typy węzłów wystarczą, żeby zbudować pierwszą sensowną automatyzację.

Debugowanie zaczynasz od węzła debug podpiętego pod wyjście podejrzanego miejsca. Ustaw go na pełny obiekt, nie tylko na msg.payload, bo wtedy widzisz też metadane i kontekst. Panel debug pokazuje czas, typ wiadomości i ścieżkę, którą przeszła.

Brzmi prosto. Najczęstszy błąd to pomylenie formatu payloadu: czujnik zwraca tekst, a węzeł oczekuje liczby. Warto wtedy dołożyć change albo function i sprawdzić typ przed wywołaniem akcji. Dla porządku: przepływy zapisujesz w plikach konfiguracyjnych dodatku, więc kopia zapasowa obejmuje je razem z resztą Home Assistant.

Zaawansowane automatyzacje: harmonogramy, warunki i integracja z encjami Home Assistant

Harmonogram w Node-RED nie musi oznaczać sztywnego „o 7:00 włącz światło”. Dużo lepsze efekty daje połączenie wyzwalacza czasowego z warunkami opartymi na stanach encji. Wystarczy węzeł inject z powtarzaniem, węzeł get entities albo current state i gałąź switch, która przepuszcza przepływ tylko wtedy, gdy warunki są spełnione. Całość działa lokalnie, bez chmury producenta.

Kluczowa jest kolejność sprawdzania. Najpierw tanie warunki, potem drogie zapytania do API. Odwrotna kolejność potrafi zamulić bramkę przy kilkudziesięciu encjach odpytywanych co minutę.

Integracja z encjami to najczęstsze miejsce, gdzie przepływy się rozjeżdżają. Nazwy encji zmieniają się po restarcie integracji, a węzeł dalej szuka starej. Ustawiam entity_id na sztywno z listy wybranej z HA i unikam budowania nazw dynamicznie ze stringów. Prostsze, stabilniejsze.

Przykład czysto hipotetyczny: harmonogram ma wieczorem przyciemnić światło w salonie, ale tylko gdy telewizor jest włączony i nikt nie śpi. Trzy warunki w jednym przepływie, każdy osobno testowalny. Gdy coś nie działa, od razu widać który.

Lepiej trzymać logikę w Node-RED niż w wielu automatyzacjach HA, bo widać cały przepływ na jednym ekranie i łatwiej go debugować. Minus jest jeden: trzeba pilnować backupu plików przepływów, bo awaria SD w Raspberry Pi potrafi zabrać całą pracę.

Praktyczne przykłady flow krok po kroku: oświetlenie, powiadomienia i scenariusze obecności

Zaczynamy od najprostszego przypadku, który pokazuje sens Node-RED w praktyce: sterowanie światłem na podstawie zmierzchu i ruchu. Węzeł poll-state odpytuje encję czujnika natężenia światła co kilka minut, funkcja porównuje wartość z progiem, a wyjście trafia do call-service z domeną light i akcją turn_on. Cała logika mieści się w trzech węzłach. Efekt? Światło włącza się tylko wtedy, gdy jest ciemno i ktoś faktycznie jest w pomieszczeniu.

Powiadomienia wymagają nieco więcej uwagi. Zamiast wysyłać alert przy każdym zdarzeniu, wstaw węzeł delay z trybem rate-limit, żeby uniknąć lawiny wiadomości. Warto dodać warunek sprawdzający, czy domownicy są w domu. Inaczej telefon milczy, gdy akurat siedzisz na kanapie obok czujnika.

• Węzeł events: state nasłuchuje zmiany stanu wybranej encji i przekazuje dane dalej.
• Węzeł switch rozgałęzia przepływ na podstawie wartości lub atrybutu, np. czy drzwi są otwarte.
• Węzeł template buduje treść powiadomienia z danych dynamicznych, takich jak nazwa czujnika i godzina.
• Węzeł trigger z opóźnieniem resetuje stan po określonym czasie, przydatny przy scenariuszach obecności.
• Węzeł function pozwala zapisać własną logikę w JavaScript, gdy gotowe węzły nie wystarczają.

Scenariusze obecności to miejsce, gdzie Node-RED pokazuje przewagę nad prostymi automatyzacjami z panelu. Zamiast jednej reguły „ktoś wszedł, zapal światło" budujesz sekwencję: czujnik ruchu, potwierdzenie przez czujnik drzwi, odczekanie kilku sekund i dopiero decyzja. Takie podejście działa lepiej niż gotowe integracje wykrywania obecności, ponieważ pełną kontrolę nad warunkami masz w jednym miejscu i widzisz cały przepływ na ekranie. Łatwiej też wyłapać fałszywe alarmy.

Hipotetycznie: ktoś wchodzi do przedpokoju, ale czujnik drzwi jeszcze nie zdążył zgłosić otwarcia. Flow z krótkim opóźnieniem i warunkiem krzyżowym poradzi sobie z tym bez fałszywego zapalenia światła o trzeciej w nocy. Brzmi prosto. W praktyce wymaga przetestowania progów.

Najczęściej zadawane pytania (FAQ)

Czy Node-RED to dobry wybór na start z automatyzacjami? Zależy od tego, ile chcesz się nauczyć. Jeśli wystarczą Ci proste reguły „jeśli to, wtedy tamto”, wbudowany edytor automatyzacji w Home Assistant będzie szybszy i czytelniejszy. Node-RED zaczyna wygrywać, gdy pojawiają się rozgałęzienia, opóźnienia, kilka warunków naraz i chęć podejrzenia przepływu danych w jednym miejscu.

Czy Node-RED działa bez internetu? Tak, o ile cała logika i integracje są lokalne. Add-on działa na Twoim serwerze, a przepływy zapisują się w plikach konfiguracyjnych. To jego największa zaleta: gdy chmura producenta padnie, automatyzacje dalej działają, bo nie mają z nią nic wspólnego. Musisz tylko pilnować, żeby węzły nie odpytywały zewnętrznych API.

Kilka kwestii wraca najczęściej przy pierwszym kontakcie z dodatkiem:

• Czy Node-RED zastępuje automatyzacje Home Assistant? Nie, oba mechanizmy działają równolegle i mogą się uzupełniać.
• Gdzie zapisują się przepływy? W katalogu konfiguracyjnym dodatku, więc warto objąć go kopią zapasową.
• Czy potrzebuję osobnego serwera? Zwykle nie, add-on wystarcza na typowym sprzęcie do Home Assistant.
• Jak testować przepływ bez psucia automatyzacji? Użyj węzła inject z ręcznym wyzwalaniem i podglądu w panelu debug.
• Czy aktualizacje mogą zepsuć przepływ? Mogą, dlatego przed każdą zmianą wersji rób eksport przepływów do pliku.

Jak zacząć bezpiecznie? Od jednego prostego przepływu i obserwacji, co robi. Hipotetycznie: ktoś buduje automatyzację oświetlenia hallu i po tygodniu orientuje się, że część węzłów dubluje reguły z Home Assistant. Wtedy łatwiej wyłączyć jeden fragment niż przebudować całość. Zaczynaj małym krokiem.