O tópico original é uma introdução a um tutorial externo de 2023, não um registo completo de uma implementação do Frigate. Indica que o tutorial irá instalar o Frigate no CasaOS e integrar câmaras com o Google Coral, mas não preserva a imagem Docker, os volumes, as portas, o tamanho da memória partilhada nem a configuração do detetor utilizados na altura.
Para uma configuração atual, a documentação mantida do Frigate deve ser a referência técnica. O Docker Compose continua a ser o método de instalação recomendado, e o Google Coral é agora apenas uma opção de aceleração de hardware entre vários caminhos possíveis para o detetor e o vídeo.
Atualmente, o Frigate recomenda o Docker Compose
O guia de instalação atual do Frigate utiliza ghcr.io/blakeblackshear/frigate:stable, configuração e multimédia persistentes, um tamanho explícito para a memória partilhada e mapeamentos de dispositivos adequados ao acelerador selecionado.
Utilize o modelo de instalação atual do Frigate em vez de copiar literalmente um vídeo de 2023.
Mantenha o /config fora do contentor
A configuração YAML do Frigate deve ficar numa pasta do anfitrião mapeada para /config. Mantenha-a num armazenamento persistente do CasaOS para que a recriação do contentor não apague as definições das câmaras, do detetor, das gravações, das zonas e das capturas de ecrã.
Mapeie gravações e clips para armazenamento real
O vídeo do NVR pode crescer muito mais rapidamente do que os dados comuns das aplicações. Coloque as gravações, os clips e as exportações num volume de armazenamento com capacidade suficiente, em vez de utilizar o pequeno disco do sistema operativo.
A memória partilhada deve corresponder à carga de trabalho das câmaras
O Frigate utiliza memória partilhada para o processamento de vídeo. O exemplo atual de Compose inclui um shm_size explícito, e o valor correto depende da resolução e do número de câmaras.
O Google Coral é opcional, não um requisito universal
A fonte de 2023 dava destaque ao Google Coral. A documentação atual do Frigate continua a descrever mapeamentos para Coral USB e PCIe, mas as implementações modernas também podem utilizar aceleração de vídeo Intel/AMD, uma NPU Intel ou outros caminhos de detetores compatíveis, dependendo do hardware.
A aceleração de hardware requer o mapeamento correto dos dispositivos
Os exemplos atuais incluem /dev/bus/usb para Coral USB, /dev/apex_0 para Coral PCIe, /dev/dri/renderD128 para gráficos Intel/AMD e /dev/accel para caminhos de NPU Intel compatíveis. Conceda apenas o acesso ao hardware de que o Frigate realmente necessita.
O modo privilegiado nem sempre é necessário
O exemplo atual de Compose do Frigate indica que privileged: true pode não ser necessário em todas as configurações. É preferível aplicar o princípio do menor privilégio quando os mapeamentos explícitos de dispositivos e as permissões forem suficientes.
Mantenha privadas as credenciais das câmaras e as ligações RTSP
A configuração do Frigate contém normalmente nomes de utilizador, palavras-passe e URLs RTSP das câmaras. Evite publicar ficheiros de configuração completos ou capturas de ecrã sem ocultar os segredos e evite expor o RTSP diretamente à Internet.
O CasaOS é o anfitrião dos contentores, não a camada de configuração do Frigate
O CasaOS pode iniciar o contentor e mapear o armazenamento e os dispositivos, enquanto o YAML do Frigate controla o comportamento do NVR. Se a aplicação abrir mas as câmaras falharem, analise os registos e a configuração do Frigate em vez de reinstalar repetidamente o CasaOS.
A deteção de objetos e a descodificação de vídeo são tarefas de aceleração diferentes
Um acelerador Coral é utilizado para a inferência de deteção de objetos compatível; o hardware de vídeo Intel/AMD/NVIDIA pode acelerar a descodificação e a codificação. Um não substitui automaticamente o outro.
Conceba a pilha do Frigate tendo em conta tanto a carga de trabalho do detetor como a carga de trabalho de descodificação/transcodificação dos codecs das câmaras, em vez de tratar a “aceleração de hardware” como uma única opção.
Defina a retenção antes de ativar muitas câmaras
A gravação contínua pode encher rapidamente os discos. Estime a taxa de bits × o número de câmaras × os dias de retenção, deixe margem livre no sistema de ficheiros e decida quais os eventos que precisam de retenção prolongada face às gravações em ciclo.
Verifique os registos e o estado do Frigate após o primeiro arranque
Antes de adicionar todas as câmaras, valide uma transmissão, confirme que o detetor/dispositivo é reconhecido e reveja os registos do contentor para detetar erros de memória partilhada, FFmpeg ou permissões. É mais fácil aumentar gradualmente a partir de uma câmara conhecida e funcional do que resolver cinco falhas simultâneas.
Perguntas frequentes sobre o Frigate no CasaOS
A publicação original da comunidade contém o ficheiro Compose completo do Frigate?
Não. Aponta sobretudo para um tutorial externo de 2023.
O Google Coral é obrigatório para o Frigate atual?
Não. O Coral continua a ser uma opção compatível, mas o Frigate atual suporta outros caminhos de hardware, dependendo do anfitrião.
O que deve ser sempre persistente?
No mínimo, a configuração do Frigate e o armazenamento de multimédia/gravações que pretende conservar.
