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. Pour une installation simple, utilisez l’image Docker actuelle d’Agent DVR, associez la configuration et les enregistrements à un stockage ZimaOS persistant, exposez l’interface Web sur le port 8090 et ajoutez les ports UDP TURN/WebRTC uniquement si votre utilisation des caméras et des clients le nécessite.

L’utilisateur source a importé avec succès la commande Docker du fournisseur, mais a dû créer manuellement les dossiers AppData. La documentation actuelle du conteneur Agent DVR indique désormais beaucoup plus clairement les chemins persistants requis et les mappages des périphériques GPU.

Commande Docker Run du site Web d’Agent DVR indiquant 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 pour s’en servir comme point de départ d’une application personnalisée ZimaOS. Source : forum de la communauté IceWhale.
Boîte de dialogue d’importation Docker CLI de l’application personnalisée ZimaOS pour Agent DVR
ZimaOS peut importer la commande Docker CLI d’Agent DVR, mais les chemins AppData de l’hôte doivent tout de même être correctement associés. Source : forum de la communauté IceWhale.

Utiliser un conteneur Agent DVR à jour

Le guide Docker d’Agent DVR actuel documente la configuration Docker maintenue et la plage de ports WebRTC actuelle.

Créer des dossiers persistants dans ZimaOS

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

Faites-le avant d’importer l’application afin que le conteneur n’enregistre pas de configuration critique dans un stockage temporaire.

Utiliser la disposition 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

Exposez l’interface Web sur le port 8090

Ouvrez http://ZIMA-IP:8090 une fois le conteneur démarré. Si l’interface ne s’affiche pas, vérifiez les journaux du conteneur avant de modifier les paramètres de la caméra.

Comprenez les ports UDP

Le guide actuel du conteneur Agent DVR utilise 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 plus de ports que nécessaire.

Ajoutez des caméras uniquement lorsque le conteneur fonctionne correctement

Commencez par une caméra, vérifiez le flux en direct et le chemin d’enregistrement, puis ajoutez d’autres périphériques. Cela facilite l’identification des problèmes de codec, d’identifiants, de détection et de stockage.

Associez 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 ou la boîte à outils NVIDIA sur l’hôte. Vérifiez d’abord que le décodage logiciel fonctionne avant de compliquer le conteneur avec le transfert du GPU.

Vérifiez les autorisations d’AppData et du dossier des enregistrements

Le conteneur actuel prend en charge PUID/PGID. Faites correspondre ces valeurs au propriétaire des répertoires ZimaOS pour éviter que les fichiers XML/de configuration soient en lecture seule ou que les enregistrements échouent.

Sauvegardez le répertoire XML avant la mise à jour

Agent DVR stocke des éléments de configuration 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 la procédure générale dans ZimaOS.

FAQ

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

8090 par défaut dans les exemples actuels de conteneurs.

Où les enregistrements sont-ils stockés ?

Associez /AgentDVR/Media/WebServerRoot/Media à un dossier hôte persistant.

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

Pas pour toutes les configurations exclusivement locales. Ajoutez-les uniquement 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 appareils /dev/dri requis et les paramètres de l’application sont correctement configurés.