Depanare și configurare cameră pe Frigate

Configurarea unui sistem de supraveghere video cu Frigate vă permite să detectați persoane, vehicule și alte obiecte fără a trimite înregistrări în cloud. Cu toate acestea, în timpul instalării, este destul de frecvent să întâlniți... cameră care nu afișează o imagine, o transmisiune live care se întrerupe sau mesaje care indică faptul că FFmpeg nu poate primi cadre.

Aceste eșecuri nu sunt de obicei legate de inteligența artificială. În majoritatea cazurilor, originea se află într-un URL RTSP incorectCauza ar putea fi acreditări nevalide, un flux incompatibil, o problemă de rețea sau o eroare în configurația Frigate. Cea mai rapidă modalitate de depanare este să verificați fiecare componentă separat: mai întâi camera, apoi fluxul, apoi Frigate și, în final, servicii suplimentare precum go2rtc, MQTT sau Home Assistant.

Mai întâi, verificați conexiunea camerei.

Înainte de a modifica fișierul de configurare, verificați dacă camera funcționează independent. Frigate are nevoie de acces la un flux compatibil, de obicei prin RTSPdeși unele modele utilizează alte formate precum HTTP-FLV.

Accesați aplicația sau panoul de administrare al camerei și verificați dacă este activat accesul local, RTSP sau ONVIF. Unii producători solicită, de asemenea, crearea unui cont specific pentru aplicații externe, diferit de cel utilizat pentru accesarea serviciilor sale cloud.

De asemenea, este recomandat să atribuiți camerei o adresă IP statică de la router. Dacă adresa acesteia se schimbă după o repornire, Frigate va continua să încerce să se conecteze la vechea adresă IP, iar semnalul video va înceta să funcționeze.

Direcția fluxului are de obicei o structură similară cu aceasta:

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

Calea exactă depinde de producător și model. Pentru a verifica dacă este corectă, deschideți adresa URL de la VLC sau ffplayDacă nici pe aceste playere nu funcționează, nu merită să te joci încă cu Frigate: va trebui să verifici adresa IP, portul, acreditările și calea furnizate de cameră.

Dacă parola conține caractere precum @, #, : o /Acestea pot deteriora URL-ul. În acest caz, utilizați variabile de mediu compatibile cu Frigate sau codificați corect caracterele speciale.

Adăugați camera folosind expertul Frigate

În versiunile actuale, modul recomandat pentru a adăuga o cameră este utilizarea expertului inclus în interfață. Accesați Setări > Configurare globală > Gestionare cameră și selectați Adăugați o cameră.

Expertul vă permite să introduceți adresa IP și acreditările, să căutați profiluri folosind ONVIF sau să introduceți manual adresa URL RTSP. Apoi testează fiecare flux, afișează o captură de ecran și vă permite să îi atribuiți funcțiile.

• detecta: flux utilizat pentru detectarea mișcării și a obiectelor.
• înregistra: flux ale cărui segmente vor fi salvate ca înregistrări.
• audio: flux utilizat pentru detectarea sunetului.

Lucrul obișnuit este să folosești subflux cu rezoluție mai mică pentru detectare și fluxul principal pentru înregistrare. În acest fel, Frigate analizează o imagine mai deschisă la culoare, dar păstrează înregistrările la calitatea originală.

Asistentul detectează, de asemenea, probleme comune, cum ar fi rezoluția excesivă pentru detectare, absența unui flux cu rolul detect sau un codec audio incompatibil.

Revizuiți configurația YAML și rolurile fiecărui flux

De asemenea, puteți configura camerele manual folosind YAML. Acest format folosește indentarea pentru a reprezenta structura, deci Nu ar trebui să folosiți tab-uri nici să amestecați cantități diferite de spații.

O configurație de bază cu două fluxuri ar putea arăta astfel:

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

Căile sunt doar exemple și ar trebui înlocuite cu cele corespunzătoare camerei dvs. Parola poate fi stocată într-o variabilă al cărei nume începe cu FRIGATE_evitând să fie expusă direct în fișier.

