Utilisez le conteneur actuel de Kerberos Agent sur ZimaOS, et non l’ancienne image archivée kerberos/kerberos. Le projet actuel utilise kerberos/agent, prend en charge Docker sur AMD64 et est conçu pour fonctionner avec une instance d’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, vérifiez le chemin de montage réel sur l’hôte, puis associez 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é
Le dépôt Docker d’origine de Kerberos Open Source redirige désormais les utilisateurs vers le nouveau dépôt du projet Kerberos Agent.
Commencez avec l’image actuelle de l’Agent
docker run -p 8080:80 --name camera1 -d --restart=always kerberos/agent:latest
L’utilisation du port 8080 sur l’hôte évite de monopoliser le port 80 de 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 de l’Agent recommande explicitement des volumes persistants pour la configuration et les enregistrements.
Un Agent par caméra
Kerberos Agent est conçu comme une instance isolée de traitement vidéo. Pour plusieurs caméras, créez des conteneurs distincts avec des noms, des ports Web et des répertoires persistants uniques.
Utilisez le Synology avec précaution comme destination des enregistrements
Montez d’abord le partage SMB/NFS du Synology dans ZimaOS, vérifiez qu’il reste monté après le redémarrage, puis inspectez le chemin de montage réel sur l’hôte avec findmnt. Associez ce chemin stable de l’hôte à /home/agent/data/recordings.
Ne stockez pas la configuration uniquement sur le partage Synology
Conserver la configuration de l’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 quand même démarrer et signaler clairement le problème de stockage.
Modifiez les identifiants de connexion par défaut
La documentation actuelle de Kerberos Agent mentionne toujours des identifiants par défaut pour 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 nécessite un flux de caméra RTSP H264/H265. Vérifiez le flux indépendamment avant d’incriminer le conteneur.
Le guide Docker personnalisé présente le processus général de configuration d’une application personnalisée.
Testez le montage Synology avant d’enregistrer
findmnt
touch /path/to/synology/test-write
rm /path/to/synology/test-write
Avant de le monter dans Kerberos Agent, vérifiez que l’hôte ZimaOS peut écrire sur le partage monté avec les autorisations prévues. Une application 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 fonctionnel. Décidez si vous souhaitez une petite mémoire tampon locale pour les enregistrements ou si des enregistrements manqués pendant une interruption du NAS sont acceptables.
Surveillez l’espace libre et la rétention
Les vidéos remplissent rapidement l’espace de stockage. Définissez soigneusement les règles de rétention et de nettoyage automatique, et 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 que le chemin de cet hôte est monté en tant que volume dans le répertoire des enregistrements d’Agent.
Un seul conteneur peut-il gérer plusieurs caméras ?
Le modèle actuel d’Agent est conçu pour utiliser une instance d’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, par exemple 8080.



