Wątek źródłowy stanowi wprowadzenie do zewnętrznego samouczka z 2023 roku, a nie kompletną dokumentację wdrożenia Frigate. Informuje, że samouczek zainstaluje Frigate w CasaOS i zintegruje kamery z Google Coral, ale nie zachowuje informacji o użytym obrazie Dockera, woluminach, portach, rozmiarze pamięci współdzielonej ani konfiguracji detektora.
W przypadku aktualnej konfiguracji dokumentacja Frigate powinna stanowić podstawę techniczną. Docker Compose pozostaje zalecaną metodą instalacji, a Google Coral jest obecnie tylko jedną z kilku możliwych opcji akceleracji sprzętowej oraz ścieżek detekcji i przetwarzania obrazu.
Obecnie Frigate zaleca Docker Compose
Aktualny przewodnik instalacji Frigate korzysta z ghcr.io/blakeblackshear/frigate:stable, trwałej konfiguracji i multimediów, jawnie określonego rozmiaru pamięci współdzielonej oraz mapowania urządzeń odpowiedniego dla wybranego akceleratora.
Skorzystaj z aktualnego modelu instalacji Frigate, zamiast kopiować film z 2023 roku dosłownie.
Przechowuj /config poza kontenerem
Konfiguracja YAML Frigate powinna znajdować się w folderze hosta mapowanym na /config. Przechowuj ją na trwałej pamięci masowej CasaOS, aby ponowne utworzenie kontenera nie usunęło ustawień kamer, detektora, nagrywania, stref ani migawek.
Mapuj nagrania i klipy na rzeczywistą pamięć masową
Materiały wideo z NVR mogą przyrastać znacznie szybciej niż zwykłe dane aplikacji. Umieść nagrania, klipy i eksporty na woluminie z odpowiednią ilością miejsca zamiast na małym dysku systemowym.
Pamięć współdzielona musi odpowiadać obciążeniu kamer
Frigate korzysta z pamięci współdzielonej do przetwarzania obrazu. Aktualny przykład Compose zawiera jawnie określony parametr shm_size, a jego prawidłowa wartość zależy od rozdzielczości i liczby kamer.
Google Coral jest opcjonalny, a nie uniwersalnie wymagany
Źródło z 2023 roku kładło nacisk na Google Coral. Obecna dokumentacja Frigate nadal opisuje mapowanie urządzeń Coral USB i PCIe, ale współczesne wdrożenia mogą również korzystać z akceleracji wideo Intel/AMD, Intel NPU lub innych obsługiwanych ścieżek detekcji, zależnie od sprzętu.
Akceleracja sprzętowa wymaga prawidłowego mapowania urządzeń
Aktualne przykłady obejmują /dev/bus/usb dla Coral USB, /dev/apex_0 dla Coral PCIe, /dev/dri/renderD128 dla układów graficznych Intel/AMD oraz /dev/accel dla obsługiwanych ścieżek Intel NPU. Przyznawaj Frigate dostęp tylko do sprzętu, którego rzeczywiście potrzebuje.
Tryb uprzywilejowany nie zawsze jest wymagany
Aktualny przykład Compose dla Frigate wskazuje, że privileged: true może nie być konieczne w każdej konfiguracji. Gdy wystarczają jawne mapowania urządzeń i odpowiednie uprawnienia, lepiej stosować zasadę minimalnych uprawnień.
Chroń dane uwierzytelniające kamer i punkty końcowe RTSP
Konfiguracja Frigate często zawiera nazwy użytkowników, hasła i adresy URL RTSP kamer. Nie publikuj kompletnych plików konfiguracji ani zrzutów ekranu bez usunięcia poufnych danych i nie wystawiaj RTSP bezpośrednio do Internetu.
CasaOS jest hostem kontenera, a nie warstwą konfiguracji Frigate
CasaOS może uruchamiać kontener oraz mapować pamięć masową i urządzenia, natomiast YAML Frigate steruje działaniem NVR. Jeśli aplikacja się otwiera, ale kamery nie działają, sprawdź logi i konfigurację Frigate zamiast wielokrotnie instalować ponownie CasaOS.
Detekcja obiektów i dekodowanie wideo to różne zadania akceleracji
Akcelerator Coral służy do obsługiwanej inferencji związanej z detekcją obiektów, natomiast sprzęt wideo Intel/AMD/NVIDIA może przyspieszać dekodowanie i kodowanie. Jedno nie zastępuje automatycznie drugiego.
Projektuj stos Frigate z uwzględnieniem zarówno obciążenia detektora, jak i obciążenia związanego z kodekiem oraz transkodowaniem kamer, zamiast traktować „akcelerację sprzętową” jako pojedynczą opcję.
Ustaw retencję przed włączeniem wielu kamer
Ciągłe nagrywanie może szybko zapełnić dyski. Oszacuj przepływność × liczbę kamer × liczbę dni przechowywania, pozostaw zapas wolnego miejsca w systemie plików i zdecyduj, które zdarzenia wymagają długiego przechowywania, a które mogą być objęte nagrywaniem kroczącym.
Po pierwszym uruchomieniu sprawdź logi i stan Frigate
Zanim dodasz wszystkie kamery, zweryfikuj jeden strumień, potwierdź wykrycie detektora lub urządzenia i przejrzyj logi kontenera pod kątem błędów pamięci współdzielonej, FFmpeg lub uprawnień. Rozszerzenie sprawdzonej konfiguracji z jedną kamerą jest łatwiejsze niż jednoczesne diagnozowanie pięciu awarii.
Frigate w CasaOS — FAQ
Czy oryginalny wpis społeczności zawiera pełny plik Compose Frigate?
Nie. W głównej mierze odsyła do zewnętrznego samouczka z 2023 roku.
Czy Google Coral jest wymagany we współczesnym Frigate?
Nie. Coral pozostaje jedną z obsługiwanych opcji, ale obecne Frigate obsługuje również inne ścieżki sprzętowe, zależnie od hosta.
Co zawsze powinno być przechowywane trwale?
Co najmniej konfiguracja Frigate oraz pamięć na multimedia i nagrania, które chcesz zachować.
