跳到主要内容

高级配置选项

日志配置

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关联faceamazon
  • 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

将静态编译的ffmpegffprobe放入/config/custom-ffmpeg/bin

  1. 下载FFmpeg并解压到/config/custom-ffmpeg
  2. 更新配置:
ffmpeg:
path: /config/custom-ffmpeg
  1. 重启Frigate

自定义go2rtc版本

  1. 下载go2rtc到/config目录
  2. 重命名为go2rtc
  3. 添加执行权限
  4. 重启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