În loc să vă bazați exclusiv pe un validator YAML generic, utilizați Editor de configurare a fregateiUn validator extern poate detecta erori de indentare, dar nu știe dacă o cheie specifică există sau este compatibilă cu versiunea instalată.

Ce trebuie făcut dacă apare eroarea „fără cadre”

Mesaje precum „Nu se pot citi cadrele din procesul ffmpeg” o „Nu s-au primit cadre” Acestea indică faptul că procesul responsabil pentru capturarea videoclipului nu livrează imagini către Frigate.

Deschideți jurnalele din secțiunea de sistem și localizați liniile corespunzătoare camerei afectate. Cele mai frecvente cauze sunt:

• Adresa IP a camerei s-a schimbat.
• Numele de utilizator sau parola sunt incorecte.
• Ruta RTSP aparține unui alt model de cameră.
• Firmware-ul limitează numărul de conexiuni simultane.
• Camera pierde acoperirea WiFi sau repornește transmisia.
• A fost configurată o accelerare video incompatibilă.
• Codecul sau parametrii emiși de cameră nu sunt valizi.

Dacă folosești go2rtc, verifică și starea fluxurilor de la /api/go2rtc/streamsAcest lucru vă permite să verificați dacă go2rtc se poate conecta la cameră și ce codecuri primește.

Când o cameră oferă mai multe protocoale de transport, testarea RTSP prin TCP poate îmbunătăți stabilitatea în rețelele în care are loc pierderea de pachete. Cu toate acestea, o conexiune Ethernet rămâne preferabilă Wi-Fi-ului pentru camerele care transmit continuu semnal video.

Videoclipul funcționează, dar Frigate nu salvează înregistrările.

Faptul că imaginea apare live nu înseamnă că înregistrările sunt configurate corect. Pentru a salva videoclipul, trebuie îndeplinite trei condiții: trebuie să existe un flux cu rolul respectiv. record, înregistrarea trebuie să fie activată și trebuie să fi fost definită o politică de păstrare.

Cheia antică retain_days Această funcție nu ar trebui utilizată în configurațiile actuale. Pentru a salva întregul videoclip pe parcursul a trei zile, structura corectă este:

record:
  enabled: true
  continuous:
    days: 3

Dacă preferați să reduceți utilizarea discului și să păstrați datele doar din perioadele în care au existat mișcări, puteți utiliza:

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

Înregistrările sunt stocate în /media/frigate/recordingsVerificați dacă volumul este montat în locația corectă, are permisiuni de scriere și spațiu suficient. O montare incorectă poate face ca Frigate să scrie accidental pe discul de sistem și să îl umple rapid.

Ar trebui să luați în considerare și codecul. Înregistrările H.265 nu funcționează în toate browserele, în timp ce H.264 oferă o compatibilitate mult mai mare. Dacă fișierele există, dar nu sunt redate din interfață, problema ar putea fi la browser, nu la cameră.

Integrare cu Home Assistant și MQTT

Pentru a integra Frigate cu Home Assistant, trebuie să instalați în prealabil integrarea Frigate și să configurați integrarea MQTT. În plus, ambele sisteme trebuie să fie conectate la același broker MQTT astfel încât multe dintre entități, senzori și contoare să funcționeze corect.

O configurație de bază ar fi:

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

Când adăugați integrarea Home Assistant, trebuie să specificați și adresa URL internă Frigate. Portul poate fi utilizat. 5000care nu include autentificarea sau 8971care oferă acces autentificat. Portul 5000 ar trebui expus doar într-o rețea de încredere.

Pentru transmisia video în direct, este util să se facă distincția între două porturi:

• 8554: Retransmisia RTSP este oferită de go2rtc.
• 8555 TCP și UDP: Conexiuni WebRTC.

