Frigate NVR w Home Assistant OS: instalacja i pierwsza kamera

Czym jest Frigate NVR i dlaczego warto go uruchomić w Home Assistant OS

Frigate NVR to system nagrywania kamer IP, który zamiast wysyłać strumień do chmury producenta, analizuje obraz lokalnie na własnym sprzęcie. Detekcja obiektów opiera się na modelach uczenia maszynowego, najczęściej wykrywających osoby, pojazdy czy zwierzęta. Całość działa jako dodatek do Home Assistant OS. To zmienia sposób myślenia o monitoringu.

Klasyczne rejestratory zapisują wszystko bez przerwy i zostawiają przeglądanie nagrań człowiekowi. Frigate robi inaczej: nagrywa tylko wtedy, gdy coś się dzieje, a powiadomienia wysyła z konkretnym kontekstem. Dostajesz alert "osoba przy bramie", a nie "ruch w strefie 3". Bez owijania w bawełnę, to oszczędność czasu i miejsca na dysku.

Uruchomienie w Home Assistant OS ma sens z kilku powodów:

• Instalacja sprowadza się do dodania repozytorium i włączenia dodatku, bez ręcznego stawiania kontenerów Docker.
• Integracja z automatyzacje HA działa od razu, więc detekcja może być wyzwalaczem dla świateł czy alarmu.
• Dane zostają na twoim dysku, co ma znaczenie przy prywatności i przy braku internetu.
• Wiele kamer obsługuje strumień RTSP, więc nie jesteś przywiązany do jednego producenta.
• Zużycie zasobów można skalować, dokładając akcelerator taki jak Coral USB albo iGPU.

Moim zdaniem Frigate wypada lepiej niż chmurowe usługi typu Ring czy Nest, ponieważ nie uzależnia podstawowych funkcji od serwera producenta. Abonament znika, a nagrania nie wyciekają poza dom. Trzeba tylko pamiętać, że całość wymaga trochę cierpliwości przy konfiguracji. Brzmi prosto, ale diabeł tkwi w szczegółach.

Wyobraź sobie sytuację, w której kamera przy furtce łapie listonosza o 8:00 i nic więcej przez resztę dnia. Frigate zapisze kilkanaście sekund zdarzenia, a nie dwanaście godzin pustego ogrodu. Dysk 500 GB wystarcza wtedy na wiele tygodni nagrań zamiast kilku dni.

Zanim przejdziemy do instalacji, warto ustalić jedno: Frigate to nie czarna magia, ale wymaga zrozumienia, jak działają strumienie i detekcja. W kolejnej części rozłożę proces na czynniki pierwsze.

Wymagania sprzętowe i przygotowanie Home Assistant OS do pracy z Frigate

Frigate to dodatek, który potrafi mocno obciążyć sprzęt. Detekcja obiektów na żywo wymaga zasobów, a nie każdy mini PC z Home Assistant OS podoła temu bez zacięć. Diabeł tkwi w szczegółach, bo sama instalacja dodatku to pestka. Prawdziwe wyzwanie zaczyna się, gdy dochodzi druga i trzecia kamera.

Największym wąskim gardłem bywa pamięć RAM oraz sposób dostępu do strumienia wideo. Jeśli Home Assistant OS działa na Raspberry Pi 4 z 4 GB RAM, jedna kamera w rozdzielczości 1080p to realistyczny limit. Dwie kamery i procesor zaczyna się dusić. Przy Raspberry Pi 5 jest lepiej, ale nadal bez akceleracji sprzętowej detekcja potrafi zjadać większość wolnych zasobów.

Moim zdaniem tani mini PC z procesorem N100 i 16 GB RAM działa lepiej niż Raspberry Pi 5 z akceleratorem Coral, ponieważ oferuje więcej rdzeni, szybszy dysk NVMe i sprzętowe dekodowanie wideo przez iGPU. Coral przyspiesza samą detekcję, ale nie odciąża dekodowania strumieni. Przy trzech kamerach różnica bywa odczuwalna.

Przed instalacją Frigate przygotuj też miejsce na nagrania. Karta microSD to zły wybór dla ciągłego zapisu. Dysk SSD podłączony przez USB 3.0 albo NVMe w mini PC sprawdzi się znacznie lepiej. Zapis 24/7 zabija karty pamięci w kilka miesięcy.

