Dodanie kamery IP do Home Assistant wydaje się proste — dopóki nie dowiesz się, że każda marka kamer mówi swoim własnym dialektem. Integracja ONVIF to jedyny standard, który przecina szum: pojedyncza integracja Home Assistant, która współpracuje z Reolink, Amcrest, Dahua, klonami Hikvision i większością kamer IP „kompatybilnych z ONVIF” sprzedawanych od 2018 roku. Ten przewodnik przeprowadzi Cię przez pełną konfigurację, pułapki, o których nikt nie wspomina w wątkach na forach, oraz najtańszy sposób jej uruchomienia: LinknLink iSG Box SE z preinstalowanym Home Assistant 69,90 dolarów.
1. Co to jest ONVIF i dlaczego użytkownicy Home Assistant go potrzebują
ONVIF (Open Network Video Interface Forum) to otwarty standard definiujący sposób, w jaki kamery IP, rejestratory NVR i klienci wideo komunikują się ze sobą w sieci lokalnej. Zamiast konieczności posiadania osobnej aplikacji dla każdej marki aparatu, każde urządzenie zgodne ze standardem ONVIF może wykrywać, przesyłać strumieniowo i odbierać zdarzenia z dowolnego innego urządzenia zgodnego ze standardem ONVIF.
Dla użytkowników Home Assistant ma to znaczenie z trzech powodów:
- Prywatność i lokalna kontrola. ONVIF działa całkowicie w Twojej sieci LAN. Żadne wideo nie opuszcza Twojego domu, żadne konto nie jest wymagane, żaden producent kamer nie może wyłączyć Twojego przekazu poprzez aktualizację oprogramowania sprzętowego. Jest to dokładne przeciwieństwo modelu Wyze, Ring czy Arlo.
- Opóźnienie. Obraz z kamery oparty na chmurze zazwyczaj przepływa w obie strony przez serwer dostawcy w ciągu 300–1200 ms, zanim dotrze do Home Assistant. ONVIF w sieci lokalnej trwa zwykle poniżej 150 ms — wystarczająco szybko, aby uruchomić automatykę Home Assistant (światła, HVAC, syreny), zanim osoba wchodząca do klatki wykona dwa kroki.
- Brak blokady dostawcy. Jeśli Twoja marka aparatu przestanie działać lub przejdzie na model subskrypcyjny, Twój system będzie nadal działał. ONVIF to otwarta specyfikacja w stylu W3C z tysiącami kompatybilnych urządzeń.
Jeśli nadal zastanawiasz się, czy warto używać dedykowanego koncentratora, omówimy podstawy Co to jest inteligentny koncentrator domu. W szczególności w przypadku ONVIF koncentrator z wystarczającym zapasem mocy procesora do obsługi wielu strumieni RTSP nie podlega negocjacjom — dlatego też wybór sprzętu opisany w następnej sekcji ma znaczenie.
Marki kamer, które dobrze współpracują z ONVIF + Home Assistant:
- Reolink (seria RLC, E1, Duo) — doskonała ekspozycja profilu ONVIF, strumień główny + dodatkowy od razu po wyjęciu z pudełka
- Amcrest (seria IP4M, IP5M) — Dahua OEM, bardzo solidne wydarzenia ONVIF
- Dahua (seria IPC-HFW, IPC-HDW) — natywny ONVIF, niezawodne zdarzenia ruchu
- Hikvision i rebranding (Annke, LTS, LaView) — ONVIF działa, ale najpierw włącz go w interfejsie internetowym kamery
- Ubiquiti UniFi Protect G3/G4/G5 — ONVIF tylko poprzez eksport Protect, większość użytkowników pomija tę ścieżkę
- Axis, Bosch, Vivotek — klasy korporacyjnej, doskonała obsługa ONVIF
Marki aparatów, których należy unikać w przypadku ONVIF: Wyze, Blink, Arlo, Ring, Google Nest. Są to produkty oparte przede wszystkim na chmurze; ich ekspozycja ONVIF albo nie istnieje, albo jest niestabilna po aktualizacjach oprogramowania sprzętowego.
Najlepsza lokalna brama do automatyzacji kamer
Zanim dotkniesz ekranu integracji ONVIF, upewnij się, że masz przygotowane cztery rzeczy:
2.1 Host Home Assistant wystarczająco mocny dla strumieni RTSP
System operacyjny Home Assistant działający na Raspberry Pi 4 (4 GB) technicznie działa dla 1–2 kamer, ale w przypadku więcej — lub w momencie dodania fregaty do wykrywania AI — Pi zaczyna tracić klatki i przegrzewać się.
Polecamy LinknLink iSG Box SE dla tej konfiguracji. Za 69,90 USD jest to najtańszy host Home Assistant na rynku z preinstalowanym HA i ma znacznie więcej mocy obliczeniowej niż Pi 4 — wystarczający zapas dla ponad 8 kamer ONVIF w natywnym HA lub 2–4 kamer z Frigate NVR na tym samym urządzeniu. Pełne porównanie sprzętu znajduje się w naszym Podręcznik sprzętu Home Assistant.
Dlaczego iSG Box SE jest właściwym ustawieniem domyślnym dla kompilacji ONVIF:
- Preinstalowany Home Assistant — podłącz zasilanie i Ethernet, otwórz przeglądarkę, zakończ kreatora konfiguracji. Bez obrazowania kart SD, bez Proxmox, bez oczekiwania na łańcuch dostaw Home Assistant Yellow.
- Architektura zorientowana lokalnie — 100% kontroli lokalnej, bez konta w chmurze, bez miesięcznych opłat.
- Wystarczający procesor dla fregaty — premia §5 za wykrywanie obiektów AI działa bez dodawania akceleratora Coral USB w konfiguracji z 2–4 kamerami.
- Cena — 69,90 USD w porównaniu z Home Assistant Green za 158,90 USD lub zestawem Raspberry Pi 5, który po dodaniu dysku SSD i obudowy kosztuje ponad 120 USD.
2.2 Kamera IP kompatybilna z ONVIF w tej samej sieci LAN
Sprawdź specyfikację kamery lub interfejs administratora pod kątem przełącznika „ONVIF”. Większość kamer marek wymienionych w §1 jest dostarczana z włączoną funkcją ONVIF, ale bez hasła — dane uwierzytelniające dodasz w §3.
2.3 Rezerwacja statycznego adresu IP w routerze
Home Assistant integruje kamery według adresu IP. Jeśli w przyszłym tygodniu router przekaże kamerze nowy adres IP, integracja zostanie przerwana po cichu. W ustawieniach DHCP routera zarezerwuj stały adres IP sieci LAN dla adresu MAC każdej kamery (zazwyczaj wyświetlany w interfejsie administratora kamery).
2.4 Poświadczenia administratora kamery
Nie jest to ustawienie fabryczne — najpierw je zmień. Poświadczenia ONVIF są domyślnie przesyłane przez sieć LAN w ramach autoryzacji skrótowej, a hasła domyślne nadal są najczęściej skanowaną powierzchnią w każdej sieci domowej.
Konfiguracja lokalnej kamery RTSP
Gdy sprzęt jest gotowy, faktyczna integracja zajmuje mniej niż dziesięć minut. Oto dokładnie pięć kroków.
Krok 1 — Włącz ONVIF w interfejsie internetowym kamery
Otwórz adres IP kamery w przeglądarce (np. http://192.168.1.50), zaloguj się przy użyciu danych administratora i znajdź sekcję ONVIF. Ścieżki według marki:
- Ponowne połączenie: Ustawienia urządzenia → Sieć → Zaawansowane → Ustawienia portu → zaznacz „ONVIF”
- Amcrest/Dahua: Konfiguracja → Sieć → Połączenie → ONVIF → Uwierzytelnianie = „Przegląd” lub „Brak”
- Hikvision: Konfiguracja → Sieć → Ustawienia zaawansowane → Protokół integracji → włącz ONVIF i utwórz dedykowanego użytkownika ONVIF
Hikvision to jedyna marka, która domyślnie ma wyłączoną funkcję ONVIF i wymaga osobnego konta użytkownika ONVIF — skonfiguruj je przed kontynuowaniem.
Krok 2 — Zanotuj adresy URL strumieni RTSP (opcjonalne, ale przydatne)
Będąc w interfejsie internetowym, skopiuj adresy URL RTSP głównego i podstrumienia. Integracja ONVIF Home Assistant wykrywa je automatycznie, ale posiadanie ich pod ręką znacznie przyspiesza debugowanie, jeśli wykrycie się nie powiedzie. Typowe formaty:
- Ponownie połącz główny:
rtsp://admin:hasło@192.168.1.50:554/h264Preview_01_main - Połącz ponownie subskrypcję:
rtsp://admin:hasło@192.168.1.50:554/h264Preview_01_sub - Amcrest główny:
rtsp://admin:hasło@192.168.1.50:554/cam/realmonitor?channel=1&subtype=0 - Subskrypcja Amcresta:
rtsp://admin:hasło@192.168.1.50:554/cam/realmonitor?channel=1&subtype=1
Krok 3 — Otwórz Home Assistant i dodaj integrację ONVIF
W interfejsie użytkownika Home Assistant (niezależnie od tego, czy działa na iSG Box SE, czy gdzie indziej):
- Idź do Ustawienia → Urządzenia i usługi
- Kliknij + Dodaj integrację (prawy dolny róg)
- Wyszukaj „ONVIF” i wybierz to
Home Assistant przeskanuje sieć lokalną poprzez WS-Discovery. Większość kamer pojawia się automatycznie. Jeśli Twój nie, możesz dodać go ręcznie za pomocą adresu IP.
Krok 4 — Wprowadź adres IP, port i dane uwierzytelniające
Domyślnym portem ONVIF jest 80 (HTTP) w większości kamer, a nie 554 (czyli RTSP — inny port). Jeśli Twoja kamera korzysta z niestandardowego portu ONVIF (typowe porty to 2020, 8000, 8899), zostanie on wymieniony w interfejsie internetowym kamery w sekcji Sieć lub ONVIF.
Wpisz:
- Gospodarz: statyczny adres IP kamery w sieci LAN
- Port: zwykle 80; Hikvision często używa 80, Dahua 80, Reolink 8000
- Nazwa użytkownika/hasło: dane uwierzytelniające ONVIF ustawione w §2.4 (Hikvision: dedykowany użytkownik ONVIF utworzony w kroku 1)
Krok 5 — Wybierz profile (główny i podstrumień)
Home Assistant ujawni każdy „profil” ONVIF reklamowany przez kamerę — zazwyczaj jeden dla strumienia głównego (o wysokiej rozdzielczości) i jeden dla strumienia podrzędnego (o niskiej rozdzielczości). Włącz oba:
- Główny strumień — używany do nagrań, migawek i oglądania w wysokiej jakości
- Podstrumień — używany w kafelku deski rozdzielczej Home Assistant Lovelace (dzięki czemu deska rozdzielcza ładuje się szybko nawet na urządzeniach mobilnych)
Kliknij Prześlij. Kamera pojawi się teraz pod Urządzenia i usługi z elementami zapewniającymi transmisję na żywo, czujnikiem ruchu i (jeśli kamera to obsługuje) czujnikami binarnymi na każde zdarzenie wygenerowane przez kamerę — przekroczenie linii, wykrycie wtargnięcia, klasyfikacja człowieka/pojazdu, sabotaż.
Rozwiązywanie problemów z ONVIF ponownie
Oto cztery problemy, które generują 90% wątków na forum dotyczących Home Assistant ONVIF. Oto jak naprawić każdy z nich w mniej niż dwie minuty.
4.1 „Nie wykryto kamery” podczas dodawania integracji
WS-Discovery korzysta z multiemisji DNS (mDNS). Jeśli host Home Assistant i kamera znajdują się w różnych sieciach VLAN lub różnych identyfikatorach SSID Wi-Fi, pakiety mDNS nie przekraczają tej granicy. Poprawki, w kolejności wysiłku:
- Umieść tymczasowo kamerę w tej samej podsieci co Home Assistant w celu wykrycia, a następnie przenieś ją z powrotem.
- Dodaj kamerę ręcznie za pomocą adresu IP podczas konfiguracji integracji (WS-Discovery to wygoda, a nie wymóg).
- Włącz odbicie mDNS/Avahi na swoim routerze (UniFi: „Multicast DNS”, pfSense: pakiet „Avahi”, OpenWrt: „umdns”). To jest trwałe rozwiązanie.
4.2 Transmisja na żywo ciągle się buforuje lub wyświetla komunikat „Stream niedostępny”
Główny strumień w rozdzielczości 4K lub 1440p + 30 fps to często za dużo dla dashboardu Lovelace, szczególnie na urządzeniach mobilnych. Przełącz kafelek dashboardu na strumień podrzędny:
- Ustawienia → Urządzenia i usługi → Integracja ONVIF → Konfiguruj → odznacz „Profil główny” dla karty graficznej
- Lub bezpośrednio na karcie aparatu YAML: ustaw
źródło_strumieniado jednostki podprofilu
Fregata NVR (opisana w §5) jest tutaj czystszym rozwiązaniem — ponownie koduje strumień raz i udostępnia wszystkim klientom HLS/WebRTC o niskim opóźnieniu.
4.3 Jednostki detekcji ruchu nie uruchamiające zdarzeń w Home Assistant
Zdarzenia ruchu ONVIF są opcjonalne w specyfikacji — kamera musi: (a) mieć włączoną lokalną funkcję wykrywania ruchu i (b) być skonfigurowana do publikowania zdarzeń ONVIF. Kroki:
- W interfejsie WWW kamery włącz wykrywanie ruchu (zwykle Zdarzenie → Detekcja ruchu → Włącz)
- Znajdź ustawienia ONVIF lub „inteligentne wydarzenie” i włącz „Zdarzenia ONVIF” lub „Wydarzenia push”
- W Home Assistant uruchom ponownie integrację ONVIF: Ustawienia → Urządzenia i usługi → ONVIF → menu z trzema kropkami → Załaduj ponownie
Jeśli korzystasz z kamery Hikvision lub Hikvision-OEM, a zdarzenia nadal się nie uruchamiają, sprawdź, czy użytkownik ONVIF utworzony w §3 Krok 1 ma uprawnienia „Zdarzenie” i „Media” — domyślnie użytkownik ONVIF jest tylko do odczytu Użytkownik zarządzanie, co jest prawidłowe, ale niektóre wersje oprogramowania ograniczają również subskrypcję zdarzeń.
4.4 Kamera działa przez jeden dzień, a następnie przechodzi w tryb offline do momentu ponownego uruchomienia
Prawie zawsze jest to wygaśnięcie dzierżawy DHCP (brak rezerwacji statycznej) lub przekroczenie limitu czasu podtrzymania RTSP. Potwierdź, że rezerwacja statycznego adresu IP z §2.3 została zastosowana na routera, a nie tylko w ustawieniach sieciowych aparatu. Niektóre aparaty obsługują oba; niektórzy ignorują swój własny statyczny adres IP i przyjmują wszystko, co przydziela router.
5. Bonus: Dodanie fregaty NVR do wykrywania obiektów AI
Natywny ruch Home Assistant ONVIF jest binarny: „coś się poruszyło” lub „nic się nie poruszyło”. To powoduje wiele fałszywych alarmów w postaci liści unoszących się nad trawnikiem lub cieni o zachodzie słońca.
Fregata to darmowy rejestrator NVR typu open source, który działa jako dodatek do Home Assistant i wykrywa lokalne obiekty AI na obrazie z kamery — zamiast „ruchu” automatyka uruchamia „osobę”, „samochód”, „paczkę” lub „psa”. Wszystko działa na hoście Home Assistant; żadne ramki nie opuszczają sieci LAN.
Dlaczego iSG Box SE jest wystarczająco mocny, aby obsłużyć fregatę:
- Domyślny detektor procesora fregaty obsługuje 2–4 kamery przy 5–7 kl./s każda w iSG Box SE bez dławienia termicznego.
- Jeśli później skalujesz do 6–8 kamer, dodaj akcelerator USB Google Coral za 60 USD, a Frigate przeniesie wnioskowanie do TPU — iSG Box SE ma na to wolną przepustowość USB.
- Instalacja zajmuje ~15 minut: zainstaluj dodatek Frigate ze sklepu z dodatkami Home Assistant, wklej adresy URL ONVIF RTSP z §3 Krok 2 do
fregata.yaml, załaduj ponownie.
Połącz to z automatyką Home Assistant („jeśli fregata wykryje osobę przy drzwiach wejściowych między 22:00 a 6:00, włącz światło na werandzie i trzykrotnie błyśnij lampą w salonie”), a otrzymasz inteligentny system bezpieczeństwa, którego koszt wykracza poza rachunek za prąd. The iSG Box SE jest punktem początkowym o najniższym tarciu dla dokładnie tego stosu.
Często zadawane pytania dotyczące integracji Home Assistant ONVIF
Czy Home Assistant może używać kamer ONVIF bez dostępu do chmury?
Tak. Home Assistant może łączyć się z wieloma kamerami ONVIF w sieci lokalnej przy użyciu adresu IP kamery, portu ONVIF i lokalnych poświadczeń.
Dlaczego kamera Reolink potrzebuje ustawień RTSP z ONVIF?
ONVIF obsługuje wykrywanie i kontrolę, podczas gdy RTSP często przenosi strumień wideo na żywo. Jeśli wideo nie powiedzie się, sprawdź ścieżkę RTSP, oprogramowanie sprzętowe i uprawnienia LAN.
Która bramka LinknLink jest najlepsza do automatyzacji kamer lokalnych?
Użyj iSG Box SE w przypadku kompaktowej bramy Home Assistant lub iSG Display Max, jeśli potrzebujesz także ekranu naściennego do sterowania kamerą i pomieszczeniem.
7. Wniosek: rozpocznij konfigurację ONVIF z iSG Box SE już dziś
Integracja z ONVIF to najkrótsza droga od „Mam kamerę IP” do „włączają się światła, gdy ktoś wchodzi na podjazd, zmienia się klimatyzacja, gdy salon jest pusty przez 20 minut, a mój telefon dzwoni, gdy Fregata widzi furgonetkę dostawczą zamiast bezdomnego kota”. A najtańszym sposobem, aby się tam dostać bez weekendowego majsterkowania przy sprzęcie, jest: LinknLink iSG Box SE (69,90 USD) — Preinstalowany Home Assistant, w 100% lokalny, gotowy do uruchomienia ONVIF i Frigate od razu po otwarciu pudełka.
Wykonaj pięć kroków opisanych w §3, a pierwsza transmisja strumieniowa z kamery w Home Assistant zajmie mniej niż dziesięć minut. Dodaj warstwę fregaty §5 w przyszły weekend. Dodaj pozostałe kamery, kiedy tylko chcesz — integracja ONVIF skaluje się do ponad 8 urządzeń bez dalszej konfiguracji.