Nuki w Home Assistant  kompletny przewodnik po modelach, montażu, Matter, MQTT, Bridge i automatyzacjach

Co dokładnie znajdziesz w tym artykule

Nuki jest jedną z najczęściej wybieranych rodzin inteligentnych zamków w Europie, ale jednocześnie jedną z najłatwiejszych do opisania źle. W zależności od generacji ten sam zamek może komunikować się przez Bluetooth, Wi‑Fi, Thread, Matter, oficjalne MQTT, lokalne API Nuki Bridge albo nieoficjalny Nuki Hub na ESP32. Dwie osoby piszące na forum, że „Nuki działa lokalnie”, mogą więc mówić o zupełnie innych rozwiązaniach, z innym zestawem encji, innym opóźnieniem, innym wpływem na baterię i innym zachowaniem po awarii internetu.

Ten poradnik nie jest rankingiem opartym na karcie produktu. Prowadzi od mechaniki drzwi do gotowej integracji w Home Assistant. Wyjaśnia również problemy powtarzające się w anglojęzycznych społecznościach: brak funkcji cofnięcia zapadki przez Matter, błędnie zbudowaną sieć Thread, zbyt daleko ustawiony Bridge, wolne aktualizacje stanu, rozłączające się MQTT, kłopotliwe współistnienie kilku metod integracji, nieprawidłową kalibrację oraz automatyzacje, które potrafią zaryglować otwarte drzwi albo odryglować je w złym momencie.

Modele Nuki: Go, Pro, Ultra i starsze generacje

W sprzedaży i na rynku wtórnym spotkasz kilka generacji Nuki. Nie należy traktować ich jako jednej rodziny o identycznych możliwościach. Największa granica przebiega między starszymi modelami opartymi głównie na Bluetooth i Bridge, czwartą generacją z Matter over Thread oraz najnowszą generacją Go, Pro i Ultra.

Nuki Smart Lock Go

Go jest podstawowym modelem obecnej generacji. Mechanicznie pozostaje zamkiem nakładanym od wewnętrznej strony drzwi na istniejącą wkładkę i klucz. Obsługuje Matter over Thread, dlatego może pracować lokalnie z Home Assistant bez Nuki Bridge. Wbudowane Wi‑Fi i część usług zdalnych zależą jednak od wariantu oferty lub aktywowanych funkcji. To model dla użytkownika, który chce zachować istniejącą wkładkę i wejść w Matter możliwie niskim kosztem.

Nuki Smart Lock Pro — 5. generacja

Pro to obecnie główny model retrofitowy. Zachowuje istniejącą wkładkę, ma szybszy bezszczotkowy silnik, wbudowany akumulator i łączność Wi‑Fi oraz Matter over Thread. W praktyce daje najwięcej oficjalnych dróg integracji: Matter, oficjalne MQTT i usługi Nuki. Jest dobrym wyborem, gdy chcesz uniknąć osobnego Bridge, ale jednocześnie zależy Ci na elastyczności i zdalnym zarządzaniu.

Nuki Smart Lock Ultra

Ultra jest najmniejszym z obecnych modeli, ale wymaga wymiany wkładki na dostarczany Nuki Universal Cylinder. Nie jest więc klasycznym zamkiem „zakładanym na klucz”. W zamian dostajesz szybszą i zwartą konstrukcję oraz mechanikę przygotowaną jako jeden zestaw. To ważne przy zakupie: Ultra może być lepsze w ciasnym miejscu, ale montaż jest bardziej ingerujący i trzeba prawidłowo zmierzyć grubość drzwi oraz dobrać długość modułów wkładki.

Nuki Smart Lock 4.0 i 4.0 Pro

Czwarta generacja była pierwszą szeroko dostępną rodziną Nuki z Matter over Thread. Model podstawowy opiera się na bateriach i Thread, a Pro ma wbudowany akumulator i Wi‑Fi. Nadal jest sensowny na rynku wtórnym, ale przed zakupem trzeba sprawdzić stan Power Packa, gwarancję, generację oraz to, czy sprzedawca nie myli 4.0 z 3.0 Pro.

Nuki 3.0, 3.0 Pro, 2.0 i 1.0

Starsze modele nadal mogą bardzo dobrze współpracować z Home Assistant, lecz ich głównymi ścieżkami są Nuki Bridge albo Nuki Hub na ESP32. Model 3.0 Pro ma wbudowane Wi‑Fi i oficjalne MQTT, ale wczesne wersje firmware miały agresywną politykę ponownego łączenia z chmurą, co wpływało na lokalne MQTT podczas awarii internetu. Modele 1.0–3.0 bez Pro nie mają Matter i zwykle wymagają Bridge lub lokalnego huba BLE.

Czy Nuki pasuje do Twoich drzwi? Test mechaniczny krok po kroku

Nuki obraca od wewnątrz klucz albo trzpień wkładki. Nie zastępuje całego zamka wpuszczanego, nie naprawia ciężko pracującego mechanizmu i nie podnosi klamki. Zanim zaczniesz analizować Matter i MQTT, wykonaj test mechaniczny.

1. Sprawdź typ wkładki

W typowych polskich drzwiach spotkasz wkładkę europrofilową. Klasyczne modele Nuki montuje się od wewnątrz na kluczu pozostawionym we wkładce albo na kompatybilnej gałce. Ultra wykorzystuje własny modułowy cylinder. Wkładka powinna pracować lekko, bez szarpania, i najlepiej mieć funkcję awaryjną, czyli możliwość otwarcia drugim kluczem od zewnątrz mimo klucza pozostawionego po stronie wewnętrznej.

2. Wykonaj test dwóch kluczy

Włóż klucz od środka, a drugim spróbuj odryglować drzwi od zewnątrz. Jeżeli zewnętrzny klucz nie działa, po montażu klasycznego Nuki możesz stracić najważniejszą awaryjną drogę wejścia. Rozwiązaniem jest wkładka z funkcją awaryjną, kompatybilna gałka albo model Ultra z właściwie skonfigurowanym cylindrem.

