Solução da comunidade

Instalar o Kerberos Agent no ZimaOS com armazenamento Synology

A user wanted Kerberos.io on an i5 ZimaOS system while storing surveillance recordings on a separate Synology NAS.

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.