Feilsøking og kameraoppsett på fregatt

Å sette opp et videoovervåkingssystem med Frigate lar deg oppdage personer, kjøretøy og andre objekter uten å sende opptak til skyen. Under installasjonen er det imidlertid ganske vanlig å støte på en kamera som ikke viser et bilde, en direktestrømming som kutter ut, eller meldinger som indikerer at FFmpeg ikke kan motta rammer.

Disse feilene er vanligvis ikke relatert til kunstig intelligens. I de fleste tilfeller ligger årsaken i en Feil RTSP-URLUgyldige påloggingsinformasjoner, en inkompatibel strømming, et nettverksproblem eller en feil i Frigate-konfigurasjonen kan være årsaken. Den raskeste måten å feilsøke på er å sjekke hver komponent separat: først kameraet, deretter strømmingen, deretter Frigate, og til slutt tilleggstjenester som go2rtc, MQTT eller Home Assistant.

Først, sjekk kameratilkoblingen.

Før du endrer konfigurasjonsfilen, må du bekrefte at kameraet fungerer uavhengig. Fregatt trenger tilgang til en kompatibel strømming, vanligvis via RTSPselv om noen modeller bruker andre formater som HTTP-FLV.

Gå inn i kameraets app eller administrasjonspanel og bekreft at lokal tilgang, RTSP eller ONVIF er aktivert. Noen produsenter krever også at du oppretter en spesifikk konto for eksterne applikasjoner, forskjellig fra den som brukes for å få tilgang til skytjenestene deres.

Det anbefales også å tilordne en statisk IP-adresse til kameraet fra ruteren din. Hvis adressen endres etter en omstart, vil Frigate fortsette å prøve å koble til den gamle IP-adressen, og videoen vil slutte å virke.

Strømmens retning har vanligvis en struktur som ligner på denne:

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

Den nøyaktige stien avhenger av produsent og modell. For å sjekke om den er riktig, åpne URL-en fra VLC eller ffplayHvis det heller ikke fungerer på disse spillerne, er det ikke verdt å tukle med Frigate ennå: du må sjekke IP-adressen, porten, påloggingsinformasjonen og stien som kameraet har oppgitt.

Hvis passordet inneholder tegn som @, #, : o /Disse kan ødelegge URL-en. I så fall, bruk miljøvariabler som er kompatible med Frigate eller kod spesialtegnene riktig.

Legg til kameraet ved hjelp av fregattveiviseren

I nåværende versjoner anbefales det å bruke veiviseren som er inkludert i grensesnittet for å legge til et kamera. Gå til Innstillinger > Global konfigurasjon > Kameraadministrasjon og velg Legg til kamera.

Veiviseren lar deg angi IP-adressen og påloggingsinformasjonen, søke etter profiler ved hjelp av ONVIF eller angi RTSP-URL-en manuelt. Deretter tester den hver strøm, viser et skjermbilde og lar deg tilordne funksjonene.

• oppdage: strøm som brukes til å oppdage bevegelse og objekter.
• rekord: strøm hvis segmenter vil bli lagret som opptak.
• lyd: strøm som brukes til lyddeteksjon.

Det vanlige er å bruke delstrøm med lavere oppløsning for å oppdage og hovedstrømmen for opptak. På denne måten analyserer Frigate et lysere bilde, men bevarer opptakene med originalkvaliteten.

Assistenten oppdager også vanlige problemer, som for høy oppløsning for deteksjon, fravær av en strøm med rollen detect eller en inkompatibel lydkodek.

Se gjennom YAML-konfigurasjonen og rollene til hver strøm

Du kan også konfigurere kameraene manuelt ved hjelp av YAML. Dette formatet bruker innrykk for å representere strukturen, slik at Du bør ikke bruke faner og bland heller ikke forskjellige mengder mellomrom.

Et grunnleggende oppsett med to strømmer kan se slik ut:

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

