Fehlerbehebung und Kameraeinrichtung auf der Fregatte

Die Einrichtung eines Videoüberwachungssystems mit Frigate ermöglicht die Erkennung von Personen, Fahrzeugen und anderen Objekten, ohne Aufnahmen in die Cloud zu übertragen. Bei der Installation tritt jedoch häufig ein Problem auf. Kamera, die kein Bild anzeigt, ein Livestream, der abbricht, oder Meldungen, die darauf hinweisen, dass FFmpeg keine Frames empfangen kann.

Diese Fehler stehen in der Regel nicht im Zusammenhang mit künstlicher Intelligenz. In den meisten Fällen liegt die Ursache in einem Falsche RTSP-URLUngültige Anmeldeinformationen, ein inkompatibler Stream, ein Netzwerkproblem oder ein Fehler in der Frigate-Konfiguration könnten die Ursache sein. Am schnellsten lässt sich das Problem beheben, indem man jede Komponente einzeln überprüft: zuerst die Kamera, dann den Stream, dann Frigate und schließlich zusätzliche Dienste wie go2rtc, MQTT oder Home Assistant.

Überprüfen Sie zuerst die Kameraverbindung.

Bevor Sie die Konfigurationsdatei ändern, überprüfen Sie, ob die Kamera eigenständig funktioniert. Frigate benötigt Zugriff auf einen kompatiblen Stream, üblicherweise über … RTSPobwohl einige Modelle andere Formate wie HTTP-FLV verwenden.

Öffnen Sie die Kamera-App oder das Admin-Panel und prüfen Sie, ob der lokale Zugriff, RTSP oder ONVIF aktiviert ist. Einige Hersteller verlangen außerdem die Erstellung eines Kontos. spezifisches Konto für externe Anwendungen, anders als diejenige, die für den Zugriff auf die Cloud-Dienste verwendet wird.

Es wird außerdem empfohlen, der Kamera vom Router eine statische IP-Adresse zuzuweisen. Ändert sich die Adresse nach einem Neustart, versucht Frigate weiterhin, eine Verbindung zur alten IP-Adresse herzustellen, und die Videoübertragung funktioniert nicht mehr.

Die Strömungsrichtung weist üblicherweise eine ähnliche Struktur auf wie diese:

rtsp://usuario:contraseñ[email protected]:554/ruta_del_stream

Der genaue Pfad hängt vom Hersteller und Modell ab. Um zu überprüfen, ob er korrekt ist, öffnen Sie die URL von VLC oder ffplayWenn es auch auf diesen Playern nicht funktioniert, lohnt es sich noch nicht, sich mit Frigate zu beschäftigen: Sie müssen die von der Kamera bereitgestellte IP-Adresse, den Port, die Zugangsdaten und den Pfad überprüfen.

Wenn das Passwort Zeichen wie @, #, : o /Diese können die URL beschädigen. Verwenden Sie in diesem Fall Umgebungsvariablen, die mit Frigate kompatibel sind, oder kodieren Sie die Sonderzeichen korrekt.

Fügen Sie die Kamera mithilfe des Frigate-Assistenten hinzu.

In den aktuellen Versionen wird empfohlen, zum Hinzufügen einer Kamera den in der Benutzeroberfläche integrierten Assistenten zu verwenden. Gehen Sie zu Einstellungen > Globale Konfiguration > Kameraverwaltung und auswählen Kamera hinzufügen.

Der Assistent ermöglicht die Eingabe der IP-Adresse und der Anmeldeinformationen, die Suche nach Profilen mithilfe von ONVIF oder die manuelle Eingabe der RTSP-URL. Anschließend testet er jeden Stream, zeigt einen Screenshot an und erlaubt die Zuweisung der Funktionen.

• erkennen: Datenstrom zur Erkennung von Bewegungen und Objekten.
• aufzeichnen: Stream, dessen Segmente als Aufnahmen gespeichert werden.
• Audio: Für die Geräuscherkennung wird ein Datenstrom verwendet.