3. Oceń, czy drzwi wymagają podnoszenia klamki

W wielu drzwiach wielopunktowych przed przekręceniem klucza trzeba podnieść klamkę. Nuki nie wykona tego ruchu. Zamek może automatycznie obrócić wkładkę dopiero po ręcznym podniesieniu klamki. Jeżeli domownicy o tym zapomną, silnik może zgłosić blokadę lub drzwi pozostaną niezaryglowane mimo wykonanej automatyzacji.

4. Rozróżnij „unlock” i „open door”

Odryglowanie cofa rygle, ale nie zawsze cofa sprężynową zapadkę. Przy drzwiach z nieruchomą gałką lub pochwytem na zewnątrz potrzebujesz funkcji Open door albo unlatch. Zamek obraca wtedy klucz dalej i na krótko cofa zapadkę, aby drzwi dało się popchnąć. Przy błędnym ustawieniu typu klamki aplikacja, Matter lub automatyzacja mogą pokazywać tylko lock/unlock.

5. Sprawdź miejsce na urządzenie

Zmierz odległość między osią wkładki a klamką, szyldem, framugą i ewentualną osłoną. Otwórz drzwi i upewnij się, że korpus nie uderzy w ścianę ani ościeżnicę. W ciasnych drzwiach różnica rozmiaru między Ultra a starszym korpusem bywa decydująca.

6. Usuń opory, zanim uruchomisz kalibrację

Przy otwartych i zamkniętych drzwiach kilka razy przekręć klucz ręcznie. Jeżeli ruch jest cięższy przy domkniętym skrzydle, problemem może być regulacja zawiasów, zaczepów albo uszczelki. Kalibracja wykonana na źle ustawionych drzwiach uczy zamek wysokich oporów i skraca czas pracy baterii.

Którą metodę integracji wybrać?

Nie uruchamiaj wszystkich metod tylko dlatego, że są dostępne. Na początku wybierz jedną główną ścieżkę sterowania i jedną zapasową aplikację producenta. Równoczesne włączenie Matter, oficjalnego MQTT, Bridge, Nuki Hub i kilku platform smart home utrudnia ustalenie, skąd przyszła komenda oraz dlaczego log dostępu oznaczył użytkownika jako MQTT albo Home Assistant.

Metoda 1: Nuki przez Matter over Thread — konfiguracja i diagnostyka

Matter jest obecnie najprostszą oficjalną drogą dla Nuki Go, Pro, Ultra i czwartej generacji. Komendy pozostają lokalne, a Home Assistant klasyfikuje integrację Nuki Matter jako Local Push. Sam napis „Matter” nie oznacza jednak, że telefon komunikuje się bezpośrednio z zamkiem. Nuki używa Matter over Thread, więc potrzebujesz poprawnie działającej sieci Thread i border routera.

Czego potrzebujesz

• Home Assistant OS jest najłatwiejszą i oficjalnie wspieraną ścieżką dla Matter Servera.
• Działający Matter Server oraz aktualna aplikacja Companion na telefonie.
• Thread Border Router: Home Assistant Yellow, Connect ZBT‑1/ZBT‑2 z właściwym firmware, Apple TV/HomePod, Google Nest lub inny zgodny router graniczny.
• IPv6 i multicast/mDNS działające między Home Assistantem, telefonem i border routerem.
• Telefon z Bluetooth podczas procesu dodawania. Bluetooth służy do przekazania urządzeniu danych Thread.

Dodawanie nowego Nuki bezpośrednio do Home Assistant

• Zaktualizuj firmware zamka w aplikacji Nuki.
• W Home Assistant sprawdź Ustawienia → Urządzenia i usługi → Matter oraz Thread.
• W aplikacji Nuki włącz Matter i wyświetl kod lub użyj kodu QR z opakowania.
• W aplikacji Home Assistant wybierz Dodaj urządzenie → Dodaj urządzenie Matter → Jest nowe.
• Zeskanuj kod, pozostań blisko zamka i nie przełączaj sieci Wi‑Fi w trakcie konfiguracji.
• Po dodaniu sprawdź encję lock oraz ewentualne przyciski i sensory. Dopiero później dodawaj zamek do kolejnego ekosystemu.

Udostępnienie Nuki z Apple Home lub Google Home

Urządzenia Matter mogą należeć do kilku fabric, czyli kilku niezależnych ekosystemów. Nie resetuj zamka tylko dlatego, że jest już w Apple Home. W aplikacji pierwszego ekosystemu wybierz udostępnienie lub „Turn on pairing mode”, uzyskaj nowy kod i w Home Assistant wybierz, że urządzenie jest już używane w innym kontrolerze. Kod z pudełka nie zawsze jest ponownie używany do Multi‑Admin.

Problem: Home Assistant nie widzi Thread Border Routera

Najpierw ustal, czy adapter USB pracuje jako Zigbee, czy Thread. Ten sam dongle nie powinien jednocześnie prowadzić produkcyjnej sieci ZHA/Zigbee2MQTT i OTBR, jeśli konfiguracja nie została do tego wyraźnie przygotowana. Sprawdź status dodatku OpenThread Border Router, adresy IPv6 oraz czy w integracji Thread widzisz aktywną sieć i border router.

Problem: commissioning zatrzymuje się na „connecting”

Najczęstsze przyczyny to telefon i Home Assistant w odseparowanych VLAN-ach, filtrowany multicast, brak tras IPv6, błędne poświadczenia preferowanej sieci Thread albo istniejący wpis po nieudanej próbie. Przenieś telefon do tej samej sieci LAN co Home Assistant, wyłącz na chwilę VPN i prywatny DNS, zrestartuj zamek przez wyjęcie baterii lub procedurę producenta, usuń osierocony node z Matter Servera i ponów konfigurację.

Problem: Nuki działa, ale czasem jest unavailable

