Community-Lösung

Agent DVR mit Docker Compose auf ZimaOS installieren

A new ZimaOS user imported Agent DVR's Docker CLI command and manually created AppData folders before adding the first camera.

Agent DVR kann unter ZimaOS als benutzerdefinierte Docker-App ausgeführt werden. Am einfachsten richtest du es ein, indem du das aktuelle Agent-DVR-Docker-Image verwendest, Konfiguration und Aufzeichnungen einem persistenten ZimaOS-Speicher zuordnest, die Weboberfläche über Port 8090 verfügbar machst und TURN-/WebRTC-UDP-Ports nur hinzufügst, wenn dein Kamera-/Client-Workflow sie benötigt.

Der ursprüngliche Nutzer konnte den Docker-Befehl des Anbieters erfolgreich importieren, musste die AppData-Ordner jedoch manuell erstellen. Die aktuelle Dokumentation zu Agent-DVR-Containern macht die erforderlichen persistenten Pfade und GPU-Gerätezuordnungen nun viel klarer.

Docker-Run-Befehl auf der Agent-DVR-Website mit Port 8090 und persistenten Medienpfaden
Der Community-Nutzer kopierte den veröffentlichten Docker-Befehl von Agent DVR als Ausgangspunkt für eine benutzerdefinierte ZimaOS-App. Quelle: IceWhale Community Forum.
Importdialog für Docker-CLI-Befehle einer benutzerdefinierten ZimaOS-App für Agent DVR
ZimaOS kann den Docker-CLI-Befehl von Agent DVR importieren, aber die AppData-Pfade auf dem Host müssen weiterhin korrekt eingebunden werden. Quelle: IceWhale Community Forum.

Einen aktuellen Agent-DVR-Container verwenden

Der aktuelle Docker-Leitfaden zu Agent DVR beschreibt das gepflegte Docker-Layout und den aktuellen WebRTC-Portbereich.

Persistente ZimaOS-Ordner erstellen

/DATA/AppData/agentdvr/config
/DATA/AppData/agentdvr/media
/DATA/AppData/agentdvr/models
/DATA/AppData/agentdvr/commands

Erledige dies, bevor du die App importierst, damit der Container keine wichtige Konfiguration in einem flüchtigen Speicher ablegt.

Aktuelles Volume-Layout verwenden

/DATA/AppData/agentdvr/config:/AgentDVR/Media/XML
/DATA/AppData/agentdvr/media:/AgentDVR/Media/WebServerRoot/Media
/DATA/AppData/agentdvr/models:/AgentDVR/Media/Models
/DATA/AppData/agentdvr/commands:/AgentDVR/Commands

Weboberfläche auf Port 8090 freigeben

Rufen Sie nach dem Start des Containers http://ZIMA-IP:8090 auf. Wenn die Benutzeroberfläche nicht angezeigt wird, prüfen Sie die Container-Protokolle, bevor Sie die Kameraeinstellungen ändern.

UDP-Ports verstehen

Der aktuelle Container-Leitfaden für Agent DVR verwendet UDP-Port 3478 sowie die Ports 50000–50100 für TURN/WebRTC. Wenn Sie das System ausschließlich lokal nutzen und die Benutzeroberfläche auch ohne Remote-WebRTC funktioniert, geben Sie nicht mehr Ports als nötig frei.

Kameras erst hinzufügen, wenn der Container ordnungsgemäß läuft

Beginnen Sie mit einer Kamera und prüfen Sie die Live-Ansicht und den Aufnahmepfad, bevor Sie weitere Geräte hinzufügen. So lassen sich Probleme mit Codecs, Anmeldedaten, Erkennung und Speicher leichter eingrenzen.

GPU-Geräte nur bei Bedarf einbinden

Die Intel-/AMD-Hardwarebeschleunigung verwendet üblicherweise /dev/dri. Für NVIDIA sind die NVIDIA-Laufzeitumgebung und das Toolkit des Hosts erforderlich. Prüfen Sie zunächst, ob die Softwaredekodierung funktioniert, bevor Sie den Container durch GPU-Passthrough komplizierter machen.

Berechtigungen für AppData und Aufnahmen prüfen

Der aktuelle Container unterstützt PUID/PGID. Stimmen Sie diese Werte auf den Besitzer der ZimaOS-Verzeichnisse ab, um schreibgeschützte XML-/Konfigurationsdateien oder fehlgeschlagene Aufnahmen zu vermeiden.

XML vor der Aktualisierung sichern

Agent DVR speichert wichtige Konfigurationen in seinem XML-Verzeichnis. Sichern Sie dieses, bevor Sie Image-Tags oder Hauptversionen ändern.

Der Leitfaden für benutzerdefinierte Apps beschreibt den allgemeinen ZimaOS-Ablauf.

FAQ

Welchen Port verwendet die Agent-DVR-Weboberfläche?

In den aktuellen Container-Beispielen standardmäßig auf Port 8090.

Wo werden Aufnahmen gespeichert?

Binden Sie /AgentDVR/Media/WebServerRoot/Media in ein dauerhaftes Host-Verzeichnis ein.

Benötige ich alle TURN/WebRTC-Ports?

Nicht bei jeder rein lokalen Einrichtung. Fügen Sie sie nur hinzu, wenn Funktionen diese Pfade erfordern.

Kann Agent DVR die GPU-Beschleunigung von Intel oder AMD nutzen?

Ja, wenn die erforderlichen /dev/dri-Geräte und Anwendungseinstellungen korrekt konfiguriert sind.