高级配置选项
日志配置
Frigate日志设置
可调整日志级别用于故障排查。
logger:
# 可选:默认日志级别(默认如下)
default: info
# 可选:按模块设置日志级别
logs:
frigate.mqtt: error
可用日志级别:debug
, info
, warning
, error
, critical
可配置模块示例:
frigate.app
frigate.mqtt
frigate.object_detection
detector.<检测器名称>
watchdog.<摄像头名称>
ffmpeg.<摄像头名称>.<角色>
注意:所有FFmpeg日志均以error
级别记录
Go2RTC日志设置
参考go2rtc文档配置日志
go2rtc:
streams:
# ...
log:
exec: trace
环境变量
此配置项适用于无法直接修改容器环境的情况(如Home Assistant OS)。
示例:
environment_vars:
变量名: 变量值
数据库配置
追踪对象和录像信息存储在/config/frigate.db
的SQLite数据库中。若删除该数据库,录像文件将变为孤立文件需手动清理,且不会显示在Home Assistant的媒体浏览器中。
若使用网络存储(SMB/NFS等),启动时可能出现database is locked
错误。可自定义数据库路径:
database:
path: /自定义路径/frigate.db
模型配置
使用自定义模型时需指定宽高尺寸。
自定义模型可能需要不同的输入张量格式。支持RGB、BGR或YUV色彩空间转换。输入张量形状参数需与模型要求匹配。
张量维度 | 描述 |
---|---|
N | 批量大小 |
H | 模型高度 |
W | 模型宽度 |
C | 色彩通道数 |
可用输入张量形状 |
---|
"nhwc" |
"nchw" |
model:
path: /模型路径
width: 320
height: 320
input_tensor: "nhwc"
input_pixel_format: "bgr"
标签映射
注意
自定义标签映射后需同步调整警报标签配置
可自定义标签映射,常见场景是合并易混淆的物体类型(如car/truck)。默认已将truck重命名为car。
model:
labelmap:
2: vehicle
3: vehicle
5: vehicle
7: vehicle
15: animal
16: animal
17: animal
注意
部分标签有特殊处理逻辑:
person
关联face
和amazon
car
关联license_plate
,ups
,fedex
,amazon
网络配置
可通过绑定挂载nginx.conf文件修改内部网络配置:
services:
frigate:
volumes:
- /自定义路径/nginx.conf:/usr/local/nginx/conf/nginx.conf
启用IPv6
默认禁用IPv6,需修改listen.gotmpl文件:
原始配置:
listen 8971;
修改为:
listen [::]:8971 ipv6only=off;
基础路径
默认运行在根路径(/
),反向代理场景可能需要自定义路径前缀(如/frigate
)。
通过HTTP头设置
推荐方式是在反向代理中设置X-Ingress-Path
头:
Nginx示例:
location /frigate {
proxy_set_header X-Ingress-Path /frigate;
proxy_pass http://frigate_backend;
}
通过环境变量设置
services:
frigate:
environment:
- FRIGATE_BASE_PATH=/frigate
自定义依赖
自定义FFmpeg
将静态编译的ffmpeg
和ffprobe
放入/config/custom-ffmpeg/bin
:
- 下载FFmpeg并解压到
/config/custom-ffmpeg
- 更新配置:
ffmpeg:
path: /config/custom-ffmpeg
- 重启Frigate
自定义go2rtc版本
- 下载go2rtc到
/config
目录 - 重命名为
go2rtc
- 添加执行权限
- 重启Frigate
配置文件验证
更新配置时可通过以下方式验证:
通过API验证
curl -X POST http://frigate_host:5000/api/config/save -d @config.json
或使用yq转换yaml:
yq r -j config.yml | curl -X POST http://frigate_host:5000/api/config/save -d @-
命令行验证
docker run -v $(pwd)/config.yml:/config/config.yml \
--entrypoint python3 \
ghcr.io/blakeblackshear/frigate:stable \
-u -m frigate --validate-config