Thread jest siecią mesh, lecz zamek zasilany bateryjnie nie pełni roli routera. Potrzebuje dobrego zasięgu do stale zasilanego urządzenia Thread lub border routera. Przenieś border router bliżej drzwi albo dodaj zasilany router Thread. Nie zakładaj, że sygnał Wi‑Fi przy drzwiach opisuje jakość Thread — to inne radio i inna sieć.

Problem: nie ma funkcji Open door / unlatch

Najpierw w aplikacji Nuki ustaw właściwy typ drzwi: zewnętrzna gałka lub pochwyt zamiast klamki. Następnie ponownie zsynchronizuj urządzenie lub wykonaj rekonfigurację Matter. Obsługa europejskiego cofnięcia zapadki była rozwijana w standardzie Matter i zależy także od wersji Home Assistant, firmware zamka oraz typu encji. Starsze wątki forum opisujące brak tej funkcji mogą już nie odzwierciedlać najnowszych wersji, ale błędny typ klamki nadal jest realną przyczyną.

Metoda 2: oficjalne MQTT bez Bridge i bez ESP32

Oficjalne MQTT jest często pomijane w poradnikach, choć dla zaawansowanego użytkownika Home Assistant może być najlepszym kompromisem między lokalnością a zakresem danych. Zamek łączy się bezpośrednio z brokerem MQTT w sieci LAN. Nie potrzebujesz Nuki Bridge ani ESP32. Dostępność zależy od modelu i firmware — przede wszystkim od zamków z wbudowaną łącznością IP lub Thread.

Przygotowanie brokera

Najprościej użyć dodatku Mosquitto Broker w Home Assistant OS. Utwórz osobne konto tylko dla zamka, nie używaj konta administratora Home Assistant. Ogranicz dostęp ACL do tematów Nuki, jeżeli broker obsługuje też inne systemy. Broker powinien mieć stały adres IP i działać zawsze, nie tylko wtedy, gdy uruchomiony jest komputer użytkownika.

Konfiguracja w Nuki

• Włącz MQTT w ustawieniach Smart Home zamka.
• Podaj adres IP brokera, port, nazwę użytkownika i silne hasło.
• Włącz Home Assistant Discovery, jeżeli model i firmware udostępniają tę opcję.
• Ustaw unikalny temat bazowy, jeśli masz więcej niż jeden zamek.
• Nie publikuj jawnych kodów Keypada, dopóki nie rozumiesz, gdzie broker zapisuje retained messages i backupy.

Co może pojawić się w Home Assistant

Typowy zestaw obejmuje encję zamka, stan baterii lub ładowania, dostępność, stan drzwi, ostatnią akcję, wynik akcji, tryb nocny oraz dane autoryzacji. Dokładny zestaw zależy od generacji i wersji specyfikacji MQTT. Dwie osoby z „Nuki przez MQTT” mogą widzieć inną liczbę encji, jeżeli jedna korzysta z oficjalnego MQTT, a druga z Nuki Hub.

Problem: zamek traci MQTT przy zablokowanym internecie

W starszych wersjach 3.0 Pro zamek sprawdzał dostępność chmury i przy jej braku odłączał Wi‑Fi, co zrywało również lokalne MQTT. Dokumentacja i forum Nuki opisują różne zachowanie firewalla zależnie od generacji: dla części modeli pakiety na port 443 powinny być porzucane, a dla starszej generacji odrzucane z TCP RESET. Zanim uznasz integrację za wadliwą, zaktualizuj firmware i sprawdź aktualny dokument producenta dla konkretnej generacji.

Problem: encja jest dostępna, ale stan się nie aktualizuje

Sprawdź w narzędziu MQTT, czy zamek publikuje wiadomości po ręcznym przekręceniu. Jeżeli wiadomości dochodzą, problem leży w Discovery lub retained topics — usuń stare wpisy konfiguracyjne po wykonaniu backupu i uruchom Discovery ponownie. Jeżeli wiadomości nie dochodzą, sprawdź połączenie zamka z Wi‑Fi/Thread, log brokera, ACL oraz czas ostatniego połączenia klienta.

Problem: log pokazuje użytkownika „MQTT”

Komenda wysłana z Home Assistant jest wykonywana przez autoryzację MQTT, więc w logu producenta może być przypisana do MQTT, a nie do osoby naciskającej przycisk w HA. Jeżeli potrzebujesz identyfikować użytkowników, twórz osobne skrypty i zapisuj kontekst w Home Assistant albo opieraj się na kodach Keypada i autoryzacjach Nuki.

Metoda 3: Nuki Bridge i lokalne HTTP API

Nuki Bridge pozostaje bardzo dobrą metodą dla Smart Lock 1.0–3.0 oraz instalacji, w których Bridge już działa stabilnie. Home Assistant ma natywną integrację Nuki Bridge, wykrywa urządzenie w LAN i komunikuje się lokalnie przez HTTP API. Komendy nie muszą przechodzić przez chmurę.

Ustawienie Bridge

• Umieść Bridge możliwie blisko zamka. Liczy się Bluetooth między Bridge a zamkiem oraz Wi‑Fi między Bridge a routerem.
• Nadaj Bridge stałą rezerwację DHCP.
• W aplikacji Nuki włącz HTTP API i ustaw token.
• W Home Assistant dodaj integrację Nuki Bridge albo zaakceptuj automatyczne wykrycie.
• Sprawdź odczyt stanu, a potem lock/unlock przy otwartych drzwiach.

Callback kontra polling

Polling oznacza cykliczne pytanie Bridge o stan. Callback pozwala Bridge wysłać zmianę do Home Assistant od razu. Callback daje szybsze automatyzacje i mniej zbędnego odpytywania, ale Bridge obsługuje zwykły lokalny HTTP. Jeżeli wewnętrzny adres Home Assistant wymusza HTTPS, korzysta z Basic Auth, przekierowuje na zewnętrzny URL albo jest odseparowany firewallem, callback może nie zadziałać.

Problem: Bridge odpowiada 503

