Soluzione della community

Installare Frigate su CasaOS: aggiornamento del tutorial Google Coral del 2023 per l’attuale Docker Compose

A September 2023 Community post promoting an external Frigate-on-CasaOS tutorial focused on Google Coral object detection. The forum body does not preserve the Compose file or exact configuration, so a current article must use maintained Frigate documentation rather than reconstructing the old video steps.

Il thread originale è un'introduzione a un tutorial esterno del 2023, non un resoconto completo della distribuzione di Frigate. Indica che il tutorial installerà Frigate su CasaOS e integrerà le telecamere con Google Coral, ma non conserva l'immagine Docker, i volumi, le porte, le dimensioni della memoria condivisa o la configurazione del rilevatore utilizzati all'epoca.

Per una configurazione attuale, la documentazione aggiornata di Frigate dovrebbe costituire la base tecnica. Docker Compose rimane il metodo di installazione consigliato e Google Coral è ormai solo una delle diverse opzioni possibili per l'accelerazione hardware e i percorsi di rilevamento video.

Attualmente Frigate consiglia Docker Compose

La guida all'installazione attuale di Frigate utilizza ghcr.io/blakeblackshear/frigate:stable, configurazione e contenuti multimediali persistenti, una dimensione esplicita della memoria condivisa e mappature dei dispositivi appropriate per l'acceleratore selezionato.

Usa il modello di installazione attuale di Frigate invece di copiare alla lettera un video del 2023.

Mantieni /config fuori dal container

La configurazione YAML di Frigate deve trovarsi in una cartella dell'host mappata su /config. Conservala nello spazio di archiviazione persistente di CasaOS, così la ricreazione del container non cancellerà le impostazioni delle telecamere, del rilevatore, delle registrazioni, delle zone e delle istantanee.

Mappa registrazioni e clip su uno spazio di archiviazione reale

I video NVR possono crescere molto più rapidamente dei normali dati delle applicazioni. Salva registrazioni, clip ed esportazioni su un volume di archiviazione con capacità sufficiente, anziché sul piccolo disco del sistema operativo.

La memoria condivisa deve essere adeguata al carico delle telecamere

Frigate utilizza la memoria condivisa per l'elaborazione video. L'esempio Compose attuale include un valore esplicito per shm_size e il valore corretto dipende dalla risoluzione e dal numero delle telecamere.

Google Coral è opzionale, non un requisito universale

La fonte del 2023 dava risalto a Google Coral. Frigate continua a documentare le mappature Coral USB e PCIe, ma le distribuzioni moderne possono utilizzare anche l'accelerazione video Intel/AMD, un NPU Intel o altri percorsi di rilevamento supportati, a seconda dell'hardware.

L'accelerazione hardware richiede la mappatura corretta dei dispositivi

Gli esempi attuali includono /dev/bus/usb per Coral USB, /dev/apex_0 per Coral PCIe, /dev/dri/renderD128 per la grafica Intel/AMD e /dev/accel per i percorsi NPU Intel supportati. Concedi l'accesso solo all'hardware effettivamente necessario a Frigate.

La modalità privilegiata non è sempre necessaria

L'esempio Compose attuale di Frigate indica che privileged: true potrebbe non essere necessario per tutte le configurazioni. Quando sono sufficienti mappature esplicite dei dispositivi e autorizzazioni adeguate, è preferibile applicare il principio del privilegio minimo.

Mantieni private le credenziali delle telecamere e gli endpoint RTSP

La configurazione di Frigate contiene comunemente nomi utente, password e URL RTSP delle telecamere. Evita di pubblicare file di configurazione completi o schermate senza oscurare i dati sensibili e non esporre direttamente RTSP a Internet.

CasaOS è l'host dei container, non il livello di configurazione di Frigate

CasaOS può avviare il container e mappare spazio di archiviazione e dispositivi, mentre lo YAML di Frigate controlla il comportamento dell'NVR. Se l'app si apre ma le telecamere non funzionano, esamina i log e la configurazione di Frigate invece di reinstallare ripetutamente CasaOS.

Il rilevamento degli oggetti e la decodifica video sono attività di accelerazione diverse

Un acceleratore Coral viene utilizzato per l'inferenza del rilevamento degli oggetti supportato; l'hardware video Intel/AMD/NVIDIA può accelerare la decodifica e la codifica. Uno non sostituisce automaticamente l'altro.

Progetta lo stack di Frigate tenendo conto sia del carico del rilevatore sia del carico di decodifica e transcodifica dei codec delle telecamere, anziché considerare l'“accelerazione hardware” come un'unica opzione.

Imposta la conservazione prima di abilitare molte telecamere

La registrazione continua può riempire rapidamente i dischi. Stima bitrate × numero di telecamere × giorni di conservazione, lascia spazio libero sul file system e decidi quali eventi richiedono una conservazione prolungata rispetto alle riprese a rotazione.

Controlla i log e lo stato di Frigate dopo il primo avvio

Prima di aggiungere tutte le telecamere, verifica un flusso, conferma che il rilevatore/dispositivo venga riconosciuto e controlla i log del container per individuare errori relativi alla memoria condivisa, a FFmpeg o alle autorizzazioni. Espandere da una telecamera funzionante è più semplice che eseguire il debug di cinque errori simultanei.

Domande frequenti su Frigate in CasaOS

Il post originale della community contiene il file Compose completo di Frigate?

No. Rimanda principalmente a un tutorial esterno del 2023.

Google Coral è obbligatorio per la versione attuale di Frigate?

No. Coral rimane un'opzione supportata, ma la versione attuale di Frigate supporta altri percorsi hardware, a seconda dell'host.

Che cosa dovrebbe essere sempre persistente?

Come minimo, la configurazione di Frigate e lo spazio di archiviazione dei contenuti multimediali e delle registrazioni che vuoi conservare.