Üblicherweise verwendet man die niedrigere Auflösung des Substreams zur Erkennung und dem Hauptstrom für die Aufzeichnung. Auf diese Weise analysiert Frigate ein helleres Bild, bewahrt aber die Aufnahmen in Originalqualität.

Der Assistent erkennt auch häufige Probleme, wie z. B. eine zu hohe Auflösung bei der Erkennung oder das Fehlen eines Datenstroms mit der entsprechenden Rolle. detect oder ein inkompatibler Audio-Codec.

Überprüfen Sie die YAML-Konfiguration und die Rollen jedes Streams.

Sie können die Kameras auch manuell mithilfe von YAML konfigurieren. Dieses Format verwendet Einrückungen, um die Struktur darzustellen, Sie sollten keine Tabulatoren verwenden. auch nicht unterschiedliche Raumgrößen mischen.

Ein einfacher Aufbau mit zwei Datenströmen könnte folgendermaßen aussehen:

mqtt:
  enabled: false

record:
  enabled: true
  continuous:
    days: 3

cameras:
  entrada:
    ffmpeg:
      inputs:
        - path: rtsp://usuario:{FRIGATE_RTSP_PASSWORD}@192.168.1.50:554/substream
          roles:
            - detect
        - path: rtsp://usuario:{FRIGATE_RTSP_PASSWORD}@192.168.1.50:554/mainstream
          roles:
            - record
    detect:
      width: 1280
      height: 720
      fps: 5

Die Pfade sind nur Beispiele und sollten durch die Pfade Ihrer Kamera ersetzt werden. Das Passwort kann in einer Variablen gespeichert werden, deren Name mit „password“ beginnt. FRIGATE_vermeiden, dass es direkt in der Datei offengelegt wird.

Anstatt sich ausschließlich auf einen generischen YAML-Validator zu verlassen, verwenden Sie den Frigate-KonfigurationseditorEin externer Validator kann Einrückungsfehler erkennen, weiß aber nicht, ob ein bestimmter Schlüssel existiert oder mit der installierten Version kompatibel ist.

Was tun, wenn die Fehlermeldung „Keine Frames“ erscheint?

Nachrichten wie „Frames konnten vom ffmpeg-Prozess nicht gelesen werden“ o „Es sind keine Rahmen eingegangen.“ Sie deuten darauf hin, dass der für die Videoaufnahme zuständige Prozess keine Bilder an Frigate liefert.

Öffnen Sie die Protokolle im Systembereich und suchen Sie die Zeilen, die der betroffenen Kamera entsprechen. Die häufigsten Ursachen sind:

• Die IP-Adresse der Kamera hat sich geändert.
• Der Benutzername oder das Passwort ist falsch.
• Die RTSP-Route gehört zu einem anderen Kameramodell.
• Die Firmware begrenzt die Anzahl gleichzeitiger Verbindungen.
• Die Kamera verliert die WLAN-Verbindung oder startet den Stream neu.
• Es wurde eine inkompatible Videobeschleunigung konfiguriert.
• Der von der Kamera ausgegebene Codec oder die Parameter sind ungültig.

Wenn Sie go2rtc verwenden, überprüfen Sie auch den Status der Streams von /api/go2rtc/streamsDies ermöglicht es Ihnen zu überprüfen, ob go2rtc eine Verbindung zur Kamera herstellen kann und welche Codecs empfangen werden.

Unterstützt eine Kamera mehrere Transportprotokolle, kann das Testen von RTSP über TCP die Stabilität in Netzwerken mit Paketverlusten verbessern. Für Kameras, die kontinuierlich Videos übertragen, ist eine Ethernet-Verbindung jedoch weiterhin WLAN vorzuziehen.

Die Videoaufnahme funktioniert, aber Frigate speichert keine Aufnahmen.