Restream-ul poate fi deschis cu o adresă de genul rtsp://IP_DEL_SERVIDOR:8554/nombre_streamDacă Home Assistant se află pe o altă rețea, un alt VLAN sau în spatele anumitor proxy-uri, este posibil să fie nevoie să configurați WebRTC ca un candidat. Adresa reală a serverului Frigate care este accesibil de pe dispozitivul clientului.

Un proxy invers HTTP precum Traefik poate fi utilizat pentru a accesa interfața web, dar nu înlocuiește expunerea porturilor utilizate direct de RTSP sau WebRTC.

Reduceți corect utilizarea CPU-ului

Fregata îndeplinește mai multe sarcini diferite, iar fiecare dintre ele poate folosi o componentă diferită. decodare video Aceasta corespunde cu FFmpeg și poate fi accelerată cu un GPU integrat sau dedicat. detectarea obiectelorÎn schimb, folosește un detector precum Coral, Hailo, OpenVINO, ONNX sau TensorRT.

Un dispozitiv Coral USB poate reduce considerabil munca necesară pentru rularea modelului de detectare, dar nu accelerează în mod inerent decodarea fluxului. Pentru aceasta, trebuie să configurați o presetare de hwaccel_args compatibil cu hardware-ul serverului.

De exemplu, multe sisteme Intel și AMD compatibile pot utiliza:

ffmpeg:
  hwaccel_args: preset-vaapi

Nu ar trebui să copiați această valoare fără a verifica compatibilitatea cu echipamentul dumneavoastră. O configurație incorectă poate cauza blocarea repetată a FFmpeg, deoarece nu există întotdeauna o înlocuire automată a software-ului atunci când accelerarea selectată eșuează.

În plus, evitați să interpretați cifrele privind utilizarea procesorului de la Frigate ca reprezentând întregul procesor. În statisticile lor, un proces cu o utilizare de 100% înseamnă de obicei că utilizează întregul procesor. un singur nucleuPentru a afla consumul total, comparați datele cu docker stats sau cu monitorul sistemului gazdă.

Pentru a reduce sarcina fără a afecta înregistrările:

• Folosește un subflux pentru a detect.
• Setați detecția la aproximativ 5 FPS.
• Rezervați fluxul de înaltă rezoluție pentru record.
• Activează decodarea hardware compatibilă.
• Folosiți un detector adecvat în locul detectorului CPU de testare.
• Evitați deschiderea mai multor conexiuni inutile la aceeași cameră.

Listă de verificare dacă o cameră încă nu funcționează

1. Verificați dacă camera răspunde la adresa sa IP.
2. Verificați adresa URL exactă folosind VLC sau ffplay.
3. Confirmați că RTSP sau ONVIF este activat pe cameră.
4. Verificați numele de utilizator, parola, portul și caracterele speciale.
5. Încearcă să transmiți în flux continuu din expertul de adăugare a camerei Frigate.
6. Verificați rolurile detect y record.
7. Verificați jurnalele FFmpeg și de captură.
8. Dezactivați temporar hwaccel_args dacă FFmpeg repornește.
9. Verificați fluxurile go2rtc și numele utilizate în redirecționare.
10. Verificați spațiul, amenajarea și autorizațiile /media/frigate.
11. Verificați dacă Frigate și Home Assistant utilizează același broker MQTT.
12. Expuneți corect porturile 8554 și 8555 dacă aveți nevoie de RTSP sau WebRTC.

Respectarea acestei ordini evită schimbarea mai multor opțiuni simultan și vă permite să identificați unde este întrerupt fluxul. Dacă camera funcționează în VLC, fluxul apare corect în go2rtc și FFmpeg nu afișează erori, problema este de obicei legată de roluri, păstrarea înregistrării sau integrarea utilizată pentru afișarea videoclipului.

O configurație stabilă depinde de separarea corectă a fiecărei funcții: un flux ușor pentru analiza imaginilor, un flux de calitate superioară pentru înregistrare, o accelerare dedicată pentru decodare și un detector adecvat pentru inteligența artificială. Cu această structură, Frigate poate funcționa pentru perioade lungi de timp fără întreruperi sau consum excesiv de resurse.