Utilize o contentor atual do Kerberos Agent no ZimaOS, não a antiga imagem arquivada kerberos/kerberos. O projeto atual utiliza kerberos/agent, suporta Docker em AMD64 e foi concebido para uma instância do Agent por câmara.
Se as gravações devem ficar num NAS Synology, monte primeiro a partilha Synology de forma fiável no ZimaOS, confirme o caminho de montagem real no anfitrião e, em seguida, associe esse caminho ao diretório de gravações do Agent. Não aponte o Kerberos para um caminho de rede que desapareça sempre que o NAS voltar a ligar-se.
O antigo repositório Docker do Kerberos está arquivado
O repositório Docker original do Kerberos Open Source encaminha agora os utilizadores para o novo repositório do projeto Kerberos Agent.
Comece pela imagem atual do Agent
docker run -p 8080:80 --name camera1 -d --restart=always kerberos/agent:latest
A utilização da porta 8080 no anfitrião evita ocupar a porta 80 do anfitrião ZimaOS.
Torne a configuração e as gravações persistentes
docker run -p 8080:80 --name camera1 -v /DATA/AppData/kerberos/camera1/config:/home/agent/data/config -v /DATA/AppData/kerberos/camera1/recordings:/home/agent/data/recordings -d --restart=always kerberos/agent:latest
A documentação atual do Agent recomenda explicitamente volumes persistentes para a configuração e as gravações.
Um Agent por câmara
O Kerberos Agent foi concebido como uma instância isolada de processamento de câmara. Para várias câmaras, crie contentores separados com nomes, portas Web e diretórios persistentes exclusivos.
Utilize o Synology como destino das gravações com cuidado
Monte primeiro a partilha SMB/NFS do Synology no ZimaOS, confirme que continua montada após um reinício e, em seguida, verifique o caminho de montagem real no anfitrião com findmnt. Associe esse caminho estável do anfitrião a /home/agent/data/recordings.
Não guarde a configuração apenas na partilha Synology
Manter a configuração do Agent localmente no ZimaOS e as gravações no Synology pode tornar o arranque mais resiliente. Se o Synology estiver temporariamente indisponível, o Agent poderá iniciar-se na mesma e comunicar corretamente o problema de armazenamento.
Altere o início de sessão predefinido
A documentação atual do Kerberos Agent continua a indicar credenciais predefinidas para um Agent novo. Altere-as imediatamente antes de utilizar a implementação para além de um teste local.
Utilize RTSP para câmaras IP
Para uma utilização normal com câmaras IP, o Kerberos Agent espera um fluxo de câmara RTSP H264/H265. Verifique o fluxo de forma independente antes de atribuir a culpa ao contentor.
O guia Docker personalizado aborda o fluxo de trabalho geral para aplicações personalizadas.
Teste a montagem Synology antes de gravar
findmnt
touch /path/to/synology/test-write
rm /path/to/synology/test-write
Confirme que o anfitrião ZimaOS consegue escrever na partilha montada com as permissões pretendidas antes de a associar ao Kerberos Agent. Uma aplicação de câmaras não consegue resolver um problema subjacente de permissões SMB/NFS.
Planeie a indisponibilidade do Synology
Se o Synology reiniciar ou a partilha de rede cair, as gravações do Agent podem falhar mesmo que o fluxo da câmara continue saudável. Decida se pretende um pequeno buffer de gravação local ou se aceita perder gravações durante a indisponibilidade do NAS.
Monitorize o espaço livre e a retenção
O vídeo ocupa rapidamente o armazenamento. Defina cuidadosamente as regras de retenção/limpeza automática e monitorize o destino Synology. Não dependa de um diretório de gravações ilimitado num volume NAS partilhado.
FAQ
Que imagem do Kerberos devo utilizar agora?
Utilize a imagem atual kerberos/agent. O antigo projeto kerberos/kerberos está arquivado.
As gravações podem ficar no Synology?
Sim, desde que a partilha Synology esteja montada de forma fiável no anfitrião ZimaOS e o caminho desse anfitrião esteja associado ao diretório de gravações do Agent.
Um contentor pode gerir várias câmaras?
O modelo atual do Agent foi concebido para uma instância do Agent por câmara.
Que porta utiliza a interface do Agent?
O contentor escuta na porta 80; associe-a a uma porta livre do anfitrião ZimaOS, como a 8080.