Dass das Bild live angezeigt wird, bedeutet nicht, dass die Aufnahmen korrekt konfiguriert sind. Zum Speichern von Videos müssen drei Bedingungen erfüllt sein: Es muss ein Stream mit der entsprechenden Rolle vorhanden sein. recordDie Aufzeichnung muss aktiviert sein und eine Aufbewahrungsrichtlinie muss definiert worden sein.

Der uralte Schlüssel retain_days Dies sollte in den aktuellen Konfigurationen nicht verwendet werden. Um das gesamte Video über drei Tage zu speichern, ist folgende Struktur korrekt:

record:
  enabled: true
  continuous:
    days: 3

Wenn Sie die Festplattennutzung reduzieren und nur Daten aus Zeiträumen speichern möchten, in denen Bewegungen stattgefunden haben, können Sie Folgendes verwenden:

record:
  enabled: true
  motion:
    days: 3
  alerts:
    retain:
      days: 10
      mode: motion
  detections:
    retain:
      days: 10
      mode: motion

Die Aufnahmen werden gespeichert innerhalb /media/frigate/recordingsStellen Sie sicher, dass das Volume am richtigen Ort eingebunden ist, Schreibrechte besitzt und über ausreichend Speicherplatz verfügt. Eine fehlerhafte Einbindung kann dazu führen, dass Frigate versehentlich auf die Systemfestplatte schreibt und diese schnell füllt.

Sie sollten auch den Codec berücksichtigen. H.265-Aufnahmen funktionieren nicht in allen Browsern, während H.264 eine deutlich höhere Kompatibilität bietet. Wenn die Dateien vorhanden sind, aber nicht über die Benutzeroberfläche abgespielt werden können, liegt das Problem möglicherweise am Browser und nicht an der Kamera.

Integration mit Home Assistant und MQTT

Um Frigate in Home Assistant zu integrieren, müssen Sie die Frigate-Integration installieren und die MQTT-Integration im Voraus konfigurieren. Außerdem müssen beide Systeme mit dem Netzwerk verbunden sein. derselbe MQTT-Broker damit viele der Entitäten, Sensoren und Zähler ordnungsgemäß funktionieren.

Eine Basiskonfiguration sähe folgendermaßen aus:

mqtt:
  enabled: true
  host: 192.168.1.20
  user: frigate
  password: "{FRIGATE_MQTT_PASSWORD}"

Beim Hinzufügen der Home Assistant-Integration muss auch die interne Frigate-URL angegeben werden. Der Port kann verwendet werden. 5000die keine Authentifizierung beinhaltet, oder die 8971Dies ermöglicht authentifizierten Zugriff. Port 5000 sollte nur innerhalb eines vertrauenswürdigen Netzwerks freigegeben werden.

Für Live-Video ist es sinnvoll, zwischen zwei Anschlüssen zu unterscheiden:

• 8554: RTSP-Restream bereitgestellt von go2rtc.
• 8555 TCP und UDP: WebRTC-Verbindungen.

Der Restream kann mit einer Adresse wie dieser geöffnet werden rtsp://IP_DEL_SERVIDOR:8554/nombre_streamBefindet sich Home Assistant in einem anderen Netzwerk, einem anderen VLAN oder hinter bestimmten Proxys, muss WebRTC gegebenenfalls als Option konfiguriert werden. tatsächliche Adresse des Frigate-Servers das vom Clientgerät aus zugänglich ist.

Ein HTTP-Reverse-Proxy wie Traefik kann verwendet werden, um auf die Weboberfläche zuzugreifen, ersetzt aber nicht die direkte Freigabe der von RTSP oder WebRTC verwendeten Ports.

Reduzieren Sie die CPU-Auslastung korrekt

Die Frigate erfüllt mehrere verschiedene Aufgaben, und für jede dieser Aufgaben werden möglicherweise unterschiedliche Komponenten benötigt. Videodekodierung Dies entspricht FFmpeg und kann mit einer integrierten oder dedizierten GPU beschleunigt werden. ObjekterkennungStattdessen wird ein Detektor wie Coral, Hailo, OpenVINO, ONNX oder TensorRT verwendet.

