Αντιμετώπιση προβλημάτων και ρύθμιση κάμερας σε Frigate

Η εγκατάσταση ενός συστήματος παρακολούθησης βίντεο με το Frigate σάς επιτρέπει να εντοπίζετε άτομα, οχήματα και άλλα αντικείμενα χωρίς να στέλνετε εγγραφές στο cloud. Ωστόσο, κατά την εγκατάσταση, είναι αρκετά συνηθισμένο να συναντήσετε ένα κάμερα που δεν εμφανίζει εικόνα, μια ζωντανή ροή που διακόπτεται ή μηνύματα που υποδεικνύουν ότι το FFmpeg δεν μπορεί να λάβει καρέ.

Αυτές οι αποτυχίες συνήθως δεν σχετίζονται με την τεχνητή νοημοσύνη. Στις περισσότερες περιπτώσεις, η προέλευση βρίσκεται σε ένα Λανθασμένη διεύθυνση URL RTSPΗ αιτία θα μπορούσε να είναι μη έγκυρα διαπιστευτήρια, μια ασύμβατη ροή, ένα πρόβλημα δικτύου ή ένα σφάλμα στη διαμόρφωση του Frigate. Ο πιο γρήγορος τρόπος αντιμετώπισης προβλημάτων είναι να ελέγξετε κάθε στοιχείο ξεχωριστά: πρώτα την κάμερα, μετά τη ροή, στη συνέχεια το Frigate και τέλος πρόσθετες υπηρεσίες όπως go2rtc, MQTT ή Home Assistant.

Αρχικά, ελέγξτε τη σύνδεση της κάμερας.

Πριν τροποποιήσετε το αρχείο διαμόρφωσης, επαληθεύστε ότι η κάμερα λειτουργεί ανεξάρτητα. Η Φρεγάτα χρειάζεται πρόσβαση σε μια συμβατή ροή, συνήθως μέσω RTSPαν και ορισμένα μοντέλα χρησιμοποιούν άλλες μορφές όπως HTTP-FLV.

Μεταβείτε στην εφαρμογή ή στον πίνακα διαχείρισης της κάμερας και ελέγξτε ότι είναι ενεργοποιημένη η τοπική πρόσβαση, το RTSP ή το ONVIF. Ορισμένοι κατασκευαστές απαιτούν επίσης να δημιουργήσετε ένα ειδικός λογαριασμός για εξωτερικές εφαρμογές, διαφορετικό από αυτό που χρησιμοποιείται για την πρόσβαση στις υπηρεσίες cloud.

Συνιστάται επίσης να αντιστοιχίσετε μια στατική διεύθυνση IP στην κάμερα από τον δρομολογητή σας. Εάν η διεύθυνσή της αλλάξει μετά από μια επανεκκίνηση, η Frigate θα συνεχίσει να προσπαθεί να συνδεθεί στην παλιά διεύθυνση IP και το βίντεο θα σταματήσει να λειτουργεί.

Η κατεύθυνση του ρεύματος έχει συνήθως μια δομή παρόμοια με αυτή:

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

Η ακριβής διαδρομή εξαρτάται από τον κατασκευαστή και το μοντέλο. Για να ελέγξετε αν είναι σωστή, ανοίξτε τη διεύθυνση URL από VLC ή ffplayΑν δεν λειτουργεί ούτε σε αυτούς τους παίκτες, δεν αξίζει να ασχοληθείτε με το Frigate ακόμα: θα πρέπει να ελέγξετε τη διεύθυνση IP, τη θύρα, τα διαπιστευτήρια και τη διαδρομή που παρέχεται από την κάμερα.

Εάν ο κωδικός πρόσβασης περιέχει χαρακτήρες όπως @, #, : o /Αυτά μπορούν να προκαλέσουν σφάλμα στη διεύθυνση URL. Σε αυτήν την περίπτωση, χρησιμοποιήστε μεταβλητές περιβάλλοντος συμβατές με το Frigate ή κωδικοποιήστε σωστά τους ειδικούς χαρακτήρες.

