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 tiverem de 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 original do Kerberos Open Source para Docker encaminha agora os utilizadores para o repositório do novo 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 persistentes a configuração e as gravações
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âmaras. Para várias câmaras, crie contentores separados com nomes, portas Web e diretórios persistentes únicos.
Utilize o Synology com cuidado como destino das gravações
Monte primeiro a partilha SMB/NFS do Synology no ZimaOS e confirme que continua montada após o reinício. 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 pode continuar a arrancar e a comunicar corretamente o problema de armazenamento.
Altere as credenciais de início de sessão predefinidas
A documentação atual do Kerberos Agent continua a indicar credenciais predefinidas para uma nova instalação do Agent. Altere-as imediatamente antes de utilizar a implementação para além de um teste local.
Utilize RTSP para câmaras IP
Para a utilização normal com câmaras IP, o Kerberos Agent requer uma transmissão de câmara RTSP H264/H265. Verifique a transmissão de forma independente antes de atribuir o problema ao contentor.
O guia personalizado do Docker explica o fluxo de trabalho geral para aplicações personalizadas.
Teste a montagem da 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âmara não consegue resolver um problema de permissões SMB/NFS subjacente.
Prepare-se para períodos de indisponibilidade da Synology
Se a Synology reiniciar ou a partilha de rede ficar indisponível, as gravações do Agent podem falhar, mesmo que a transmissão da câmara continue a funcionar normalmente. Decida se pretende uma pequena memória intermédia de gravação local ou se aceita perder gravações durante períodos de indisponibilidade do NAS.
Monitorize o espaço livre e a retenção
O vídeo ocupa rapidamente o espaço de armazenamento. Defina cuidadosamente as regras de retenção e limpeza automática e monitorize o destino Synology. Não confie num diretório de gravações sem limite num volume NAS partilhado.
Perguntas frequentes
Que imagem Kerberos devo utilizar agora?
Utilize a imagem atual kerberos/agent. O antigo projeto kerberos/kerberos foi arquivado.
As gravações podem ficar na Synology?
Sim, se a partilha Synology estiver montada de forma fiável no anfitrião ZimaOS e o caminho no anfitrião estiver 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; mapeie-a para uma porta disponível no anfitrião ZimaOS, como a 8080.



