Solution communautaire

Installer Agent DVR sur ZimaOS avec 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 peut fonctionner sur ZimaOS en tant qu’application Docker personnalisée. La configuration recommandée consiste à utiliser l’image Docker actuelle d’Agent DVR, à mapper la configuration et les enregistrements vers un stockage ZimaOS persistant, à exposer l’interface Web sur le port 8090 et à ajouter les ports UDP TURN/WebRTC uniquement lorsque votre workflow avec les caméras ou les clients l’exige.

L’utilisateur a réussi à importer la commande Docker du fournisseur, mais a dû créer manuellement les dossiers AppData. La documentation actuelle du conteneur Agent DVR indique désormais plus clairement les chemins persistants requis et les mappages des périphériques GPU.

Commande Docker Run du site Agent DVR affichant le port 8090 et les chemins persistants des médias
L’utilisateur de la communauté a copié la commande Docker publiée par Agent DVR comme point de départ pour une application personnalisée ZimaOS. Source : forum de la communauté IceWhale.
Boîte de dialogue d’importation de l’interface de ligne de commande Docker d’une application personnalisée ZimaOS pour Agent DVR
ZimaOS peut importer la commande Docker d’Agent DVR, mais les chemins AppData de l’hôte doivent tout de même être mappés correctement. Source : forum de la communauté IceWhale.

Utiliser un conteneur Agent DVR à jour

Le guide Docker actuel d’Agent DVR décrit l’organisation Docker maintenue ainsi que la plage de ports WebRTC actuelle.

Créer les dossiers ZimaOS persistants

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

Effectuez cette opération avant d’importer l’application afin que le conteneur n’écrive pas la configuration essentielle dans un stockage temporaire.

Utiliser l’organisation actuelle des volumes

/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

Exposer l’interface Web sur le port 8090

Ouvrez http://ZIMA-IP:8090 après le démarrage du conteneur. Si l’interface ne s’affiche pas, consultez les journaux du conteneur avant de modifier les paramètres des caméras.

Comprendre les ports UDP

Le guide actuel du conteneur Agent DVR utilise le port UDP 3478 ainsi que les ports 50000–50100 pour TURN/WebRTC. Si votre utilisation est strictement locale et que l’interface fonctionne sans WebRTC distant, évitez d’exposer davantage de ports que nécessaire.

Ajouter les caméras uniquement lorsque le conteneur est stable

Commencez par une seule caméra, vérifiez la vue en direct et le chemin d’enregistrement, puis ajoutez d’autres appareils. Cela facilite l’identification des problèmes liés aux codecs, aux identifiants, à la découverte et au stockage.

Mapper les périphériques GPU uniquement si nécessaire

L’accélération matérielle Intel/AMD utilise généralement /dev/dri. NVIDIA nécessite l’environnement d’exécution et la boîte à outils NVIDIA sur l’hôte. Vérifiez d’abord que le décodage logiciel fonctionne avant de complexifier le conteneur avec un accès direct au GPU.

Vérifier les autorisations sur AppData et les enregistrements

Le conteneur actuel prend en charge PUID/PGID. Faites correspondre ces valeurs au propriétaire des répertoires ZimaOS afin d’éviter les fichiers XML ou de configuration en lecture seule, ainsi que les échecs d’enregistrement.

Sauvegarder les fichiers XML avant toute mise à jour

Agent DVR stocke les paramètres importants dans son répertoire XML. Sauvegardez-le avant de modifier les balises d’image ou de passer à une version majeure.

Le guide des applications personnalisées présente le workflow général de ZimaOS.

FAQ

Quel est le port de l’interface Web d’Agent DVR ?

Le port 8090 par défaut dans les exemples actuels de conteneur.

Où sont stockés les enregistrements ?

Mappez /AgentDVR/Media/WebServerRoot/Media vers un dossier hôte persistant.

Ai-je besoin de tous les ports TURN/WebRTC ?

Pas pour toutes les configurations locales uniquement. Ajoutez-les seulement pour les fonctionnalités qui nécessitent ces chemins.

Agent DVR peut-il utiliser l’accélération GPU Intel ou AMD ?

Oui, lorsque les périphériques /dev/dri requis et les paramètres de l’application sont correctement configurés.