用途
frigate-configurator 是用于帮助配置 Frigate NVR 的技能。根据其说明,它用于生成优化后的 YAML 配置,涉及对象检测、录像、区域(zones)和硬件加速;适用场景包括搭建 Frigate 摄像头以及排查配置问题。
主要能力
技能说明中列出以下能力:
- 最小可用配置的生成:先验证摄像头连通性,再逐步增加复杂度。
- 硬件加速检测器配置:如 Coral Edge TPU(USB/PCIe)、Intel OpenVINO、ONNX。
- 录像与保留策略:record、retain、alerts、detections 的保留天数与模式。
- 硬件加速预设:Intel QSV、VAAPI、NVIDIA、AMD、Raspberry Pi。
- 区域(zones)与必选区域(required_zones)、运动掩码(motion mask)。
- 区域速度估计、音频检测、GenAI 事件描述、人脸识别、车牌识别、go2rtc 集成。
- Docker Compose 模板、配置模板(minimal/full)、检测器对比、FFmpeg 预设、MQTT 主题等参考资料,以及配置校验脚本 validate-config.sh。
技能说明称其可预防 12 类以上常见错误,并把配置 token 使用量从约 15,000 降至约 6,000,设置时间从 2-4 小时缩短至 30-45 分钟。
使用方式
技能以“快速开始”步骤给出配置路径:
- 创建最小配置:先用 mqtt 关闭、单摄像头单 detect 流的最小配置验证连通性,并显式指定 detect 角色。
- 添加硬件加速检测器:如 Coral edgetpu(device: usb),或 Intel OpenVINO(device: GPU)。说明中指出 CPU 检测不建议用于生产环境。
- 启用录像与保留:分别用低分辨率子码流做 detect、高分辨率主码流做 record,并配置 retain 模式、alerts 与 detections 保留天数。
配置过程中强调的关键规则包括:检测分辨率必须匹配摄像头实际输出、detect fps 取 5-10、检测与录像使用不同码流、Docker 中按每摄像头至少 64MB 配置 shm-size、为时间戳叠加和常动区域创建运动掩码、用环境变量保存凭据,并先在 VLC 中测试 RTSP 地址。禁止事项包括:Docker 内 MQTT 不用 localhost 或 127.0.0.1、检测分辨率不超过 1280x720、启用录像必须指定保留策略、不在网络存储上直接挂载 /media/frigate、对象检测不混用多种检测器类型、UDP RTSP 需显式配置。
技能还给出 Docker Compose 模板(镜像 ghcr.io/blakeblackshear/frigate:stable,shm_size 256mb,映射 USB、Intel GPU 设备,端口 8971、8554、8555 等)、硬件加速预设写法、检测器类型写法、区域与速度估计、音频检测、GenAI、人脸识别、车牌识别、go2rtc 配置示例,以及部署前检查清单和常见故障排查(摄像头离线、CPU 占用高、检测不到对象、录像不工作)。
依赖
必需:Docker 20.10+、docker-compose 2.0+。可选:NVIDIA Container Toolkit、Coral Edge TPU runtime。
限制
技能未说明其自身运行所需的模型、平台或收费方式;上述内容均来自技能说明与其内置示例。实际配置效果受摄像头型号、硬件、网络与部署环境影响,文中未提供具体支持范围与验证结论。