Solução da comunidade

Instalar o Agent DVR no ZimaOS com o Docker Compose

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

O Agent DVR pode ser executado no ZimaOS como uma aplicação Docker personalizada. A configuração mais simples consiste em utilizar a imagem Docker atual do Agent DVR, mapear a configuração e as gravações para armazenamento persistente no ZimaOS, expor a interface Web na porta 8090 e adicionar portas UDP TURN/WebRTC apenas quando o fluxo de trabalho da câmara/cliente o exigir.

O utilizador de origem importou com sucesso o comando Docker do fornecedor, mas teve de criar manualmente as pastas AppData. A documentação atual do contentor Agent DVR clarifica muito melhor os caminhos persistentes necessários e os mapeamentos de dispositivos GPU.

Comando Docker Run do site do Agent DVR, que mostra a porta 8090 e os caminhos persistentes dos ficheiros multimédia
O utilizador da comunidade copiou o comando Docker publicado pelo Agent DVR como ponto de partida para uma aplicação personalizada do ZimaOS. Fonte: Fórum da Comunidade IceWhale.
Caixa de diálogo de importação do Docker CLI para Agent DVR nas aplicações personalizadas do ZimaOS
O ZimaOS pode importar o comando Docker CLI do Agent DVR, mas os caminhos AppData do anfitrião têm de ser mapeados corretamente. Fonte: Fórum da Comunidade IceWhale.

Utilize um contentor Agent DVR atual

O atual guia do Docker do Agent DVR documenta a disposição Docker mantida e o intervalo atual de portas WebRTC.

Criar pastas persistentes no ZimaOS

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

Faça isto antes de importar a aplicação, para que o contentor não grave configurações críticas num armazenamento descartável.

Utilize a disposição atual dos 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

Disponibilize a interface Web na porta 8090

Aceda a http://ZIMA-IP:8090 depois de o contentor iniciar. Se a interface não aparecer, verifique os registos do contentor antes de alterar as definições das câmaras.

Compreenda as portas UDP

O guia atual do contentor Agent DVR utiliza UDP 3478 e 50000–50100 para TURN/WebRTC. Se utilizar o sistema exclusivamente em rede local e a interface funcionar sem WebRTC remoto, evite expor mais portas do que o necessário.

Adicione câmaras apenas quando o contentor estiver a funcionar corretamente

Comece por uma câmara, confirme a visualização em direto e o caminho das gravações e, depois, adicione mais dispositivos. Assim, é mais fácil identificar problemas de codecs, credenciais, deteção e armazenamento.

Associe os dispositivos GPU apenas quando necessário

A aceleração por hardware Intel/AMD utiliza normalmente /dev/dri. A NVIDIA requer o runtime/toolkit NVIDIA no anfitrião. Primeiro, confirme que a descodificação por software funciona antes de complicar o contentor com o acesso direto à GPU.

Verifique as permissões de AppData e das gravações

O contentor atual suporta PUID/PGID. Associe esses valores ao proprietário dos diretórios do ZimaOS para evitar ficheiros XML/de configuração só de leitura ou falhas nas gravações.

Faça uma cópia de segurança do XML antes de atualizar

O Agent DVR guarda configurações importantes no respetivo diretório XML. Faça uma cópia de segurança antes de alterar as etiquetas de imagem ou as versões principais.

O guia de aplicações personalizadas apresenta o fluxo de trabalho geral do ZimaOS.

Perguntas frequentes

Qual é a porta da interface Web do Agent DVR?

8090 por predefinição nos exemplos de contentores atuais.

Onde são guardadas as gravações?

Associe /AgentDVR/Media/WebServerRoot/Media a uma pasta persistente do anfitrião.

Preciso de todas as portas TURN/WebRTC?

Não em todas as configurações exclusivamente locais. Adicione-os apenas para as funcionalidades que exigem esses caminhos.

O Agent DVR pode usar aceleração de GPU Intel ou AMD?

Sim, quando os dispositivos /dev/dri necessários e as definições da aplicação estão corretamente configurados.