Wyobraź sobie sytuację, w której instalujesz Frigate na Raspberry Pi 4 z jedną kamerą 4K. Obraz działa, ale detekcja łapie opóźnienia kilkusekundowe, a temperatura procesora dobija do progu throttlingu. Zejście do sub-streamu 720p dla detekcji rozwiązuje problem od razu.

Na koniec upewnij się, że Home Assistant OS ma włączony dostęp do dysku z nagraniami i że dodatek Frigate może korzystać z trybu hosta sieciowego. Bez tego kamery w innej podsieci pozostaną niewidoczne.

Instalacja dodatku Frigate NVR krok po kroku

Frigate w Home Assistant OS instalujesz jako dodatek z oficjalnego sklepu. Nie musisz nic kompilować, nie musisz wchodzić po SSH do kontenera. Kilka kliknięć i dodatek działa. Tylko że pierwsze uruchomienie bez konfiguracji kamery zwykle kończy się błędem w logach, więc warto przygotować podstawowy plik konfiguracyjny wcześniej.

Zanim klikniesz „Zainstaluj", sprawdź czy masz wolną przestrzeń na dysku i czy w ustawieniach dodatku wskażesz katalog na nagrania. Domyślnie Frigate zapisuje wszystko w folderze dodatku, który przy aktualizacji potrafi zniknąć. To klasyczna pułapka. Ustawienie media albo własnego udziału sieciowego rozwiązuje problem raz na zawsze.

1. Wejdź w Ustawienia → Dodatki → Sklep z dodatkami i wyszukaj „Frigate".
2. Kliknij Zainstaluj i poczekaj na pobranie obrazu kontenera.
3. W zakładce Konfiguracja wklej podstawowy plik YAML z definicją kamery i detektora.
4. Ustaw katalog nagrań na udział, który nie zniknie po aktualizacji.
5. Uruchom dodatek i sprawdź logi pod kątem błędów wykrywania.

Po starcie otwórz panel Frigate przez przycisk Otwórz interfejs web. Jeśli widzisz podgląd kamery i zielony status detektora, jesteś w domu. Jeśli nie, w 90% przypadków problem leży w złym adresie RTSP albo w braku uprawnień do zapisu w katalogu nagrań.

Moim zdaniem uruchamianie Frigate na tym samym sprzęcie co Home Assistant OS ma sens tylko przy małej liczbie kamer i detekcji na CPU. Przy dwóch, trzech strumieniach w rozdzielczości 4K procesor szybko się dławi. Lepiej od razu zaplanować osobny mini PC z akceleracją sprzętową, bo przenosiny później oznaczają konfigurację od zera. To nie czarna magia, ale wymaga świadomej decyzji na starcie.

Konfiguracja pierwszej kamery IP w Frigate

Masz działający kontener Frigate w Home Assistant OS. Teraz trzeba go nakarmić obrazem z kamery. Cały proces sprowadza się do trzech rzeczy: poprawnego adresu strumienia RTSP, wpisu w pliku konfiguracyjnym i restartu dodatku. Brzmi prosto. I faktycznie takie jest, jeśli wiesz, gdzie szukać.

Zacznij od ustalenia adresu RTSP swojej kamery. Większość producentów trzyma go w instrukcji albo w panelu webowym urządzenia. Typowy format wygląda tak: rtsp://użytkownik:hasło@adres_ip:554/ścieżka. Zwróć uwagę na podstrumień. Kamery często udostępniają dwa: główny w wysokiej rozdzielczości i pomocniczy, lżejszy. Do detekcji obiektów wystarczy ten drugi, a mniej danych to mniejsze obciążenie procesora.

Konfigurację Frigate edytujesz w pliku frigate.yml, dostępnym przez dodatek w Home Assistant OS. Minimalny wpis dla jednej kamery wygląda następująco:

• mqtt: podaj adres brokera, najczęściej localhost, jeśli używasz dodatku Mosquitto.
• cameras: nazwa kamery, którą sam wymyślasz, np. „front”.
• ffmpeg inputs: lista strumieni, główny plus wykrywanie na podstrumieniu.
• detect: szerokość i wysokość klatki dla detektora, zwykle 640 na 480 wystarczy.
• record: opcjonalnie, jeśli chcesz zapisywać nagrania na dysku.