Stiene er bare eksempler og bør erstattes med de som tilsvarer kameraet ditt. Passordet kan lagres i en variabel hvis navn begynner med FRIGATE_unngå å la den ligge direkte eksponert i filen.

I stedet for å stole utelukkende på en generisk YAML-validator, bruk FregattkonfigurasjonsredigererEn ekstern validator kan oppdage innrykksfeil, men den vet ikke om en bestemt nøkkel finnes eller er kompatibel med den installerte versjonen.

Hva du skal gjøre hvis feilen «ingen rammer» vises

Meldinger som "Kan ikke lese rammer fra ffmpeg-prosessen" o «Ingen rammer er mottatt» De indikerer at prosessen som er ansvarlig for å ta opp videoen ikke leverer bilder til Fregate.

Åpne loggene fra systemdelen og finn linjene som tilsvarer det berørte kameraet. De vanligste årsakene er:

• Kameraets IP-adresse har endret seg.
• Brukernavnet eller passordet er feil.
• RTSP-ruten tilhører en annen kameramodell.
• Fastvaren begrenser antall samtidige tilkoblinger.
• Kameraet mister WiFi-dekning eller starter strømmingen på nytt.
• En inkompatibel videoakselerasjon er konfigurert.
• Kodeken eller parameterne som sendes ut av kameraet er ikke gyldige.

Hvis du bruker go2rtc, sjekk også statusen til strømmingene fra /api/go2rtc/streamsDette lar deg sjekke om go2rtc kan koble til kameraet og hvilke kodeker det mottar.

Når et kamera tilbyr flere transportprotokoller, kan testing av RTSP over TCP forbedre stabiliteten i nettverk der pakketap oppstår. Imidlertid er en Ethernet-tilkobling fortsatt å foretrekke fremfor Wi-Fi for kameraer som kontinuerlig overfører video.

Videoen fungerer, men Frigate lagrer ikke opptakene.

At bildet vises live betyr ikke at opptakene er riktig konfigurert. For å lagre video må tre betingelser være oppfylt: en strøm med rollen må finnes. record, opptak må være aktivert og en oppbevaringspolicy må være definert.

Den eldgamle nøkkelen retain_days Dette bør ikke brukes i nåværende konfigurasjoner. For å lagre hele videoen over tre dager, er riktig struktur:

record:
  enabled: true
  continuous:
    days: 3

Hvis du foretrekker å redusere diskbruken og bare beholde data fra perioder der det var bevegelse, kan du bruke:

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

Opptakene er lagret i /media/frigate/recordingsKontroller at volumet er montert på riktig sted, har skriverettigheter og tilstrekkelig plass. Feil montering kan føre til at Frigate ved et uhell skriver til systemdisken og fyller den raskt opp.

Du bør også vurdere kodeken. H.265-opptak fungerer ikke i alle nettlesere, mens H.264 tilbyr mye bedre kompatibilitet. Hvis filene finnes, men ikke spilles av fra grensesnittet, kan problemet ligge i nettleseren, ikke kameraet.

Integrasjon med Home Assistant og MQTT

For å integrere Frigate med Home Assistant må du installere Frigate-integrasjonen og konfigurere MQTT-integrasjonen på forhånd. I tillegg må begge systemene være koblet til samme MQTT-megler slik at mange av enhetene, sensorene og tellerne fungerer som de skal.

En grunnleggende konfigurasjon ville være:

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

Når du legger til Home Assistant-integrasjonen, må du også angi den interne Frigate-URL-en. Porten kan brukes. 5000som ikke inkluderer autentisering, eller 8971som tilbyr autentisert tilgang. Port 5000 bør kun eksponeres innenfor et klarert nettverk.

For direktesendt video er det nyttig å skille mellom to porter:

• 8554: RTSP-restreaming levert av go2rtc.
• 8555 TCP og UDP: WebRTC-tilkoblinger.