HTTP 503 zwykle oznacza, że Bridge nie może w danej chwili wykonać operacji Bluetooth na zamku albo jest przeciążony. Nie wysyłaj kilku komend jednocześnie, ogranicz częstotliwość odpytywania, sprawdź odległość Bridge–zamek, uruchom ponownie Bridge i zaktualizuj firmware. W automatyzacjach stosuj tryb single albo queued oraz warunek sprawdzający bieżący stan.

Problem: callback znika lub przestaje działać

Na forum deweloperskim opisywano przypadki usuwania albo zatrzymywania callbacków. Sprawdź listę callbacków w API, usuń stare duplikaty i dodaj poprawny lokalny URL ponownie. Zarezerwuj IP Home Assistanta i nie używaj nazwy hosta, której Bridge nie potrafi rozwiązać. Po zmianie adresu HA callback trzeba zarejestrować ponownie.

Problem: sterowanie działa, ale stan jest opóźniony

To typowy objaw niedziałającego callbacku i polegania na pollingu. Sprawdź log Bridge, dostępność endpointu HA z tej samej podsieci i reguły VLAN. Nie skracaj od razu interwału do kilku sekund, bo zwiększysz obciążenie Bridge oraz komunikację Bluetooth.

Problem: token z Nuki Web nie działa

Integracja Nuki Bridge wymaga tokenu lokalnego HTTP API Bridge, a nie tokenu Nuki Web ani kodu Matter. Nowsze modele Pro i Ultra bez fizycznego Bridge nie udostępniają wbudowanego Bridge HTTP API pod swoim adresem IP. Dla nich wybierz Matter lub oficjalne MQTT.

Metoda 4: Nuki Hub na ESP32 — pełna lokalna integracja przez MQTT

Nuki Hub to otwartoźródłowe firmware dla ESP32. Moduł komunikuje się z zamkiem po Bluetooth, a dane publikuje do MQTT. Daje lokalne sterowanie bez fizycznego Nuki Bridge i zwykle udostępnia więcej informacji niż podstawowe Matter. Jest szczególnie atrakcyjny dla starszych zamków, ale wymaga utrzymania dodatkowego urządzenia i ostrożności przy aktualizacjach.

Sprzęt i rozmieszczenie

Wybierz stabilną płytkę ESP32 z dobrym zasilaczem. Umieść ją kilka metrów od zamka, nie w metalowej rozdzielnicy ani za grubą ścianą. Słaby zasilacz USB powoduje restarty wyglądające jak problem Bluetooth. Jeżeli wybierasz Ethernet/W5500, sprawdź listę wspieranych płytek i wersję firmware.

Pierwsza konfiguracja

• Wgraj oficjalny obraz Nuki Hub zgodnie z instrukcją repozytorium.
• Połącz moduł z Wi‑Fi i nadaj mu rezerwację DHCP.
• Skonfiguruj broker MQTT oraz konto przeznaczone dla Nuki Hub.
• Włącz parowanie w aplikacji Nuki i w panelu Nuki Hub.
• Po udanym parowaniu włącz Home Assistant Discovery.
• Sprawdź encje diagnostyczne: RSSI, heap, uptime, status MQTT, paired i last command result.

Współistnienie z Bridge

Nuki Hub może zostać sparowany jako Bridge lub jako aplikacja. Repozytorium ostrzega, że tryb współistnienia z fizycznym Bridge bywa niekorzystny i wymaga ponownego parowania. Nie zaznaczaj tej opcji mechanicznie. Najpierw zdecyduj, który system ma być główną bramką BLE.

Kody Keypada i autoryzacje

Nuki Hub może publikować informacje o wpisach Keypada, zarządzać kodami, harmonogramami i autoryzacjami. Publikowanie samych kodów jest jednak ryzykiem. Mogą trafić do retained messages, kopii Mosquitto, logów automatyzacji i backupu Home Assistant. W większości domów wystarczy publikować identyfikator oraz nazwę uprawnienia, bez jawnego PIN-u.

Problem: lock state jest undefined po aktualizacji

Nie zakładaj od razu uszkodzenia zamka. Sprawdź changelog i issues konkretnej wersji Nuki Hub, wyczyść retained discovery topics, zrestartuj ESP32 oraz integrację MQTT. Gdy problem pojawił się dokładnie po aktualizacji, bezpieczniej wrócić do poprzedniej wersji niż wielokrotnie usuwać parowanie zamka.

Problem: „send encrypted message failed”

To zwykle problem warstwy BLE: za duża odległość, zakłócenia, jednoczesne połączenie aplikacji lub Bridge, przeciążenie modułu albo regresja firmware. Przenieś ESP32 bliżej, wyłącz na próbę inne aktywne połączenia, sprawdź RSSI i zasilanie, a następnie porównaj z poprzednim wydaniem firmware.

Problem: Nuki Hub jest online, ale encja unavailable

Rozdziel trzy warstwy: Wi‑Fi/Ethernet ESP32, MQTT i Bluetooth do zamka. Panel Nuki Hub może być dostępny, mimo że MQTT jest odłączone; MQTT może działać, mimo że zamek nie jest sparowany. Sprawdź status każdej warstwy osobno, log brokera i ostatnią wiadomość availability.

Tryb hybrydowy

Dla wspieranych modeli można połączyć oficjalne MQTT zamka z Nuki Hub. Oficjalne MQTT zapewnia szybkie stany i komendy, a Hub uzupełnia funkcje BLE, których nie ma w MQTT. To rozwiązanie dla zaawansowanych użytkowników, ponieważ dubluje część encji i wymaga starannego ustalenia, które encje są źródłem prawdy.

Montaż, kalibracja i pierwsze testy

Montaż mechaniczny i kalibracja wpływają na niezawodność bardziej niż wybrany protokół. Pierwsze uruchomienie wykonaj spokojnie, z otwartymi drzwiami, aby błędna kalibracja nie odcięła dostępu.

Montaż modeli retrofitowych