Ein Coral USB kann den Aufwand für die Ausführung des Erkennungsmodells erheblich reduzieren, beschleunigt aber nicht prinzipiell die Stream-Dekodierung. Dafür müssen Sie eine Voreinstellung konfigurieren. hwaccel_args kompatibel mit Serverhardware.

Viele kompatible Intel- und AMD-Systeme können beispielsweise Folgendes verwenden:

ffmpeg:
  hwaccel_args: preset-vaapi

Sie sollten diesen Wert nicht kopieren, ohne vorher die Kompatibilität mit Ihrer Hardware zu prüfen. Eine fehlerhafte Konfiguration kann zu wiederholten Abstürzen von FFmpeg führen, da bei einem Fehler der gewählten Beschleunigung nicht immer automatisch ein Softwareersatz erfolgt.

Außerdem sollten Sie die CPU-Auslastungszahlen von Frigate nicht als vollständige Prozessorauslastung interpretieren. Laut deren Statistik bedeutet eine 100%ige CPU-Auslastung in der Regel, dass der gesamte Prozessor ausgelastet ist. ein einzelner KernUm den Gesamtverbrauch zu ermitteln, vergleichen Sie die Daten mit docker stats oder mit dem Host-Systemmonitor.

Um die Last zu reduzieren, ohne die Aufnahmen zu beeinträchtigen:

• Verwenden Sie einen Unterstrom, um detect.
• Stellen Sie die Erkennung auf etwa 5 FPS ein.
• Reservieren Sie den hochauflösenden Stream für record.
• Aktivieren Sie die kompatible Hardware-Dekodierung.
• Verwenden Sie einen geeigneten Detektor anstelle des Test-CPU-Detektors.
• Vermeiden Sie es, mehrere unnötige Verbindungen zur selben Kamera herzustellen.

Checkliste, falls die Kamera immer noch nicht funktioniert

1. Prüfen Sie, ob die Kamera unter ihrer IP-Adresse antwortet.
2. Überprüfen Sie die genaue URL mit VLC oder ffplay.
3. Vergewissern Sie sich, dass RTSP oder ONVIF auf der Kamera aktiviert ist.
4. Überprüfen Sie Benutzername, Passwort, Port und Sonderzeichen.
5. Versuchen Sie, über den Frigate-Kamera-Hinzufügeassistenten zu streamen.
6. Überprüfen Sie die Rollen detect y record.
7. Überprüfen Sie die FFmpeg- und Aufnahmeprotokolle.
8. Vorübergehend deaktivieren hwaccel_args wenn FFmpeg neu startet.
9. Überprüfen Sie die go2rtc-Streams und die im Restream verwendeten Namen.
10. Überprüfen Sie die Räumlichkeiten, die Einrichtung und die Genehmigungen. /media/frigate.
11. Vergewissern Sie sich, dass Frigate und Home Assistant denselben MQTT-Broker verwenden.
12. Die Ports 8554 und 8555 müssen korrekt freigegeben werden, wenn RTSP oder WebRTC benötigt wird.

Durch diese Vorgehensweise vermeiden Sie, mehrere Optionen gleichzeitig zu ändern, und können genau feststellen, wo der Stream unterbrochen wird. Wenn die Kamera in VLC funktioniert, der Stream in go2rtc korrekt angezeigt wird und FFmpeg keine Fehler meldet, liegt das Problem üblicherweise an den Kamerarollen, der Aufzeichnungsspeicherung oder der verwendeten Videointegration.

Eine stabile Konfiguration erfordert die korrekte Trennung der einzelnen Funktionen: einen ressourcenschonenden Datenstrom für die Bildanalyse, einen qualitativ hochwertigeren Datenstrom für die Aufzeichnung, eine dedizierte Beschleunigung für die Dekodierung und einen geeigneten Detektor für die künstliche Intelligenz. Mit dieser Struktur kann Frigate über längere Zeiträume ohne Unterbrechungen oder übermäßigen Ressourcenverbrauch betrieben werden.