Solución de la comunidad

Instala Agent DVR en 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 puede ejecutarse en ZimaOS como una aplicación Docker personalizada. La configuración recomendada consiste en usar la imagen Docker actual de Agent DVR, asignar la configuración y las grabaciones a un almacenamiento persistente de ZimaOS, exponer la interfaz web en el puerto 8090 y añadir los puertos UDP de TURN/WebRTC solo cuando el flujo de trabajo de la cámara o del cliente los necesite.

El usuario original importó correctamente el comando Docker del proveedor, pero tuvo que crear manualmente las carpetas de AppData. La documentación actual del contenedor de Agent DVR deja mucho más claros los directorios persistentes necesarios y las asignaciones de dispositivos GPU.

Comando Docker Run del sitio web de Agent DVR que muestra el puerto 8090 y las rutas persistentes de medios
El usuario de la comunidad copió el comando Docker publicado de Agent DVR como punto de partida para una aplicación personalizada de ZimaOS. Fuente: foro de la comunidad de IceWhale.
Diálogo de importación de Docker CLI de una aplicación personalizada de ZimaOS para Agent DVR
ZimaOS puede importar el comando Docker CLI de Agent DVR, pero las rutas de AppData del host aún deben asignarse correctamente. Fuente: foro de la comunidad de IceWhale.

Usa un contenedor actual de Agent DVR

La guía de Docker de Agent DVR actual documenta la estructura de Docker mantenida y el rango de puertos WebRTC vigente.

Crea carpetas persistentes en ZimaOS

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

Hazlo antes de importar la aplicación para que el contenedor no escriba la configuración importante en un almacenamiento no persistente.

Usa la estructura actual de volúmenes

/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

Expón la interfaz web en el puerto 8090

Abre http://ZIMA-IP:8090 después de iniciar el contenedor. Si no aparece la interfaz, revisa los registros del contenedor antes de cambiar la configuración de la cámara.

Comprende los puertos UDP

La guía actual del contenedor de Agent DVR utiliza el puerto UDP 3478 y el rango 50000–50100 para TURN/WebRTC. Si tu uso es exclusivamente local y la interfaz funciona sin WebRTC remoto, evita exponer más puertos de los necesarios.

Añade cámaras solo después de que el contenedor esté funcionando correctamente

Empieza con una cámara, confirma la visualización en directo y la ruta de grabación, y después añade más dispositivos. Así será más fácil aislar problemas de códecs, credenciales, detección y almacenamiento.

Asigna dispositivos GPU solo cuando sea necesario

La aceleración de hardware de Intel/AMD suele utilizar /dev/dri. NVIDIA requiere el entorno de ejecución y el kit de herramientas de NVIDIA en el host. Primero comprueba que la decodificación por software funciona antes de complicar el contenedor con el acceso directo a la GPU.

Comprueba los permisos de AppData y de las grabaciones

El contenedor actual admite PUID/PGID. Haz coincidir esos valores con el propietario de los directorios de ZimaOS para evitar archivos XML o de configuración de solo lectura, o grabaciones fallidas.

Haz una copia de seguridad del XML antes de actualizar

Agent DVR almacena la configuración importante en su directorio XML. Haz una copia de seguridad antes de cambiar las etiquetas de imagen o actualizar a versiones principales.

La guía de aplicaciones personalizadas ofrece el flujo de trabajo general de ZimaOS.

Preguntas frecuentes

¿Qué puerto utiliza la interfaz web de Agent DVR?

El 8090 de forma predeterminada en los ejemplos actuales del contenedor.

¿Dónde se almacenan las grabaciones?

Asigna /AgentDVR/Media/WebServerRoot/Media a una carpeta persistente del host.

¿Necesito todos los puertos de TURN/WebRTC?

No en todas las configuraciones exclusivamente locales. Añádelos solo para las funciones que requieran esas rutas.

¿Puede Agent DVR utilizar aceleración GPU de Intel o AMD?

Sí, siempre que los dispositivos /dev/dri necesarios y la configuración de la aplicación estén configurados correctamente.