• Oczyść i odtłuść powierzchnię, jeśli używasz płytki klejonej.
• Wybierz płytkę montażową zgodnie z wystawaniem wkładki i instrukcją producenta.
• Nie dokręcaj śrub tak mocno, aby zdeformować wkładkę lub szyld.
• Włóż klucz w neutralnej pozycji i załóż korpus bez naprężenia.
• Sprawdź ręczne obracanie pokrętłem Nuki przed uruchomieniem silnika.

Montaż Ultra z Universal Cylinder

Zmierz grubość drzwi po obu stronach śruby mocującej wkładkę. Zbuduj cylinder z właściwej liczby modułów i nie zostawiaj go nadmiernie wystającego na zewnątrz. Po montażu sprawdź klucze awaryjne, płynność obrotu i położenie zabieraka. Jeżeli nie masz doświadczenia z wkładkami, rozsądnie jest zlecić montaż ślusarzowi.

Kalibracja

• Otwórz drzwi.
• W aplikacji ustaw prawidłowy typ klamki zewnętrznej.
• Rozpocznij kalibrację i obserwuj pełen ruch.
• Po kalibracji wykonaj lock, unlock i open door przy otwartym skrzydle.
• Następnie zamknij drzwi i wykonaj te same testy.
• Jeżeli silnik wyraźnie zwalnia albo odbija, przerwij i popraw mechanikę.

Door Sensor

Czujnik drzwi pozwala rozróżnić zaryglowane drzwi od zaryglowanego mechanizmu przy otwartym skrzydle. Zamontuj magnes zgodnie z instrukcją, zachowaj małą szczelinę i wykonaj kalibrację w aplikacji. Po każdej zmianie położenia zamka, magnesu lub zawiasów powtórz test stanów: otwarte, przymknięte, zamknięte.

Test awaryjny

Przed uznaniem instalacji za gotową wyjmij baterie lub wyłącz zasilanie Nuki i sprawdź wejście kluczem. Upewnij się, że domownicy wiedzą, gdzie jest klucz mechaniczny, Power Pack można naładować, a drzwi od środka da się otworzyć ręcznie bez aplikacji.

Jakie encje Nuki zobaczysz w Home Assistant

Nazwy encji zależą od metody integracji. Nie kopiuj automatyzacji z internetu bez dopasowania. W Narzędziach deweloperskich → Stany sprawdź dokładne entity_id i atrybuty.

Przycisk „Open door” może być osobną encją button, usługą specyficzną dla integracji albo dodatkową funkcją encji lock. Sprawdź w interfejsie urządzenia, a nie tylko w widoku encji. W przypadku Nuki Hub część zaawansowanych funkcji jest domyślnie wyłączona w panelu firmware.

Gotowe automatyzacje Nuki w Home Assistant

Automatyzacje zamka powinny być konserwatywne. Najpierw buduj powiadomienia, potem automatyczne ryglowanie, a automatyczne odryglowanie zostaw na koniec. Wszystkie przykłady wymagają podmiany nazw encji.

Automatyczne ryglowanie dopiero po zamknięciu drzwi

alias: Nuki - zarygluj 30 sekund po zamknięciu drzwi
description: Nie rygluje, gdy skrzydło jest otwarte
triggers:
  - trigger: state
    entity_id: binary_sensor.drzwi_wejsciowe
    from: "on"
    to: "off"
    for: "00:00:30"
conditions:
  - condition: state
    entity_id: lock.drzwi_wejsciowe
    state: unlocked
actions:
  - action: lock.lock
    target:
      entity_id: lock.drzwi_wejsciowe
  - delay: "00:00:08"
  - condition: template
    value_template: "{{ not is_state('lock.drzwi_wejsciowe', 'locked') }}"
  - action: notify.mobile_app_telefon
    data:
      title: "Nuki nie potwierdził ryglowania"
      message: "Sprawdź drzwi i mechanizm zamka."
mode: restart

Przypomnienie o niezaryglowanych drzwiach wieczorem

alias: Nuki - przypomnienie o 22:30
triggers:
  - trigger: time
    at: "22:30:00"
conditions:
  - condition: not
    conditions:
      - condition: state
        entity_id: lock.drzwi_wejsciowe
        state: locked
actions:
  - action: notify.mobile_app_telefon
    data:
      title: "Drzwi nie są zaryglowane"
      message: "Nuki ma stan: {{ states('lock.drzwi_wejsciowe') }}"
      data:
        tag: nuki-night-check
mode: single

Alarm o niskiej baterii

alias: Nuki - niski poziom baterii
triggers:
  - trigger: numeric_state
    entity_id: sensor.nuki_battery
    below: 25
conditions: []
actions:
  - action: notify.mobile_app_telefon
    data:
      title: "Naładuj lub wymień baterie Nuki"
      message: "Pozostało {{ states('sensor.nuki_battery') }}%."
mode: single

Oświetlenie po wejściu bez reagowania na wyjście

Nie wyzwalaj światła po każdej zmianie na unlocked. Ręczne odryglowanie od środka również zmieni stan. Lepsza logika łączy identyfikator autoryzacji, otwarcie Door Sensora oraz brak obecności domownika chwilę wcześniej. Jeżeli integracja nie udostępnia osoby, użyj Keypada lub pomocnika ustawianego przez automatyzację geolokalizacji.

Bezpieczne automatyczne odryglowanie

Sama strefa GPS nie wystarcza. Telefon może przesunąć pozycję, a użytkownik może przejechać obok domu. Wymagaj kilku sygnałów: osoba weszła do strefy, telefon połączył się z domowym Wi‑Fi lub wykrył beacon, zamek jest dostępny, tryb domu nie jest Noc/Wyjazd, a użytkownik potwierdzi akcję w powiadomieniu. Jeszcze bezpieczniej zostawić Auto Unlock aplikacji Nuki i używać Home Assistant tylko do powiadomień oraz logiki towarzyszącej.