Προσθέστε την κάμερα χρησιμοποιώντας τον οδηγό Frigate

Στις τρέχουσες εκδόσεις, ο συνιστώμενος τρόπος για να προσθέσετε μια κάμερα είναι να χρησιμοποιήσετε τον οδηγό που περιλαμβάνεται στη διεπαφή. Μεταβείτε στη διεύθυνση Ρυθμίσεις > Καθολική διαμόρφωση > Διαχείριση κάμερας και επιλέξτε Προσθήκη κάμερας.

Ο οδηγός σάς επιτρέπει να εισαγάγετε τη διεύθυνση IP και τα διαπιστευτήρια, να αναζητήσετε προφίλ χρησιμοποιώντας ONVIF ή να εισαγάγετε χειροκίνητα τη διεύθυνση URL RTSP. Στη συνέχεια, δοκιμάζει κάθε ροή, εμφανίζει ένα στιγμιότυπο οθόνης και σας επιτρέπει να αντιστοιχίσετε τις λειτουργίες της.

• διακρίνω: ροή που χρησιμοποιείται για την ανίχνευση κίνησης και αντικειμένων.
• ρεκόρ: ροή της οποίας τα τμήματα θα αποθηκευτούν ως ηχογραφήσεις.
• ήχος: ροή που χρησιμοποιείται για την ανίχνευση ήχου.

Το συνηθισμένο είναι να χρησιμοποιείτε το υπορεύμα χαμηλότερης ανάλυσης για ανίχνευση και την κύρια ροή για εγγραφή. Με αυτόν τον τρόπο, η Frigate αναλύει μια πιο ανοιχτόχρωμη εικόνα, αλλά διατηρεί τις εγγραφές με την αρχική ποιότητα.

Ο βοηθός εντοπίζει επίσης συνηθισμένα προβλήματα, όπως υπερβολική ανάλυση για ανίχνευση, απουσία ροής με τον ρόλο detect ή έναν μη συμβατό κωδικοποιητή ήχου.

Εξετάστε τη διαμόρφωση YAML και τους ρόλους κάθε ροής

Μπορείτε επίσης να ρυθμίσετε τις κάμερες χειροκίνητα χρησιμοποιώντας YAML. Αυτή η μορφή χρησιμοποιεί εσοχή για να αναπαραστήσει τη δομή, επομένως Δεν πρέπει να χρησιμοποιείτε καρτέλες ούτε να αναμειγνύετε διαφορετικά ποσά χώρων.

Μια βασική ρύθμιση με δύο ροές μπορεί να μοιάζει με αυτό:

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

Οι διαδρομές είναι απλώς παραδείγματα και θα πρέπει να αντικατασταθούν με εκείνες που αντιστοιχούν στην κάμερά σας. Ο κωδικός πρόσβασης μπορεί να αποθηκευτεί σε μια μεταβλητή της οποίας το όνομα αρχίζει με FRIGATE_αποφεύγοντας να το αφήσετε άμεσα εκτεθειμένο στο αρχείο.

Αντί να βασίζεστε αποκλειστικά σε έναν γενικό επικυρωτή YAML, χρησιμοποιήστε το Επεξεργαστής διαμόρφωσης φρεγάταςΈνας εξωτερικός επικυρωτής μπορεί να εντοπίσει σφάλματα εσοχής, αλλά δεν γνωρίζει εάν ένα συγκεκριμένο κλειδί υπάρχει ή είναι συμβατό με την εγκατεστημένη έκδοση.

Τι να κάνετε εάν εμφανιστεί το σφάλμα "no frames"

Μηνύματα όπως "Δεν είναι δυνατή η ανάγνωση πλαισίων από τη διεργασία ffmpeg" o «Δεν έχουν ληφθεί καρέ» Υποδεικνύουν ότι η διαδικασία που είναι υπεύθυνη για τη λήψη του βίντεο δεν είναι η παράδοση εικόνων στην Φρεγάτα.

