Le fil source est une introduction à un tutoriel externe de 2023, et non un relevé complet du déploiement de Frigate. Il indique que le tutoriel installera Frigate sur CasaOS et intégrera des caméras avec Google Coral, mais il ne conserve pas l’image Docker, les volumes, les ports, la taille de la mémoire partagée ni la configuration du détecteur utilisées à l’époque.
Pour une installation actuelle, la documentation maintenue de Frigate doit servir de référence technique. Docker Compose reste la méthode d’installation recommandée, et Google Coral n’est désormais qu’une option d’accélération matérielle parmi plusieurs chemins possibles pour le détecteur et la vidéo.
Frigate recommande actuellement Docker Compose
Le guide d’installation actuel de Frigate utilise ghcr.io/blakeblackshear/frigate:stable, une configuration et des médias persistants, une taille explicite pour la mémoire partagée, ainsi que des mappages de périphériques adaptés à l’accélérateur sélectionné.
Utilisez le modèle d’installation actuel de Frigate plutôt que de copier une vidéo de 2023 à l’identique.
Conservez /config en dehors du conteneur
La configuration YAML de Frigate doit se trouver dans un dossier hôte mappé vers /config. Conservez-la sur un stockage persistant de CasaOS afin que la recréation du conteneur n’efface pas les paramètres des caméras, des détecteurs, des enregistrements, des zones et des instantanés.
Mappez les enregistrements et les clips vers un véritable espace de stockage
Les vidéos NVR peuvent occuper de l’espace bien plus rapidement que les données d’application ordinaires. Placez les enregistrements, les clips et les exports sur un volume de stockage suffisamment capacitaire plutôt que sur le petit disque du système d’exploitation.
La mémoire partagée doit correspondre à la charge des caméras
Frigate utilise la mémoire partagée pour le traitement vidéo. L’exemple Compose actuel inclut un shm_size explicite, et la valeur correcte dépend de la résolution et du nombre de caméras.
Google Coral est facultatif, et non une exigence universelle
La source de 2023 mettait l’accent sur Google Coral. Frigate documente toujours les mappages Coral USB et PCIe, mais les déploiements modernes peuvent également utiliser l’accélération vidéo Intel/AMD, un NPU Intel ou d’autres chemins de détection pris en charge, selon le matériel.
L’accélération matérielle nécessite le mappage correct des périphériques
Les exemples actuels incluent /dev/bus/usb pour Coral USB, /dev/apex_0 pour Coral PCIe, /dev/dri/renderD128 pour les cartes graphiques Intel/AMD et /dev/accel pour les chemins NPU Intel pris en charge. N’accordez l’accès qu’au matériel dont Frigate a réellement besoin.
Le mode privilégié n’est pas toujours nécessaire
L’exemple Compose actuel de Frigate indique que privileged: true peut ne pas être nécessaire dans toutes les configurations. Il est préférable de respecter le principe du moindre privilège lorsque des mappages explicites de périphériques et des autorisations suffisantes permettent de fonctionner.
Gardez les identifiants des caméras et les points de terminaison RTSP privés
La configuration de Frigate contient généralement les noms d’utilisateur, les mots de passe et les URL RTSP des caméras. Évitez de publier des fichiers de configuration complets ou des captures d’écran sans masquer les secrets, et évitez d’exposer directement RTSP sur Internet.
CasaOS héberge le conteneur, mais ne constitue pas la couche de configuration de Frigate
CasaOS peut lancer le conteneur et mapper le stockage et les périphériques, tandis que le YAML de Frigate contrôle le comportement du NVR. Si l’application s’ouvre mais que les caméras échouent, examinez les journaux et la configuration de Frigate plutôt que de réinstaller CasaOS à répétition.
La détection d’objets et le décodage vidéo sont deux tâches d’accélération différentes
Un accélérateur Coral sert à l’inférence de détection d’objets prise en charge ; le matériel vidéo Intel/AMD/NVIDIA peut accélérer le décodage et l’encodage. L’un ne remplace pas automatiquement l’autre.
Concevez la pile Frigate en fonction à la fois de la charge du détecteur et de celle du codec vidéo ou du transcodage des caméras, plutôt que de considérer « accélération matérielle » comme une simple case à cocher.
Définissez la durée de conservation avant d’activer de nombreuses caméras
L’enregistrement continu peut remplir rapidement les disques. Estimez le débit binaire × le nombre de caméras × le nombre de jours de conservation, gardez une marge sur le système de fichiers et décidez quels événements doivent être conservés longtemps par rapport aux séquences en rotation.
Vérifiez les journaux et l’état de santé de Frigate après le premier démarrage
Avant d’ajouter toutes les caméras, validez un flux, vérifiez que le détecteur ou le périphérique est reconnu et consultez les journaux du conteneur pour repérer les erreurs liées à la mémoire partagée, à FFmpeg ou aux autorisations. Il est plus facile de passer à l’échelle à partir d’une caméra fonctionnelle que de déboguer cinq échecs simultanés.
FAQ : Frigate sur CasaOS
La publication originale de la communauté contient-elle le fichier Compose complet de Frigate ?
Non. Elle renvoie principalement vers un tutoriel externe de 2023.
Google Coral est-il obligatoire pour la version actuelle de Frigate ?
Non. Coral reste une option prise en charge, mais la version actuelle de Frigate prend en charge d’autres chemins matériels selon l’hôte.
Que faut-il toujours rendre persistant ?
Au minimum, la configuration de Frigate ainsi que le stockage des médias et des enregistrements que vous souhaitez conserver.