Najczęstsze pytania użytkowników o Nuki i Home Assistant

Czy Nuki działa bez internetu?

Tak, ręczne sterowanie, klucz, Bluetooth oraz lokalne Matter/Bridge/Nuki Hub mogą działać bez internetu. Zakres zdalnych funkcji aplikacji Nuki i usług chmurowych będzie ograniczony. Oficjalne MQTT w niektórych starszych firmware wymagało szczególnej konfiguracji firewalla, aby awaria chmury nie powodowała rozłączania Wi‑Fi.

Czy Nuki działa, gdy Home Assistant nie działa?

Tak. Zamek nadal działa ręcznie, kluczem, przez aplikację Bluetooth, Keypad lub Fob. Home Assistant powinien być dodatkiem, nie jedynym sposobem wejścia.

Czy można otworzyć drzwi zwykłym kluczem?

Tak, jeżeli wkładka ma funkcję awaryjną lub zastosowano prawidłowy Universal Cylinder. Zawsze wykonaj test przed montażem.

Czy Matter pozwala zarządzać kodami Keypada?

Zwykle nie. Matter daje podstawowe sterowanie zamkiem. Kody, użytkownicy i harmonogramy zarządza się w aplikacji Nuki, przez oficjalne MQTT/API albo Nuki Hub.

Czy potrzebuję Nuki Bridge do Home Assistant?

Nie dla modeli z Matter, oficjalnym MQTT ani przy Nuki Hub. Bridge jest potrzebny głównie dla starszych modeli i lokalnego HTTP API.

Czy ZBT-1 używany do Zigbee może równocześnie obsługiwać Thread?

W praktycznej instalacji najlepiej przeznaczyć osobny adapter dla Zigbee i osobny dla Thread. Konfiguracje multiprotocol były źródłem problemów i nie powinny być domyślnym wyborem dla zamka wejściowego.

Dlaczego Nuki pokazuje locked, gdy drzwi są otwarte?

Stan lock opisuje położenie mechanizmu, nie skrzydła. Potrzebujesz Door Sensora lub niezależnego kontaktronu.

Dlaczego silnik jest głośny albo blokuje się?

Najczęściej mechanizm pracuje ciężko, kalibracja jest błędna, drzwi wymagają docisku lub podniesienia klamki. Najpierw popraw mechanikę.

Czy można używać Matter i MQTT jednocześnie?

Wspierane modele mogą pracować z kilkoma integracjami równolegle, ale zwiększa to złożoność. Wyznacz jedną encję jako źródło prawdy i unikaj dublujących się automatyzacji.

Czy Nuki jest bezpieczne?

Bezpieczeństwo zależy nie tylko od szyfrowania urządzenia, ale też od wkładki, kluczy awaryjnych, aktualizacji firmware, konta Nuki, zabezpieczenia telefonu, MQTT, sieci i automatyzacji. Włącz 2FA tam, gdzie jest dostępne, aktualizuj firmware i nie wystawiaj brokera ani Home Assistanta bezpośrednio do internetu.

Diagnostyka: od czego zacząć, gdy Nuki nie działa

Poniższa kolejność diagnostyki pozwala uniknąć resetowania wszystkiego naraz.

1. Mechanika

• Czy klucz obraca się lekko ręcznie?
• Czy drzwi są prawidłowo domknięte?
• Czy podniesiono klamkę?
• Czy Nuki zgłasza motor blocked lub jammed?

2. Zasilanie

• Poziom baterii/akumulatora.
• Stan styków Power Packa.
• Czy zamek restartuje się podczas ruchu silnika?
• Czy ESP32/Bridge ma stabilny zasilacz?

3. Radio

• Matter: zasięg Thread i aktywny border router.
• Bridge/Nuki Hub: RSSI Bluetooth i odległość.
• Wi‑Fi: zasięg 2,4 GHz, roaming i izolacja klientów.

4. Transport i integracja

• Matter Server i node status.
• MQTT: klient połączony, availability, ACL, retained topics.
• Bridge: HTTP API, token, callback i odpowiedzi 503.
• Nuki Hub: paired, MQTT connected, last command failed.

5. Automatyzacja

• Czy komenda była wysłana raz, czy w pętli?
• Czy warunek Door Sensora działa?
• Czy użyto właściwej encji po zmianie integracji?
• Czy konkurencyjna automatyzacja nie wykonuje przeciwnej akcji?

Bezpieczeństwo, prywatność i plan awaryjny

Zamek do drzwi wymaga wyższego standardu niż inteligentna żarówka. Projektuj system tak, aby awaria automatyki nie odbierała dostępu i nie otwierała drzwi.

• Zachowaj klucz mechaniczny poza mieszkaniem u zaufanej osoby lub w bezpiecznym miejscu.
• Nie wystawiaj portu MQTT, Bridge API ani Home Assistant bezpośrednio do internetu.
• Do dostępu zdalnego użyj Nabu Casa lub VPN.
• Włącz blokadę ekranu, biometrię i zdalne wymazanie telefonu.
• Nie przechowuj jawnych PIN-ów Keypada w YAML, logbooku i retained MQTT.
• Oddziel urządzenia IoT VLAN-em, ale zapewnij wymagany multicast, IPv6 i kontrolowane reguły dla Matter.
• Aktualizuj firmware zamka, Bridge, ESP32 i Home Assistant.
• Twórz alert o braku dostępności zamka dłuższym niż kilka minut, nie o każdym krótkim zaniku.
• Testuj raz na kwartał klucz, baterię, Door Sensor i drogę awaryjną.

W 2022 roku badacze NCC Group opisali podatności w starszych produktach Nuki, które zostały poprawione aktualizacjami. Wniosek nie brzmi „Nuki jest niebezpieczne”, lecz „zamek nie może przez lata pracować na nieaktualnym firmware”. To urządzenie bezpieczeństwa, więc proces aktualizacji powinien być częścią utrzymania domu.

Który Nuki i która integracja mają dziś najwięcej sensu

