跳到主要内容

摄像头配置

设置摄像头输入源​

可以为每个摄像头配置多个输入源，并根据需求混合搭配每个输入源的角色。这样您可以使用低分辨率视频流进行物体检测，同时使用高分辨率视频流进行录像，反之亦然。

默认情况下摄像头是启用的，但可以通过设置enabled: False来禁用。通过配置文件禁用的摄像头不会出现在Frigate用户界面中，也不会消耗系统资源。

每个角色在每个摄像头中只能分配给一个输入源。可用的角色选项如下：

角色描述
detect用于物体检测的主视频流。文档
record根据配置设置保存视频片段。文档
audio用于基于音频的检测。文档
mqtt:
  host: mqtt.server.com
cameras:
  back: # <- 摄像头名称，暂时只支持英文数字和下划线
    enabled: True
    ffmpeg:
      inputs:
        # 摄像头rtsp流地址可查阅摄像头文档或互联网其他人分享的教程，下面的地址仅为范例
        - path: rtsp://viewer:{FRIGATE_RTSP_PASSWORD}@10.0.10.10:554/cam/realmonitor?channel=1&subtype=2
          roles:
            - detect  # <- 用于物体检测
        # 可以设置不同的流用于不同功能，例如上面的流为子码流，节省带宽，适合检测，能够降低检测器负担
        # 主码流画面清晰，适合录制
        - path: rtsp://viewer:{FRIGATE_RTSP_PASSWORD}@10.0.10.10:554/live
          roles:
            - record  # <- 用于录像
    detect:
      width: 1280 # <- 可选，默认Frigate会尝试自动检测分辨率
      height: 720 # <- 可选，默认Frigate会尝试自动检测分辨率

只需在配置文件的cameras条目下添加更多摄像头即可。

mqtt: ...
cameras:
  back: ...
  front: ...
  side: ...
备注

如果您只定义了一个视频流输入且没有为其分配detect角色，Frigate会自动将其分配为detect角色。即使您在配置的detect部分中通过enabled: False禁用了物体检测，Frigate仍会解码视频流以支持运动检测、鸟瞰图、API图像端点和其他功能。

如果您计划仅使用Frigate进行录像，仍建议为低分辨率视频流定义detect角色，以减少所需视频流解码的资源消耗。

关于特定摄像头型号的设置，请查看摄像头特定信息。

设置摄像头PTZ控制​

注意

并非所有PTZ摄像头都支持ONVIF，这是Frigate用来与您的摄像头通信的标准协议。请检查官方ONVIF兼容产品列表、您的摄像头文档或制造商网站，以确保您的PTZ支持ONVIF。同时，请确保您的摄像头运行最新的固件。

在配置文件的摄像头部分添加onvif配置：

cameras:
  back: # <- 为名为back的摄像头配置ONVIF
    ffmpeg: ...
    onvif:
      host: 10.0.10.10
      port: 8000
      user: admin
      password: password

如果ONVIF连接成功，PTZ控制将在摄像头的Web界面中可用。

提示

如果您的ONVIF摄像头不需要认证凭据，您可能仍需要为user和password指定空字符串，例如：user: ""和password: ""。

支持视野(FOV)内相对移动的ONVIF摄像头还可以配置为自动跟踪移动物体并将其保持在画面中央。关于自动跟踪的设置，请参阅自动跟踪文档。

ONVIF PTZ摄像头推荐​

以下工作与非工作PTZ摄像头列表基于用户反馈。

品牌或具体型号PTZ控制自动跟踪备注
Amcrest✅✅⛔️ 一般来说Amcrest应该可以工作，但一些旧型号(如常见的IP2M-841)不支持自动跟踪
Amcrest ASH21✅❌ONVIF服务端口: 80
Amcrest IP4M-S2112EW-AI✅❌不支持FOV相对移动。
Amcrest IP5M-1190EW✅❌ONVIF端口: 80。不支持FOV相对移动。
Annke CZ504✅✅安克（Annke）官方支持提供了专用固件版本（V5.7.1 build 250227）以修复ONVIF协议中"TranslationSpaceFov"参数的兼容性问题。
Ctronics PTZ✅❌
Dahua✅✅据用户反馈，部分低端大华摄像头（尤其是Lite系列等入门机型）存在​​不支持自动跟踪功能​​的情况。
Dahua DH-SD2A500HB✅❌
Foscam R5✅❌
Hanwha XNP-6550RH✅❌
Hikvision✅❌ONVIF支持不完整(即使是最新固件MoveStatus也不会更新) - 在HWP-N4215IH-DE和DS-2DE3304W-DE型号上报告，但可能还有其他型号
Hikvision DS-2DE3A404IWG-E/W✅✅
Reolink 511WA✅❌仅支持缩放
Reolink E1 Pro✅❌
Reolink E1 Zoom✅❌
Reolink RLC-823A 16x✅❌
Speco O8P32X✅❌
Sunba 405-D20X✅❌原始型号和4k型号报告ONVIF支持不完整。怀疑所有型号都不兼容。
Tapo✅❌支持多种型号，ONVIF服务端口: 2020
Uniview IPC672LR-AX4DUPK✅❌固件声称支持FOV相对移动，但在发送ONVIF命令时摄像头实际上不会移动
Uniview IPC6612SR-X33-VG✅✅保持calibrate_on_startup为False。有用户报告使用absolute缩放是有效的。
Vikylin PTZ-2804X-I2❌❌ONVIF支持不完整

设置摄像头分组​

提示

建议使用用户界面设置摄像头分组。

摄像头可以分组并分配名称和图标，这样可以一起查看和筛选。始终会有一个包含所有摄像头的默认分组。

camera_groups:
  front:  # <- 分组名称，暂时只支持英文数字和下划线
    cameras:
      - driveway_cam  # <- 摄像头名称
      - garage_cam  # <- 摄像头名称
    icon: LuCar
    order: 0