El hilo original es una introducción a un tutorial externo de 2023, no un registro completo de una implementación de Frigate. Indica que el tutorial instalará Frigate en CasaOS e integrará cámaras con Google Coral, pero no conserva la imagen de Docker, los volúmenes, los puertos, el tamaño de la memoria compartida ni la configuración del detector utilizados en ese momento.
Para una configuración actual, la documentación mantenida de Frigate debe ser la referencia técnica principal. Docker Compose sigue siendo el método de instalación recomendado, y Google Coral ahora es solo una de varias opciones posibles de aceleración de hardware y procesamiento de vídeo.
Frigate recomienda actualmente Docker Compose
La guía de instalación actual de Frigate utiliza ghcr.io/blakeblackshear/frigate:stable, configuración y medios persistentes, un tamaño explícito de memoria compartida y asignaciones de dispositivos adecuadas para el acelerador seleccionado.
Utiliza el modelo de instalación actual de Frigate en lugar de copiar literalmente un vídeo de 2023.
Conserva /config fuera del contenedor
La configuración YAML de Frigate debe estar en una carpeta del host asignada a /config. Consérvala en un almacenamiento persistente de CasaOS para que la recreación del contenedor no borre la configuración de cámaras, detectores, grabaciones, zonas ni instantáneas.
Asigna las grabaciones y los clips a un almacenamiento real
El vídeo del NVR puede crecer mucho más rápido que los datos habituales de las aplicaciones. Guarda las grabaciones, los clips y las exportaciones en un volumen de almacenamiento con capacidad suficiente, en lugar de utilizar el pequeño disco del sistema operativo.
La memoria compartida debe ajustarse a la carga de trabajo de las cámaras
Frigate utiliza memoria compartida para procesar vídeo. El ejemplo actual de Compose incluye un shm_size explícito, y el valor correcto depende de la resolución y la cantidad de cámaras.
Google Coral es opcional, no un requisito universal
La fuente de 2023 hacía hincapié en Google Coral. Frigate sigue documentando las asignaciones de Coral USB y PCIe, pero las implementaciones modernas también pueden utilizar aceleración de vídeo de Intel/AMD, una NPU de Intel u otras rutas de detección compatibles, según el hardware.
La aceleración de hardware requiere la asignación correcta de dispositivos
Los ejemplos actuales incluyen /dev/bus/usb para Coral USB, /dev/apex_0 para Coral PCIe, /dev/dri/renderD128 para gráficos Intel/AMD y /dev/accel para rutas compatibles con NPU de Intel. Concede únicamente el acceso al hardware que Frigate realmente necesite.
El modo privilegiado no siempre es necesario
El ejemplo actual de Compose de Frigate indica que privileged: true puede no ser necesario en todas las configuraciones. Es preferible aplicar el principio de mínimo privilegio cuando las asignaciones explícitas de dispositivos y los permisos sean suficientes.
Mantén privadas las credenciales de las cámaras y las direcciones RTSP
La configuración de Frigate suele contener nombres de usuario, contraseñas y URL RTSP de las cámaras. Evita publicar archivos de configuración completos o capturas de pantalla sin ocultar los secretos, y evita exponer RTSP directamente a Internet.
CasaOS es el host de contenedores, no la capa de configuración de Frigate
CasaOS puede iniciar el contenedor y asignar el almacenamiento y los dispositivos, mientras que el YAML de Frigate controla el comportamiento del NVR. Si la aplicación se abre pero las cámaras fallan, revisa los registros y la configuración de Frigate en lugar de reinstalar CasaOS repetidamente.
La detección de objetos y la decodificación de vídeo son tareas de aceleración diferentes
Un acelerador Coral se utiliza para la inferencia de detección de objetos compatible; el hardware de vídeo de Intel/AMD/NVIDIA puede acelerar la decodificación y la codificación. Uno no sustituye automáticamente al otro.
Diseña la pila de Frigate teniendo en cuenta tanto la carga de trabajo del detector como la de códecs y transcodificación de las cámaras, en lugar de tratar la «aceleración de hardware» como una sola casilla.
Configura la retención antes de activar muchas cámaras
La grabación continua puede llenar los discos rápidamente. Calcula la tasa de bits × el número de cámaras × los días de retención, deja espacio libre en el sistema de archivos y decide qué eventos necesitan una retención prolongada frente a las grabaciones rotativas.
Revisa los registros y el estado de Frigate después del primer inicio
Antes de añadir todas las cámaras, valida una transmisión, confirma que el detector y el dispositivo se reconocen y revisa los registros del contenedor en busca de errores de memoria compartida, FFmpeg o permisos. Es más fácil ampliar desde una cámara que funciona correctamente que depurar cinco fallos simultáneos.
Preguntas frecuentes sobre Frigate en CasaOS
¿La publicación original de la comunidad contiene el archivo completo de Compose de Frigate?
No. Principalmente enlaza a un tutorial externo de 2023.
¿Es obligatorio Google Coral para la versión actual de Frigate?
No. Coral sigue siendo una opción compatible, pero la versión actual de Frigate admite otras rutas de hardware según el host.
¿Qué elementos deben ser siempre persistentes?
Como mínimo, la configuración de Frigate y el almacenamiento de medios y grabaciones que quieras conservar.