Wybierz Nuki Go, gdy

• chcesz najtańszy nowy model z Matter over Thread,
• akceptujesz klasyczny montaż na istniejącej wkładce,
• podstawowe lock/unlock w Home Assistant jest ważniejsze niż pełne zarządzanie dostępem.

Wybierz Nuki Pro, gdy

• chcesz zachować wkładkę, ale mieć szybszy silnik i akumulator,
• zależy Ci na Matter, Wi‑Fi i oficjalnym MQTT,
• nie chcesz osobnego Bridge.

Wybierz Nuki Ultra, gdy

• masz mało miejsca przy klamce,
• akceptujesz wymianę wkładki na Universal Cylinder,
• chcesz możliwie mały i szybki zestaw.

Wybierz starszy model z Bridge lub Nuki Hub, gdy

• kupujesz rozsądnie wyceniony używany zamek,
• nie potrzebujesz Matter,
• potrafisz utrzymać Bridge albo ESP32 i MQTT.

Dla większości nowych instalacji Home Assistant najlepszym startem jest Nuki Pro lub Go przez Matter, a aplikacja Nuki pozostaje miejscem kalibracji, aktualizacji i zarządzania dostępem. Dla użytkownika technicznego, który potrzebuje pełnych logów, kodów i niestandardowych automatyzacji, oficjalne MQTT albo Nuki Hub daje większe możliwości. Bridge nie jest przestarzały — po prostu najlepiej pasuje do starszych generacji.

Keypad, Keypad 2, Fob, Door Sensor i Opener — co daje każdy dodatek

Sam zamek jest tylko jednym elementem systemu dostępu. Dla wielu rodzin większą zmianę niż Home Assistant daje Keypad, ponieważ dzieci, goście, serwis albo osoba wynajmująca mieszkanie nie muszą instalować aplikacji. Dodatki trzeba jednak dobierać do realnego scenariusza i pamiętać, że nie każda metoda integracji pokazuje ich dane w Home Assistant.

Nuki Keypad

Podstawowy Keypad pozwala otwierać drzwi kodem. Kody mogą być stałe, czasowe lub ograniczone harmonogramem. Dla ekipy sprzątającej możesz utworzyć kod działający wyłącznie w środy między 9:00 a 13:00, a dla gościa kod wygasający po weekendzie. Kod powinien należeć do konkretnej osoby lub roli, aby dziennik zdarzeń miał sens. Nie twórz jednego wspólnego kodu dla całej rodziny i wszystkich usługodawców.

Nuki Keypad 2 z czytnikiem linii papilarnych

Keypad 2 dodaje odcisk palca. Jest wygodny, lecz nadal trzeba utrzymywać co najmniej jedną alternatywę: kod, telefon albo klucz. Mokry, zabrudzony lub uszkodzony palec może nie zostać rozpoznany. W automatyzacjach nie zakładaj, że każdy wpis fingerprint zostanie opisany identycznie przez wszystkie wersje Nuki Hub i firmware — w issues pojawiały się różnice w raportowaniu nieprawidłowych odcisków.

Nuki Fob

Fob jest prostym pilotem Bluetooth. Ma sens dla osoby starszej, dziecka albo pracownika, który nie powinien dostać dostępu do całej aplikacji. Zgubiony Fob trzeba natychmiast usunąć z autoryzacji. W Home Assistant traktuj go jako metodę wejścia zarządzaną przez Nuki, a nie jako przycisk do dowolnych automatyzacji bezpieczeństwa.

Door Sensor

Door Sensor nie mierzy położenia rygla, lecz położenie skrzydła. Dopiero połączenie stanu lock i stanu drzwi daje użyteczną informację: zamknięte i zaryglowane, zamknięte i odryglowane, otwarte i odryglowane albo niebezpieczne „otwarte, ale mechanizm zaryglowany”. Jeżeli oficjalny Door Sensor nie jest widoczny w wybranej integracji, można zastosować niezależny kontaktron Zigbee lub Z-Wave i użyć go jako źródła prawdy w automatyzacjach.

Nuki Opener

Opener steruje domofonem w budynku wielorodzinnym i pozwala otworzyć wejście do klatki. Nie jest zamkiem do drzwi mieszkania. Może reagować na dzwonek, realizować Ring to Open i współpracować z Bridge lub Nuki Hub. Przed zakupem trzeba sprawdzić zgodność z konkretnym modelem domofonu. Błędne podłączenie przewodów może unieruchomić dzwonek albo powodować fałszywe wywołania.

Baterie, Power Pack i realny czas pracy

Deklarowany czas pracy jest wartością orientacyjną. Wpływa na niego opór mechanizmu, liczba obrotów wkładki, temperatura, częstotliwość Auto Unlock, komunikacja Wi‑Fi/Thread/Bluetooth, polling Bridge oraz liczba operacji dziennie. Zamek w lekkich drzwiach używany cztery razy dziennie może pracować znacznie dłużej niż identyczny model zmagający się z wielopunktowym ryglem.

Jak rozpoznać problem mechaniczny po baterii

• Poziom spada szybko mimo małej liczby otwarć.
• Silnik zwalnia pod koniec ruchu.
• W logu pojawia się motor blocked lub akcja jest powtarzana.
• Zamek działa dłużej przy otwartych drzwiach niż po domknięciu.
• Różnica zaczęła się po regulacji drzwi, wymianie uszczelki lub zmianie temperatury.

W takim przypadku nie zaczynaj od wymiany akumulatora. Wyreguluj zaczepy i zawiasy, powtórz kalibrację oraz sprawdź, czy wystarczy jeden obrót zamiast dwóch. Każdy dodatkowy obrót to większe zużycie energii i dłuższe oczekiwanie.

Ładowanie wbudowanego akumulatora

Modele Pro i Ultra można ładować bez demontażu całej instalacji zgodnie z instrukcją producenta. Zaplanuj gniazdo lub przewód tak, aby ładowanie nie blokowało drzwi i nie tworzyło pętli, o którą można zahaczyć. Nie czekaj do 1%. Ustaw alert na 25–30%, a drugi na poziom krytyczny.

