Frigate 配置

对于Home Assistant插件安装，配置文件应该位于/addon_configs/<addon_directory>/config.yml，其中<addon_directory是特定于你正在运行的Frigate插件变体的。请参见此处的目录列表。

对于所有其他类型的安装，配置文件应该映射到容器内的/config/config.yml。

文件可以命名为config.yml或config.yaml，但如果两个文件都存在，将优先使用config.yml并忽略config.yaml。

建议从最小配置开始，按照本指南中的描述添加内容，并使用Frigate UI中内置的支持验证的配置编辑器。

mqtt:
  enabled: False

cameras:
  dummy_camera: # <--- 这将稍后更改为你的实际摄像头
    enabled: False
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:554/rtsp
          roles:
            - detect

访问Home Assistant插件配置目录

当通过HA插件运行Frigate时，Frigate的/config目录被映射到主机上的/addon_configs/<addon_directory>，其中<addon_directory>是特定于你正在运行的Frigate插件变体的。

插件变体	配置目录
Frigate	`/addon_configs/ccab4aaf_frigate`
Frigate (完全访问)	`/addon_configs/ccab4aaf_frigate-fa`
Frigate Beta	`/addon_configs/ccab4aaf_frigate-beta`
Frigate Beta (完全访问)	`/addon_configs/ccab4aaf_frigate-fa-beta`

当你在文档中看到/config时，它指的是这个目录。

例如，如果你正在运行标准插件变体并使用VS Code插件浏览文件，你可以点击_文件_ > _打开文件夹..._并导航到/addon_configs/ccab4aaf_frigate来访问Frigate的/config目录并编辑config.yaml文件。你也可以使用Frigate UI中内置的文件编辑器来编辑配置文件。

VS Code配置模式

VS Code支持JSON模式来自动验证配置文件。你可以通过在配置文件开头添加# yaml-language-server: $schema=http://frigate_host:5000/api/config/schema.json来启用此功能。将frigate_host替换为你的Frigate服务器的IP地址或主机名。如果你同时使用VS Code和Frigate作为插件，你应该使用ccab4aaf-frigate。当从另一台机器上的VS Code访问配置时，确保暴露内部未认证端口5000。

环境变量替换

Frigate仅在参考配置中特别指出的地方支持使用以FRIGATE_开头的环境变量。例如，以下值可以在运行时通过使用环境变量替换：

mqtt:
  user: "{FRIGATE_MQTT_USER}"
  password: "{FRIGATE_MQTT_PASSWORD}"

- path: rtsp://{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@10.0.10.10:8554/unicast

onvif:
  host: 10.0.10.10
  port: 8000
  user: "{FRIGATE_RTSP_USER}"
  password: "{FRIGATE_RTSP_PASSWORD}"

go2rtc:
  rtsp:
    username: "{FRIGATE_GO2RTC_RTSP_USERNAME}"
    password: "{FRIGATE_GO2RTC_RTSP_PASSWORD}"

genai:
  api_key: "{FRIGATE_GENAI_API_KEY}"

常见配置示例

以下是一些常见的入门配置示例。有关所有配置值的详细信息，请参阅参考配置。

带USB Coral的树莓派Home Assistant插件

单个摄像头，720p，5fps检测流
MQTT连接到Home Assistant Mosquitto插件
用于解码视频的硬件加速
USB Coral检测器
保存所有包含任何可检测运动的视频7天，无论是否检测到任何对象
如果视频符合警报或检测条件，继续保留30天
保存快照30天
摄像头时间戳的运动遮罩

mqtt:
  host: core-mosquitto
  user: mqtt-user
  password: xxxxxxxxxx

ffmpeg:
  hwaccel_args: preset-rpi-64-h264

detectors:
  coral:
    type: edgetpu
    device: usb

record:
  enabled: True
  retain:
    days: 7
    mode: motion
  alerts:
    retain:
      days: 30
  detections:
    retain:
      days: 30

snapshots:
  enabled: True
  retain:
    default: 30

cameras:
  name_of_your_camera:
    detect:
      width: 1280
      height: 720
      fps: 5
    ffmpeg:
      inputs:
        - path: rtsp://10.0.10.10:554/rtsp
          roles:
            - detect
    motion:
      mask:
        - 0.000,0.427,0.002,0.000,0.999,0.000,0.999,0.781,0.885,0.456,0.700,0.424,0.701,0.311,0.507,0.294,0.453,0.347,0.451,0.400

带USB Coral的独立Intel迷你PC

单个摄像头，720p，5fps检测流
MQTT禁用（未与home assistant集成）
VAAPI硬件加速用于解码视频
USB Coral检测器
保存所有包含任何可检测运动的视频7天，无论是否检测到任何对象
如果视频符合警报或检测条件，继续保留30天
保存快照30天
摄像头时间戳的运动遮罩

mqtt:
  enabled: False

ffmpeg:
  hwaccel_args: preset-vaapi

detectors:
  coral:
    type: edgetpu
    device: usb

record:
  enabled: True
  retain:
    days: 7
    mode: motion
  alerts:
    retain:
      days: 30
  detections:
    retain:
      days: 30

snapshots:
  enabled: True
  retain:
    default: 30

cameras:
  name_of_your_camera:
    detect:
      width: 1280
      height: 720
      fps: 5
    ffmpeg:
      inputs:
        - path: rtsp://10.0.10.10:554/rtsp
          roles:
            - detect
    motion:
      mask:
        - 0.000,0.427,0.002,0.000,0.999,0.000,0.999,0.781,0.885,0.456,0.700,0.424,0.701,0.311,0.507,0.294,0.453,0.347,0.451,0.400

带OpenVino的Home Assistant集成Intel迷你PC

单个摄像头，720p，5fps检测流
MQTT连接到与home assistant相同的mqtt服务器
VAAPI硬件加速用于解码视频
OpenVino检测器
保存所有包含任何可检测运动的视频7天，无论是否检测到任何对象
如果视频符合警报或检测条件，继续保留30天
保存快照30天
摄像头时间戳的运动遮罩

mqtt:
  host: 192.168.X.X # <---- 与home assistant使用相同的mqtt代理
  user: mqtt-user
  password: xxxxxxxxxx

ffmpeg:
  hwaccel_args: preset-vaapi

detectors:
  ov:
    type: openvino
    device: AUTO

model:
  width: 300
  height: 300
  input_tensor: nhwc
  input_pixel_format: bgr
  path: /openvino-model/ssdlite_mobilenet_v2.xml
  labelmap_path: /openvino-model/coco_91cl_bkgr.txt

record:
  enabled: True
  retain:
    days: 7
    mode: motion
  alerts:
    retain:
      days: 30
  detections:
    retain:
      days: 30

snapshots:
  enabled: True
  retain:
    default: 30

cameras:
  name_of_your_camera:
    detect:
      width: 1280
      height: 720
      fps: 5
    ffmpeg:
      inputs:
        - path: rtsp://10.0.10.10:554/rtsp
          roles:
            - detect
    motion:
      mask:
        - 0.000,0.427,0.002,0.000,0.999,0.000,0.999,0.781,0.885,0.456,0.700,0.424,0.701,0.311,0.507,0.294,0.453,0.347,0.451,0.400

访问Home Assistant插件配置目录​

VS Code配置模式​

环境变量替换​

常见配置示例​

带USB Coral的树莓派Home Assistant插件​

带USB Coral的独立Intel迷你PC​

带OpenVino的Home Assistant集成Intel迷你PC​