Ανοίξτε τα αρχεία καταγραφής από την ενότητα συστήματος και εντοπίστε τις γραμμές που αντιστοιχούν στην επηρεαζόμενη κάμερα. Οι πιο συνηθισμένες αιτίες είναι:

• Η διεύθυνση IP της κάμερας έχει αλλάξει.
• Το όνομα χρήστη ή ο κωδικός πρόσβασης είναι λανθασμένοι.
• Η διαδρομή RTSP ανήκει σε ένα άλλο μοντέλο κάμερας.
• Το υλικολογισμικό περιορίζει τον αριθμό των ταυτόχρονων συνδέσεων.
• Η κάμερα χάνει την κάλυψη WiFi ή επανεκκινεί τη ροή.
• Έχει ρυθμιστεί μια μη συμβατή επιτάχυνση βίντεο.
• Ο κωδικοποιητής ή οι παράμετροι που εκπέμπονται από την κάμερα δεν είναι έγκυροι.

Αν χρησιμοποιείτε go2rtc, ελέγξτε επίσης την κατάσταση των ροών από /api/go2rtc/streamsΑυτό σας επιτρέπει να ελέγξετε αν το go2rtc μπορεί να συνδεθεί στην κάμερα και ποιους κωδικοποιητές λαμβάνει.

Όταν μια κάμερα προσφέρει πολλαπλά πρωτόκολλα μεταφοράς, η δοκιμή του RTSP μέσω TCP μπορεί να βελτιώσει τη σταθερότητα σε δίκτυα όπου υπάρχει απώλεια πακέτων. Ωστόσο, μια σύνδεση Ethernet παραμένει προτιμότερη από το Wi-Fi για κάμερες που μεταδίδουν συνεχώς βίντεο.

Το βίντεο λειτουργεί, αλλά η Φρεγάτα δεν αποθηκεύει ηχογραφήσεις.

Το γεγονός ότι η εικόνα εμφανίζεται ζωντανά δεν σημαίνει ότι οι εγγραφές έχουν ρυθμιστεί σωστά. Για να αποθηκεύσετε βίντεο, πρέπει να πληρούνται τρεις προϋποθέσεις: πρέπει να υπάρχει μια ροή με τον ρόλο. record, η καταγραφή πρέπει να είναι ενεργοποιημένη και να έχει οριστεί πολιτική διατήρησης.

Το αρχαίο κλειδί retain_days Αυτό δεν θα πρέπει να χρησιμοποιείται στις τρέχουσες διαμορφώσεις. Για να αποθηκεύσετε ολόκληρο το βίντεο σε διάστημα τριών ημερών, η σωστή δομή είναι:

record:
  enabled: true
  continuous:
    days: 3

Αν προτιμάτε να μειώσετε τη χρήση του δίσκου και να διατηρείτε δεδομένα μόνο από περιόδους όπου υπήρξε μετακίνηση, μπορείτε να χρησιμοποιήσετε:

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

Οι ηχογραφήσεις αποθηκεύονται εντός /media/frigate/recordingsΒεβαιωθείτε ότι ο τόμος είναι τοποθετημένος στη σωστή θέση, έχει δικαιώματα εγγραφής και επαρκή χώρο. Μια λανθασμένη τοποθέτηση μπορεί να προκαλέσει την κατά λάθος εγγραφή του Frigate στον δίσκο συστήματος και την γρήγορη πλήρωσή του.

Θα πρέπει επίσης να λάβετε υπόψη τον κωδικοποιητή. Οι εγγραφές H.265 δεν λειτουργούν σε όλα τα προγράμματα περιήγησης, ενώ το H.264 προσφέρει πολύ μεγαλύτερη συμβατότητα. Εάν τα αρχεία υπάρχουν αλλά δεν αναπαράγονται από τη διεπαφή, το πρόβλημα μπορεί να οφείλεται στο πρόγραμμα περιήγησης και όχι στην κάμερα.

Ενσωμάτωση με το Home Assistant και το MQTT

