Kerberos Agent auf ZimaOS mit Synology-Speicher installieren

Verwende den aktuellen Kerberos-Agent-Container auf ZimaOS, nicht das alte, archivierte Image kerberos/kerberos. Das aktuelle Projekt verwendet kerberos/agent, unterstützt AMD64-Docker und ist auf eine Agent-Instanz pro Kamera ausgelegt.

Sollen Aufzeichnungen auf einem Synology NAS gespeichert werden, binde zuerst die Synology-Freigabe zuverlässig in ZimaOS ein und vergewissere dich, dass sie nach einem Neustart weiterhin eingebunden ist. Ermittle anschließend den tatsächlichen Mount-Pfad auf dem Host und binde ihn in das Aufzeichnungsverzeichnis des Agent ein. Verweise Kerberos nicht auf einen Netzwerkpfad, der bei jeder erneuten Verbindung des NAS nicht mehr verfügbar ist.

Das alte Kerberos-Docker-Repository ist archiviert

Das ursprüngliche Docker-Repository von Kerberos Open Source verweist Nutzer inzwischen auf das Repository des neuen Kerberos Agent-Projekts.

Mit dem aktuellen Agent-Image starten

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

Mit dem Host-Port 8080 wird vermieden, Port 80 auf dem ZimaOS-Host zu belegen.

Konfiguration und Aufzeichnungen dauerhaft speichern

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

Die aktuelle Agent-Dokumentation empfiehlt ausdrücklich persistente Volumes für Konfiguration und Aufzeichnungen.

Ein Agent pro Kamera

Kerberos Agent ist als isolierte Instanz für die Kameraverarbeitung konzipiert. Erstelle für mehrere Kameras separate Container mit eindeutigen Namen, Webports und persistenten Verzeichnissen.

Synology mit Bedacht als Ziel für Aufzeichnungen verwenden

Binde zuerst die Synology-SMB/NFS-Freigabe in ZimaOS ein und vergewissere dich, dass sie nach einem Neustart weiterhin eingebunden ist. Ermittle anschließend mit findmnt den tatsächlichen Mount-Pfad auf dem Host. Binde diesen stabilen Host-Pfad unter /home/agent/data/recordings ein.

Konfiguration nicht ausschließlich auf der Synology-Freigabe speichern

Wenn die Agent-Konfiguration lokal auf ZimaOS und die Aufzeichnungen auf der Synology gespeichert werden, kann das den Start zuverlässiger machen. Ist die Synology vorübergehend nicht verfügbar, kann der Agent trotzdem starten und das Speicherproblem ordnungsgemäß melden.

Standardanmeldung ändern

In der aktuellen Dokumentation zu Kerberos Agent werden für eine neu eingerichtete Agent-Instanz weiterhin Standardanmeldedaten genannt. Ändere sie sofort, bevor du die Bereitstellung über einen lokalen Test hinaus nutzt.

RTSP für IP-Kameras verwenden

Kerberos Agent benötigt für die normale Nutzung mit IP-Kameras einen RTSP-Kamerastream im H264-/H265-Format. Überprüfe den Stream unabhängig, bevor du dem Container die Schuld gibst.

Der Leitfaden zu benutzerdefinierten Docker-Anwendungen beschreibt den allgemeinen Ablauf zum Einrichten benutzerdefinierter Apps.

Synology-Einbindung vor der Aufzeichnung testen

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

Vergewissere dich, dass der ZimaOS-Host mit den vorgesehenen Berechtigungen in die eingebundene Freigabe schreiben kann, bevor du sie in Kerberos Agent einbindest. Eine Kamera-App kann ein darunterliegendes SMB-/NFS-Berechtigungsproblem nicht beheben.

Ausfallzeiten von Synology einplanen

Wenn Synology neu startet oder die Netzwerkfreigabe ausfällt, können Agent-Aufzeichnungen fehlschlagen, obwohl der Kamerastream weiterhin funktioniert. Entscheide, ob du einen kleinen lokalen Aufzeichnungspuffer möchtest oder ob fehlende Aufzeichnungen während eines NAS-Ausfalls akzeptabel sind.

Freien Speicherplatz und Aufbewahrungsdauer überwachen

Videos belegen schnell viel Speicherplatz. Lege Aufbewahrungs- und automatische Bereinigungsregeln sorgfältig fest und überwache das Synology-Ziel. Verlasse dich nicht auf ein unbegrenztes Aufzeichnungsverzeichnis auf einem freigegebenen NAS-Volume.

FAQ

Welches Kerberos-Image sollte ich jetzt verwenden?

Verwende das aktuelle Image kerberos/agent. Das alte Projekt kerberos/kerberos ist archiviert.

Können Aufzeichnungen auf Synology gespeichert werden?

Ja, wenn die Synology-Freigabe zuverlässig auf dem ZimaOS-Host eingebunden ist und dieser Hostpfad in das Aufzeichnungsverzeichnis von Agent eingebunden wird.

Kann ein Container mehrere Kameras verwalten?

Das aktuelle Agent-Modell ist auf eine Agent-Instanz pro Kamera ausgelegt.

Welchen Port verwendet die Agent-Benutzeroberfläche?

Der Container lauscht an Port 80. Leite ihn auf einen freien ZimaOS-Hostport wie 8080 weiter.