Soluzione della community

Installare Agent DVR su ZimaOS con Docker Compose

A new ZimaOS user imported Agent DVR's Docker CLI command and manually created AppData folders before adding the first camera.

Agent DVR può essere eseguito su ZimaOS come app Docker personalizzata. La configurazione più semplice consiste nell'utilizzare l'immagine Docker attuale di Agent DVR, mappare la configurazione e le registrazioni su uno spazio di archiviazione persistente di ZimaOS, esporre l'interfaccia web sulla porta 8090 e aggiungere le porte UDP TURN/WebRTC solo quando il flusso di lavoro della fotocamera o del client ne ha bisogno.

L'utente originale ha importato correttamente il comando Docker del fornitore, ma ha dovuto creare manualmente le cartelle AppData. L'attuale documentazione del container Agent DVR rende molto più chiari i percorsi persistenti richiesti e le mappature dei dispositivi GPU.

Comando Docker Run del sito web di Agent DVR che mostra la porta 8090 e i percorsi persistenti dei contenuti multimediali
L'utente della community ha copiato il comando Docker pubblicato da Agent DVR come punto di partenza per un'app personalizzata di ZimaOS. Fonte: IceWhale Community Forum.
Finestra di dialogo per l'importazione della CLI Docker di un'app personalizzata ZimaOS per Agent DVR
ZimaOS può importare il comando CLI Docker di Agent DVR, ma i percorsi AppData dell'host devono comunque essere mappati correttamente. Fonte: IceWhale Community Forum.

Utilizza un container Agent DVR aggiornato

L'attuale guida Docker di Agent DVR documenta la struttura Docker mantenuta e l'attuale intervallo di porte WebRTC.

Crea cartelle ZimaOS persistenti

/DATA/AppData/agentdvr/config
/DATA/AppData/agentdvr/media
/DATA/AppData/agentdvr/models
/DATA/AppData/agentdvr/commands

Fallo prima di importare l'app, in modo che il container non scriva la configurazione essenziale in uno spazio di archiviazione temporaneo.

Utilizza la struttura attuale dei volumi

/DATA/AppData/agentdvr/config:/AgentDVR/Media/XML
/DATA/AppData/agentdvr/media:/AgentDVR/Media/WebServerRoot/Media
/DATA/AppData/agentdvr/models:/AgentDVR/Media/Models
/DATA/AppData/agentdvr/commands:/AgentDVR/Commands

Esponi l'interfaccia web sulla porta 8090

Apri http://ZIMA-IP:8090 dopo l'avvio del container. Se l'interfaccia non viene visualizzata, controlla i log del container prima di modificare le impostazioni delle telecamere.

Comprendi le porte UDP

La guida attuale del container Agent DVR utilizza la porta UDP 3478 oltre all'intervallo 50000–50100 per TURN/WebRTC. Se utilizzi il sistema esclusivamente in locale e l'interfaccia funziona senza WebRTC remoto, evita di esporre più porte del necessario.

Aggiungi le telecamere solo dopo che il container è operativo

Inizia con una telecamera, verifica la visualizzazione in tempo reale e il percorso di registrazione, quindi aggiungi altri dispositivi. In questo modo sarà più facile isolare i problemi relativi a codec, credenziali, rilevamento e spazio di archiviazione.

Mappa i dispositivi GPU solo quando necessario

L'accelerazione hardware Intel/AMD utilizza in genere /dev/dri. NVIDIA richiede il runtime e il toolkit NVIDIA sull'host. Verifica prima che la decodifica software funzioni, prima di complicare il container con il passthrough della GPU.

Controlla i permessi su AppData e sulle registrazioni

Il container attuale supporta PUID/PGID. Imposta questi valori in base al proprietario delle directory ZimaOS per evitare configurazioni XML in sola lettura o registrazioni non riuscite.

Esegui il backup dell'XML prima dell'aggiornamento

Agent DVR memorizza la configurazione essenziale nella directory XML. Esegui un backup prima di modificare i tag dell'immagine o di passare a versioni principali diverse.

La guida alle app personalizzate illustra il flusso di lavoro generale di ZimaOS.

Domande frequenti

Qual è la porta dell'interfaccia web di Agent DVR?

La porta predefinita è 8090 negli esempi attuali del container.

Dove vengono memorizzate le registrazioni?

Mappa /AgentDVR/Media/WebServerRoot/Media su una cartella persistente dell'host.

Devo utilizzare tutte le porte TURN/WebRTC?

Non per tutte le configurazioni esclusivamente locali. Aggiungile solo per le funzionalità che richiedono questi percorsi.

Agent DVR può utilizzare l'accelerazione GPU Intel o AMD?

Sì, quando i dispositivi /dev/dri richiesti e le impostazioni dell'applicazione sono configurati correttamente.