Για να ενσωματώσετε το Frigate με το Home Assistant, πρέπει να εγκαταστήσετε την ενσωμάτωση του Frigate και να διαμορφώσετε εκ των προτέρων την ενσωμάτωση του MQTT. Επιπλέον, και τα δύο συστήματα πρέπει να είναι συνδεδεμένα στο ο ίδιος μεσίτης MQTT έτσι ώστε πολλές από τις οντότητες, τους αισθητήρες και τους μετρητές να λειτουργούν σωστά.

Μια βασική διαμόρφωση θα ήταν:

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

Κατά την προσθήκη της ενσωμάτωσης του Home Assistant, πρέπει επίσης να καθορίσετε την εσωτερική διεύθυνση URL του Frigate. Η θύρα μπορεί να χρησιμοποιηθεί. 5000το οποίο δεν ενσωματώνει έλεγχο ταυτότητας ή το 8971η οποία προσφέρει πρόσβαση με έλεγχο ταυτότητας. Η θύρα 5000 θα πρέπει να εκτίθεται μόνο εντός ενός αξιόπιστου δικτύου.

Για ζωντανό βίντεο, είναι χρήσιμο να γίνει διάκριση μεταξύ δύο θυρών:

• 8554: Η αναμετάδοση RTSP παρέχεται από το go2rtc.
• 8555 TCP και UDP: Συνδέσεις WebRTC.

Η αναμετάδοση μπορεί να ανοίξει με μια διεύθυνση όπως rtsp://IP_DEL_SERVIDOR:8554/nombre_streamΕάν το Home Assistant βρίσκεται σε διαφορετικό δίκτυο, διαφορετικό VLAN ή πίσω από συγκεκριμένους διακομιστές μεσολάβησης, το WebRTC ενδέχεται να χρειαστεί να διαμορφωθεί ως υποψήφιο. Η πραγματική διεύθυνση του διακομιστή της φρεγάτας στην οποία έχετε πρόσβαση από τη συσκευή-πελάτη.

Ένας αντίστροφος διακομιστής μεσολάβησης HTTP όπως ο Traefik μπορεί να χρησιμοποιηθεί για πρόσβαση στη διεπαφή ιστού, αλλά δεν αντικαθιστά την έκθεση των θυρών που χρησιμοποιούνται απευθείας από το RTSP ή το WebRTC.

Μειώστε σωστά τη χρήση της CPU

Η Φρεγάτα εκτελεί διάφορες εργασίες και η καθεμία μπορεί να χρησιμοποιεί διαφορετικό εξάρτημα. αποκωδικοποίηση βίντεο Αυτό αντιστοιχεί στο FFmpeg και μπορεί να επιταχυνθεί με μια ενσωματωμένη ή αποκλειστική GPU. ανίχνευση αντικειμένωνΑντ' αυτού, χρησιμοποιεί έναν ανιχνευτή όπως Coral, Hailo, OpenVINO, ONNX ή TensorRT.

Ένα Coral USB μπορεί να μειώσει σημαντικά την απαιτούμενη εργασία για την εκτέλεση του μοντέλου ανίχνευσης, αλλά δεν επιταχύνει εγγενώς την αποκωδικοποίηση ροής. Για αυτό, πρέπει να διαμορφώσετε μια προεπιλογή hwaccel_args συμβατό με υλικό διακομιστή.

Για παράδειγμα, πολλά συμβατά συστήματα Intel και AMD μπορούν να χρησιμοποιήσουν:

ffmpeg:
  hwaccel_args: preset-vaapi

Δεν πρέπει να αντιγράψετε αυτήν την τιμή χωρίς να επαληθεύσετε τη συμβατότητα με τον εξοπλισμό σας. Μια εσφαλμένη ρύθμιση παραμέτρων μπορεί να προκαλέσει επανειλημμένα σφάλματα στο FFmpeg, καθώς δεν υπάρχει πάντα αυτόματη αντικατάσταση λογισμικού όταν η επιλεγμένη επιτάχυνση αποτύχει.