Po zapisaniu pliku zrestartuj dodatek. Wejdź w interfejs Frigate na porcie 5000 i sprawdź podgląd. Jeśli obraz się pojawi, jesteś w domu. Jeśli nie, najczęściej problem leży w błędnym haśle albo w tym, że kamera blokuje połączenia z nieznanych adresów IP. Warto wtedy zajrzeć do logów dodatku, bo tam Frigate wprost pisze, na czym się wyłożył.

Moim zdaniem lepiej od razu ustawić detekcję na podstrumieniu niż na głównym, ponieważ rozdzielczość 4K nie poprawia rozpoznawania obiektów, a potrafi mocno obciążyć nawet wydajny serwer. Główny strumień zostaw do nagrywania, a wykrywanie puść po lżejszym. Prosty zabieg, a robi różnicę.

Detekcja obiektów i pierwsze automatyzacje z Frigate

Frigate sam w sobie nie "widzi" niczego sensownego, dopóki nie skonfigurujesz detekcji. Domyślnie potrafi wykrywać osoby, ale to dopiero początek. Kluczowe jest to, że analiza odbywa się lokalnie, na twoim sprzęcie, bez wysyłania nagrań do chmury. To zmienia wszystko, jeśli zależy ci na prywatności.

W pliku konfiguracyjnym Frigate ustawiasz, jakie obiekty mają być wykrywane i w jakich strefach. Możesz też zdefiniować maski, które wykluczają ruch w miejscach generujących fałszywe alarmy, na przykład drzewa na wietrze albo ulicę za płotem. Diabeł tkwi w szczegółach, bo źle ustawiona maska potrafi wyciąć połowę obrazu.

Typowy przykład: kamera patrzy na podjazd, a w tle rośnie krzew, który porusza się przy każdym podmuchu wiatru. Frigate zgłasza dziesiątki zdarzeń dziennie. Wystarczy narysować maskę na krzewie i problem znika. Prosto, ale trzeba wiedzieć gdzie kliknąć.

Automatyzacje w Home Assistant podłączasz przez MQTT. Frigate publikuje zdarzenia, a ty decydujesz, co się stanie: zapalenie światła, wysłanie powiadomienia, nagranie klipu. Moim zdaniem lepiej zacząć od powiadomień niż od razu sterować oświetleniem, ponieważ łatwiej wychwycić fałszywe alarmy, zanim zaczną irytować domowników. Brzmi prosto. W praktyce pierwsze dni to głównie dostrajanie.

Nie zawsze wszystko działa od razu. Czasem kamera ma zbyt szeroki kąt, czasem detekcja gubi się przy słabym świetle. I tu zaczyna się problem. Ale właśnie dlatego warto spędzić chwilę na konfiguracji, zamiast od razu iść na całość z dziesiątkami automatyzacji.

Najczęściej zadawane pytania (FAQ)

Czy Frigate NVR będzie działać na moim sprzęcie? To pytanie wraca najczęściej i nie ma jednej odpowiedzi. Wszystko zależy od liczby kamer, rozdzielczości i tego, czy chcesz detekcję obiektów w czasie rzeczywistym.

Poniższa tabela pokazuje orientacyjne wymagania dla typowych scenariuszy. Warto traktować ją jako punkt wyjścia, nie sztywną regułę szerzej opisaliśmy to w artykule "Kamery IP w smart home: integracja z Home Assistant i Frigate".

Czy Frigate wymaga chmury producenta? Nie. Cała analiza obrazu odbywa się lokalnie, na twoim urządzeniu. To jedna z największych zalet tego rozwiązania.

Typowy przykład: masz trzy kamery IP i chcesz wykrywać tylko osoby w ogrodzie, ignorując ruch drzew. Frigate poradzi sobie z tym na mini PC z Coral USB, bez wysyłania czegokolwiek na zewnątrz.

Czy muszę mieć Home Assistant OS? Frigate działa też jako samodzielny kontener Docker. Integracja z HAOS daje jednak wygodę: powiadomienia, automatyzacje i podgląd w jednym miejscu.

Ile dysku potrzebuję? Przy dwóch kamerach 1080p i retencji 7 dni zwykle wystarczy 500 GB. Przy 4K i dłuższym przechowywaniu licz się z kilkoma terabajtami.

Masz wątpliwości co do sprzętu? Zacznij od jednej kamery. Reszta się wyjaśni.