Restreamen kan åpnes med en adresse som rtsp://IP_DEL_SERVIDOR:8554/nombre_streamHvis Home Assistant er på et annet nettverk, et annet VLAN eller bak bestemte proxyer, må WebRTC kanskje konfigureres som en kandidat. Fregattserverens faktiske adresse som er tilgjengelig fra klientenheten.

En HTTP reverse proxy som Traefik kan brukes til å få tilgang til webgrensesnittet, men den erstatter ikke eksponeringen av portene som brukes direkte av RTSP eller WebRTC.

Reduser CPU-bruken riktig

Fregatt utfører flere forskjellige oppgaver, og hver enkelt kan bruke en annen komponent. videodekoding Dette tilsvarer FFmpeg og kan akselereres med en integrert eller dedikert GPU. objektdeteksjonI stedet bruker den en detektor som Coral, Hailo, OpenVINO, ONNX eller TensorRT.

En Coral USB kan redusere arbeidet som kreves for å kjøre deteksjonsmodellen betraktelig, men den øker ikke iboende hastigheten på strømdekoding. For å gjøre det må du konfigurere en forhåndsinnstilling av hwaccel_args kompatibel med servermaskinvare.

For eksempel kan mange kompatible Intel- og AMD-systemer bruke:

ffmpeg:
  hwaccel_args: preset-vaapi

Du bør ikke kopiere denne verdien uten å bekrefte kompatibiliteten med utstyret ditt. Feil konfigurasjon kan føre til at FFmpeg krasjer gjentatte ganger, ettersom det ikke alltid skjer en automatisk programvareutskifting når den valgte akselerasjonen feiler.

Unngå dessuten å tolke Frigates CPU-brukstall som at de representerer hele prosessoren. I statistikken deres betyr en 100 % prosess vanligvis at den bruker hele prosessoren. en enkelt kjerneFor å finne ut det totale forbruket, sammenlign dataene med docker stats eller med vertssystemskjermen.

For å redusere belastningen uten å påvirke opptakene:

• Bruk en understrøm til detect.
• Sett vanligvis deteksjonen til rundt 5 FPS.
• Reserver høyoppløselig strømming for record.
• Aktiver kompatibel maskinvaredekoding.
• Bruk en passende detektor i stedet for test-CPU-detektoren.
• Unngå å åpne flere unødvendige tilkoblinger til samme kamera.

Sjekkliste hvis et kamera fortsatt ikke fungerer

1. Sjekk at kameraet svarer på IP-adressen sin.
2. Bekreft den nøyaktige URL-en med VLC eller ffplay.
3. Bekreft at RTSP eller ONVIF er aktivert på kameraet.
4. Sjekk brukernavn, passord, port og spesialtegn.
5. Prøv å strømme fra veiviseren for å legge til kamera i Fregate.
6. Sjekk rollene detect y record.
7. Sjekk FFmpeg- og capture-loggene.
8. Deaktiver midlertidig hwaccel_args hvis FFmpeg starter på nytt.
9. Sjekk go2rtc-strømmene og navnene som brukes i restreamingen.
10. Sjekk plassen, oppsettet og tillatelsene til /media/frigate.
11. Bekreft at Frigate og Home Assistant bruker samme MQTT-megler.
12. Sørg for at portene 8554 og 8555 er riktig eksponert hvis du trenger RTSP eller WebRTC.

Ved å følge denne rekkefølgen unngår du å endre flere alternativer samtidig, og du kan finne ut nøyaktig hvor strømmen blir avbrutt. Hvis kameraet fungerer i VLC, strømmen vises riktig i go2rtc, og FFmpeg ikke viser noen feil, er problemet vanligvis relatert til roller, opptakslagring eller integrasjonen som brukes til å vise videoen.

En stabil konfigurasjon avhenger av å separere hver funksjon på riktig måte: en lett strøm for bildeanalyse, en strøm av høyere kvalitet for opptak, dedikert akselerasjon for dekoding og en passende detektor for kunstig intelligens. Med denne strukturen kan Frigate operere i lengre perioder uten avbrudd eller overdrevent ressursforbruk.