Επιπλέον, αποφύγετε να ερμηνεύετε τα στοιχεία χρήσης CPU της Frigate ως αντιπροσωπευτικά ολόκληρου του επεξεργαστή. Στα στατιστικά τους, μια διεργασία 100% σημαίνει συνήθως ότι χρησιμοποιεί ολόκληρο τον επεξεργαστή. ένας μόνο πυρήναςΓια να υπολογίσετε τη συνολική κατανάλωση, συγκρίνετε τα δεδομένα με docker stats ή με την οθόνη του κεντρικού συστήματος.

Για να μειώσετε το φορτίο χωρίς να επηρεάσετε τις εγγραφές:

• Χρησιμοποιήστε ένα δευτερεύον ρεύμα για να detect.
• Ρυθμίστε την ανίχνευση σε περίπου 5 FPS.
• Κάντε κράτηση για τη ροή υψηλής ανάλυσης για record.
• Ενεργοποίηση συμβατής αποκωδικοποίησης υλικού.
• Χρησιμοποιήστε έναν κατάλληλο ανιχνευτή αντί για τον δοκιμαστικό ανιχνευτή CPU.
• Αποφύγετε το άνοιγμα πολλαπλών περιττών συνδέσεων στην ίδια κάμερα.

Λίστα ελέγχου εάν μια κάμερα εξακολουθεί να μην λειτουργεί

1. Ελέγξτε ότι η κάμερα ανταποκρίνεται στη διεύθυνση IP της.
2. Επαληθεύστε την ακριβή διεύθυνση URL χρησιμοποιώντας VLC ή ffplay.
3. Επιβεβαιώστε ότι το RTSP ή το ONVIF είναι ενεργοποιημένο στην κάμερα.
4. Ελέγξτε το όνομα χρήστη, τον κωδικό πρόσβασης, τη θύρα και τους ειδικούς χαρακτήρες.
5. Δοκιμάστε να κάνετε streaming από τον οδηγό προσθήκης κάμερας Frigate.
6. Ελέγξτε τους ρόλους detect y record.
7. Ελέγξτε τα αρχεία καταγραφής FFmpeg και καταγραφής καταγραφής.
8. Απενεργοποιήστε προσωρινά hwaccel_args αν γίνει επανεκκίνηση του FFmpeg.
9. Ελέγξτε τις ροές go2rtc και τα ονόματα που χρησιμοποιούνται στην αναμετάδοση.
10. Ελέγξτε τον χώρο, τη διαρρύθμιση και τις άδειες /media/frigate.
11. Επαληθεύστε ότι η Frigate και η Home Assistant χρησιμοποιούν τον ίδιο μεσίτη MQTT.
12. Εκθέστε σωστά τις θύρες 8554 και 8555 εάν χρειάζεστε RTSP ή WebRTC.

Ακολουθώντας αυτήν τη σειρά, αποφεύγετε την ταυτόχρονη αλλαγή πολλαπλών επιλογών και σας επιτρέπει να εντοπίσετε πού διακόπτεται η ροή. Εάν η κάμερα λειτουργεί σε VLC, η ροή εμφανίζεται σωστά στο go2rtc και το FFmpeg δεν εμφανίζει σφάλματα, το πρόβλημα συνήθως σχετίζεται με τους ρόλους, τη διατήρηση της εγγραφής ή την ενσωμάτωση που χρησιμοποιείται για την εμφάνιση του βίντεο.

Μια σταθερή διαμόρφωση εξαρτάται από τον σωστό διαχωρισμό κάθε λειτουργίας: μια ελαφριά ροή για ανάλυση εικόνας, μια ροή υψηλότερης ποιότητας για εγγραφή, ειδική επιτάχυνση για αποκωδικοποίηση και έναν κατάλληλο ανιχνευτή για τεχνητή νοημοσύνη. Με αυτήν τη δομή, η Frigate μπορεί να λειτουργεί για μεγάλα χρονικά διαστήματα χωρίς διακοπές ή υπερβολική κατανάλωση πόρων.