Solution communautaire

Installer l’agent Kerberos sur ZimaOS avec un stockage Synology

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

Utilisez le conteneur Kerberos Agent actuel sur ZimaOS, et non l’ancienne image archivée kerberos/kerberos. Le projet actuel utilise kerberos/agent, prend en charge Docker sur AMD64 et repose sur une instance Agent par caméra.

Si les enregistrements doivent être stockés sur un NAS Synology, montez d’abord le partage Synology de manière fiable sur ZimaOS, confirmez le chemin de montage réel sur l’hôte, puis liez ce chemin au répertoire d’enregistrement de l’Agent. Ne configurez pas Kerberos avec un chemin réseau qui disparaît à chaque reconnexion du NAS.

L’ancien dépôt Docker Kerberos est archivé

L’ancien dépôt Docker open source Kerberos redirige désormais les utilisateurs vers le nouveau dépôt du projet Kerberos Agent.

Commencez avec l’image Agent actuelle

docker run -p 8080:80   --name camera1   -d --restart=always   kerberos/agent:latest

L’utilisation du port hôte 8080 évite de prendre le contrôle du port 80 sur l’hôte ZimaOS.

Conservez la configuration et les enregistrements

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

La documentation actuelle d’Agent recommande explicitement l’utilisation de volumes persistants pour la configuration et les enregistrements.

Une instance Agent par caméra

Kerberos Agent est conçu comme une instance isolée de traitement vidéo pour chaque caméra. Pour plusieurs caméras, créez des conteneurs distincts avec des noms, des ports web et des répertoires persistants uniques.

Utilisez Synology comme destination des enregistrements avec précaution

Montez d’abord le partage SMB/NFS Synology dans ZimaOS, vérifiez qu’il reste monté après un redémarrage, puis examinez le chemin de montage réel sur l’hôte avec findmnt. Liez ce chemin stable de l’hôte à /home/agent/data/recordings.

Ne stockez pas uniquement la configuration sur le partage Synology

Conserver la configuration d’Agent localement sur ZimaOS et les enregistrements sur le Synology peut rendre le démarrage plus fiable. Si le Synology est temporairement indisponible, l’Agent peut tout de même démarrer et signaler correctement le problème de stockage.

Modifiez les identifiants de connexion par défaut

La documentation actuelle de Kerberos Agent mentionne toujours les identifiants par défaut d’une nouvelle installation d’Agent. Modifiez-les immédiatement avant d’utiliser le déploiement au-delà d’un test local.

Utilisez RTSP pour les caméras IP

Pour une utilisation normale avec une caméra IP, Kerberos Agent attend un flux vidéo RTSP H264/H265. Vérifiez le flux indépendamment avant d’incriminer le conteneur.

Le guide Docker personnalisé présente le flux de travail général pour les applications personnalisées.

Testez le montage Synology avant l’enregistrement

findmnt
touch /path/to/synology/test-write
rm /path/to/synology/test-write

Vérifiez que l’hôte ZimaOS peut écrire sur le partage monté avec les autorisations prévues avant de le mapper dans Kerberos Agent. Une application de caméra ne peut pas résoudre un problème d’autorisations SMB/NFS sous-jacent.

Prévoyez les interruptions du Synology

Si le Synology redémarre ou si le partage réseau est interrompu, les enregistrements d’Agent peuvent échouer même si le flux de la caméra reste opérationnel. Décidez si vous souhaitez prévoir un petit tampon d’enregistrement local ou si l’absence d’enregistrements pendant l’interruption du NAS est acceptable.

Surveillez l’espace libre et la rétention

Les vidéos remplissent rapidement l’espace de stockage. Configurez soigneusement les règles de rétention et de nettoyage automatique, puis surveillez la destination Synology. Ne comptez pas sur un répertoire d’enregistrement illimité sur un volume NAS partagé.

FAQ

Quelle image Kerberos dois-je utiliser maintenant ?

Utilisez l’image actuelle kerberos/agent. L’ancien projet kerberos/kerberos est archivé.

Les enregistrements peuvent-ils être stockés sur Synology ?

Oui, si le partage Synology est monté de manière fiable sur l’hôte ZimaOS et si le chemin de cet hôte est lié au répertoire d’enregistrements d’Agent.

Un seul conteneur peut-il gérer plusieurs caméras ?

Le modèle Agent actuel est conçu autour d’une instance Agent par caméra.

Quel port l’interface Agent utilise-t-elle ?

Le conteneur écoute sur le port 80 ; mappez-le vers un port hôte ZimaOS libre, comme 8080.