Baterie wymienne

Używaj kompletu baterii tego samego typu, marki i wieku. Nie mieszaj nowych ze starymi ani akumulatorów o różnych charakterystykach. Po wymianie sprawdź, czy aplikacja prawidłowo rozpoznała typ zasilania, ponieważ algorytm procentowy zależy od napięcia i chemii ogniwa.

Nuki w VLAN-ie IoT: Wi‑Fi, mDNS, IPv6 i reguły zapory

Zamek jest dobrym kandydatem do osobnego VLAN-u IoT, ale Matter over Thread komplikuje klasyczny model „IoT nie może rozmawiać z LAN”. Matter korzysta z IPv6, multicast DNS i komunikacji między kontrolerem, border routerem oraz urządzeniem. Zbyt agresywne filtrowanie może pozwolić dodać zamek, a później powodować okresowe unavailable.

Dla Nuki Bridge i oficjalnego MQTT

• Zarezerwuj adres IP Bridge lub zamka.
• Zezwól Home Assistantowi na połączenie do Bridge HTTP API albo brokerowi na ruch MQTT.
• Zezwól Bridge na callback HTTP do lokalnego adresu HA.
• Nie zezwalaj całemu VLAN-owi IoT na dowolny ruch do sieci Main.
• Blokuj dostęp administracyjny do Bridge i brokera z sieci gościnnej.

Dla Matter over Thread

• Nie wyłączaj IPv6 w LAN tylko dlatego, że internet od operatora jest IPv4.
• Zapewnij trasowanie i multicast między Matter Serverem a Thread Border Routerem.
• Telefon używany do commissioning powinien chwilowo znajdować się w sieci mającej dostęp do Home Assistanta i border routera.
• mDNS reflector musi obsługiwać właściwe interfejsy, ale nie powinien rozgłaszać usług do sieci gościnnej.
• Po zmianie VLAN-u border routera sprawdź wszystkie urządzenia Thread, nie tylko Nuki.

W Mikrotiku, UniFi, Omadzie czy OPNsense dokładne reguły będą inne. Najbezpieczniej zacząć od działającej konfiguracji w jednej sieci, zapisać ruch w logach i dopiero później przenosić elementy do VLAN-u. Przenoszenie zamka, border routera, Matter Servera i telefonu jednocześnie utrudnia diagnozę.

Migracja: Bridge → Matter, Matter → MQTT i wymiana modelu

Migracja zamka może zepsuć automatyzacje nie dlatego, że nowa metoda jest gorsza, lecz dlatego, że zmieniają się entity_id, dostępne akcje i znaczenie stanów. Nie usuwaj starej integracji, dopóki nowa nie przejdzie pełnego testu.

Bezpieczna procedura migracji

1. Zrób pełny backup Home Assistant i eksport ustawień Nuki.
2. Zapisz listę automatyzacji, skryptów i dashboardów używających starej encji.
3. Dodaj nową metodę równolegle, ale wyłącz możliwość automatycznego odryglowania.
4. Porównaj ręczne lock, unlock, open door, stan baterii i Door Sensor.
5. Przez kilka dni używaj nowej encji w powiadomieniach.
6. Podmień encje w automatyzacjach i testuj każdą osobno.
7. Dopiero wtedy usuń Bridge, stare discovery MQTT albo poprzednią fabric Matter.

Pułapka duplikatów

Po migracji możesz mieć dwa urządzenia o podobnej nazwie i kilka encji lock. Nadaj im tymczasowo nazwy „Nuki Matter test” i „Nuki Bridge stare”. Nie polegaj na nazwie widocznej w dashboardzie; sprawdzaj entity_id i identyfikator urządzenia. Usunięcie starego urządzenia nie zawsze usuwa retained MQTT Discovery, dlatego po Nuki Hub lub oficjalnym MQTT trzeba skontrolować broker.

Wymiana fizycznego zamka

Nowy model nie powinien dziedziczyć automatyzacji od starego przez samo nadanie identycznego entity_id. Najpierw wykonaj kalibrację i test awaryjny. Potem możesz przejąć starą nazwę encji, aby ograniczyć poprawki, ale sprawdź, czy nowa integracja ma te same stany i obsługuje open door.

Linkowanie serii i źródła

Ten artykuł jest częścią serii MarkLabs o zamkach elektronicznych. W gotowej publikacji podmień poniższe adresy na docelowe URL serii.

• Najpierw przeczytaj: Zamek elektroniczny do Home Assistant — protokoły, drzwi i wybór modelu.
• Następnie: Tedee w Home Assistant — GO, GO2, PRO i Bridge.
• Aqara U200 w Home Assistant — Matter over Thread, Keypad i problemy.
• Automatyzacje zamka w Home Assistant — bezpieczne YAML i scenariusze awaryjne.

Źródła wykorzystane do aktualizacji artykułu

• Oficjalna dokumentacja Home Assistant: integracje Nuki Bridge, Nuki Matter, Matter, Thread i OpenThread Border Router.
• Nuki Help Center: konfiguracja Matter, akcje zamka Matter, troubleshooting Matter over Thread, generacje Smart Lock i Thread.
• Nuki Developer Forum: Bridge HTTP API, callbacks, MQTT API oraz troubleshooting Wi‑Fi/Thread/MQTT.
• Repozytorium technyon/nuki_hub: README, Hybrid Mode, issues dotyczące stanów undefined, rozłączeń i błędów BLE.
• Home Assistant Community: Nuki 4 Pro Matter, brak unlatch, Ultra, ZBT‑1/ZBT‑2, MQTT oraz problemy ze zdalnym dostępem.

Stan informacji i modeli: sierpień 2026. Przed zakupem sprawdź aktualną kartę konkretnego wariantu w swoim kraju, ponieważ producent może zmieniać pakiety, funkcje zdalne i zakres licencji.