Frigate Profiles 配置指南无需重启的摄像头配置覆盖与运行时切换【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigate导读Frigate 的 Profiles配置档案允许你在顶层配置中定义一组命名配置集合在运行时即时激活或停用无需重启 Frigate。它天然适用于在家 / 离家模式切换、白天 / 夜间检测策略切换、按需批量调整多台摄像头的检测、录制与通知行为等场景。读完本文你将掌握 Profiles 的两级配置模型、UI 与 YAML 两种配置方式、支持覆盖的完整配置区块、四种激活途径以及其底层合并与校验机制的源码级原理。Profiles 是什么两级配置覆盖系统Profiles 的核心思路是不修改基础配置而是以覆盖层的形式临时改变摄像头行为。它由两级结构组成Profile 定义顶层profiles节在配置文件的顶层声明每个定义有一个机器名作为 YAML key内部使用和一个friendly_name用于 UI 展示。摄像头 Profile 覆盖每个摄像头下的profiles节以 profile 名为 key声明该摄像头在该 profile 下需要变更的设置。只需写明想改的字段其余全部继承摄像头的基础配置。当某个 profile 被激活时Frigate 将每台摄像头的 profile 覆盖合并到其基础配置之上停用时所有摄像头恢复原设置。同一时刻只能有一个 profile 处于激活状态激活新 profile 会自动停用当前 profile。:::info 运行时生效无需重启Profile 变更以内存方式应用并立即生效不需要重启 Frigate。激活的 profile 会跨 Frigate 重启保持持久化存储在/config/.profiles文件中。:::创建与管理 Profiles最简单的配置方式是通过 Frigate UI也可以直接在配置文件里手写 YAML。方式一通过 Frigate UI 配置创建 Profile进入Settings Global configuration Profiles点击Add Profile按钮输入名称可选填 profile ID。配置覆盖进入任一摄像头配置区块如 Motion detection、Record、Notifications右上角会出现两个按钮——选择一台摄像头和一个 profile即可为该摄像头在该 profile 下编辑此区块的覆盖。只有你实际修改的字段会被保存为覆盖。需要重启才能生效的字段会被隐藏因为 Profiles 是运行时应用的。点击Remove Profile Override按钮可清除覆盖。激活 Profile通过 Frigate 主菜单中的Profiles选项选择 profile或者在Settings Global configuration Profiles页面的 Active Profile 下拉框中选择。桌面浏览器底部状态栏会显示当前激活的 profile。删除 Profile进入Settings Global configuration Profiles点击对应 profile 的垃圾桶图标。这会同时删除该 profile 定义及与之关联的所有摄像头覆盖。方式二通过 YAML 配置首先在 Frigate 配置的顶层定义 profiles。摄像头引用到的每个 profile 名称都必须在这里定义profiles: home: friendly_name: Home away: friendly_name: Away night: friendly_name: Night Mode然后在每台摄像头下添加profiles节写入每个 profile 的覆盖。只需包含想改变的设置cameras: front_door: ffmpeg: inputs: - path: rtsp://camera:554/stream roles: - detect - record detect: enabled: true record: enabled: true profiles: away: detect: enabled: true notifications: enabled: true objects: track: - person - car - package review: alerts: labels: - person - car - package home: detect: enabled: true notifications: enabled: false objects: track: - person对应到源码顶层定义由 frigate/config/profile.py 中的ProfileDefinitionConfig承载——它只有一个必填字段friendly_name而摄像头覆盖由 frigate/config/camera/profile.py 中的CameraProfileConfig承载其所有 section 字段默认均为None只有被显式设置的字段才通过model_dump(exclude_unsetTrue)进入覆盖集合这正是只覆盖你写明的字段这一语义的实现基础。支持覆盖的配置区块以下摄像头配置区块可以在 profile 中被覆盖Section说明enabled整体启用或禁用摄像头audio音频检测设置birdseyeBirdseye 视图设置detect物体检测设置face_recognition人脸识别设置lpr车牌识别设置motion运动检测设置notifications通知设置objects物体跟踪与过滤设置record录像设置review回顾告警与检测设置snapshots快照设置zones区域定义与基础区域合并这一列表与源码中 frigate/config/profile_manager.py 里的PROFILE_SECTION_UPDATES常量一一对应audio、birdseye、detect、face_recognition、lpr、motion、notifications、objects、record、review、snapshots、zones加上独立的enabled字段共 13 类可覆盖项。:::note 覆盖语义只有你在 profile 覆盖中显式设置的字段才会被应用其余字段保持基础配置值。对于掩码masks和区域zonesprofile 中的区域会覆盖摄像头基础配置中的掩码与区域。若通过 YAML 配置 profiles你不应在 profile 中定义基础配置中不存在的掩码或区域。:::激活与停用 ProfilesProfile 可以通过 Frigate UI、MQTT、HTTP API 以及 Home Assistant 集成来激活与停用。在 Frigate UI 中打开 Settings 齿轮并选择子菜单中的Profiles即可看到所有已定义的 profile从中可以激活任意 profile 或停用当前 profile。UI 会明确标示当前激活的 profile。激活或停用 profile 会清除任何运行时开关覆盖runtime toggle overrides相关机制见 运行时开关持久化避免切换前残留的过期开关状态悄然撤销 profile 的设置。通过 MQTT 激活源码中Frigate 会订阅{topic_prefix}/profile/set主题见 frigate/comms/mqtt.py。向该主题发布 profile 名即可激活对应 profile发布空字符串、none或None则停用当前 profile。每次激活/停用后Frigate 还会向{topic_prefix}/profile/state发布 retained 消息激活时发布 profile 名停用时发布none使 MQTT 客户端与 Home Assistant 始终能感知当前状态。该回调实现在 frigate/comms/dispatcher.py 的_on_profile_command中payload.strip()为空、none或None时视为停用传入None否则调用profile_manager.activate_profile(profile_name)。通过 HTTP API 激活Frigate 暴露了 profile 相关的只读 API 端点见 frigate/api/app.pyGET /api/profiles列出所有可用 profile含friendly_name以及当前激活状态与最近激活时间戳GET /api/profile/active返回当前激活的 profile 名称。激活操作本身由 UI、MQTT 或 Home Assistant 集成驱动底层统一调用ProfileManager.activate_profile()。实战示例Home / Away 双模式配置最常见的用法是在家 / 离家两套检测与通知策略。以下示例针对两台摄像头front_door与indoor_cam演示完整配置。通过 UI 配置进入Settings Global configuration Profiles创建两个 profileHome与Away。在 Settings 的 Camera configuration 区块中选择front_door摄像头在 profile 下拉框中选择Away然后在 Notifications 面板启用通知在 Review 面板将告警标签设为person和car再从 profile 下拉框选择Home进入 Notifications 禁用通知。对indoor_cam摄像头执行类似步骤——将Awayprofile 配置为启用摄像头、检测与录像将Homeprofile 配置为出于隐私考虑完全禁用摄像头。从Settings Global configuration Profiles或 Frigate 主菜单的Profiles选项激活所需 profile。通过 YAML 配置profiles: home: friendly_name: Home away: friendly_name: Away cameras: front_door: ffmpeg: inputs: - path: rtsp://camera:554/stream roles: - detect - record detect: enabled: true record: enabled: true notifications: enabled: false profiles: away: notifications: enabled: true review: alerts: labels: - person - car home: notifications: enabled: false indoor_cam: ffmpeg: inputs: - path: rtsp://camera:554/indoor roles: - detect - record detect: enabled: false record: enabled: false profiles: away: enabled: true detect: enabled: true record: enabled: true home: enabled: false此示例的行为Away profilefront_door启用通知并跟踪指定告警标签indoor_cam完全启用检测 录像。Home profilefront_door禁用通知indoor_cam出于隐私完全禁用。无 profile 激活所有摄像头使用基础配置值。源码级原理ProfileManager 的激活流程理解ProfileManagerfrigate/config/profile_manager.py的实现可以更准确地把握 Profiles 的行为边界。1. 基础配置快照。初始化时_snapshot_base_configs()为每台摄像头保存所有可覆盖 section 的配置、enabled状态以及 zones 的深拷贝作为回滚基准。2. 激活 先重置、再覆盖。activate_profile()调用_apply_to_config()先_reset_to_base()把所有摄像头恢复为基础配置再_apply_profile_overrides()逐个摄像头应用目标 profile 的覆盖。因此即使从 profile A 直接切到 profile B结果也是基础配置 B 的覆盖不会残留 A 的任何字段。覆盖采用deep_merge(overrides, base_data)的方式profile 中显式设置的字段exclude_unsetTrue提取叠在基础 section 之上。3. 变更发布。_publish_updates()只对实际发生变化的摄像头/区块组合通过 ZMQ 的CameraConfigUpdateTopic发布配置更新让各工作进程立即感知。同时对于notifications、record、review、detect、motion、snapshots、audio、birdseye、objects等区块还会按SECTION_STATE_TOPICS的定义重发对应的 retained MQTT 开关状态如front/review_alerts/state避免 Home Assistant 等外部集成停留在切换前的旧开关状态。4. 运行时覆盖清理。用户发起的激活/停用clear_runtime_overridesTrue会调用dispatcher.clear_runtime_state()清空运行时开关覆盖文件保证 profile 设置不被旧开关状态静默覆盖而启动时恢复持久化 profile 的路径则传False保留运行时状态供后续重放。对应回归测试见 frigate/test/test_profiles.py 的test_activate_profile_clears_dispatcher_runtime_state与test_startup_replay_does_not_clear_runtime_state。5. 持久化。每次激活/停用都会把active字段及last_activated时间戳写入/config/.profilesJSON 格式。启动时restore_persisted_profile_to_config()先把持久化的 profile 应用到内存配置保证工作进程拿到已带 profile 的配置restore_persisted_profile()再在订阅者就绪后补发一次完整激活广播。若持久化的 profile 已不再被任何摄像头引用例如已被删除则会被忽略并视为未激活。6. 区域合并细节。zones 的覆盖采用以基础区域为底、profile 区域合并覆盖的方式merged_zones deepcopy(base_zones); merged_zones.update(profile.zones)。由于 profile 中解析出的 zone 对象缺少颜色与轮廓源码会为无轮廓的区域按摄像头帧尺寸重新生成轮廓generate_contour并在颜色缺失时继承基础区域的颜色——这也是profile 区域会覆盖基础区域背后细致的工程处理。配置校验zone 与 mask 必须存在于基础配置Frigate 在启动解析时执行严格的校验见 frigate/config/config.py 的verify_profile_overrides_match_baseprofile 中定义的每个 zone 名称必须已存在于该摄像头的基础zones中profile 的motion.mask中每个掩码名必须已存在于基础motion.mask中profile 的objects.mask以及每个标签filters下的掩码名也必须分别存在于基础的objects.mask与对应标签的基础过滤器掩码中摄像头profiles节引用的每个 profile 名必须在顶层profiles节中有定义。违反上述任何一条配置都会在启动时被拒绝抛出ValueError。对应测试覆盖了profile 定义基础中不存在的 zone/mask 被拒绝test_profile_zone_without_base_rejected、test_profile_motion_mask_without_base_rejected以及引用未定义 profile 被拒绝test_undefined_profile_reference_rejected等场景。如果你希望某个 zone 或 mask 只在特定 profile 下生效正确做法是在基础配置中定义它并设置enabled: false然后在 profile 覆盖中将其启用。FAQ我可以在 profile 中定义一个基础配置里没有的 zone 或 mask 吗不可以。Profiles 是纯粹的覆盖层profile 中定义的每个 zone 和 mask 都必须引用基础摄像头配置中已存在的条目。引入仅存在于 profile 的 zone/mask 的配置会在启动时被拒绝。若想让某个 zone/mask 仅在特定 profile 下生效请在基础配置中定义它并设enabled: false再在 profile 覆盖中启用。如何将 profile 中的 zone/mask 覆盖恢复为基础配置删除该覆盖即可。在 Frigate UI 中编辑 profile对 zone/mask 使用 Revert override 操作垃圾桶图标。基础条目不受影响覆盖删除后该 profile 对该 zone/mask 自动继承基础值。可以同时激活多个 profile 吗不可以。同一时刻只能激活一个 profile激活新 profile 会自动停用当前 profile。如果我从基础配置中删除了某个 zone 或 mask我的 profile 覆盖会怎样在 Frigate UI 中删除基础 zone/mask 时属于该条目的所有 profile 覆盖会在同一操作中自动删除。如果通过直接编辑配置文件移除基础条目却遗留了 profile 覆盖配置会在启动时校验失败直到删掉这个孤儿覆盖为止。如何让一个 YAML profile 完全不跟踪任何物体在 profile 中将跟踪物体列表显式设为空列表cameras: front_door: profiles: home: objects: track: []注意把objects节留空或省略track不会清空列表——空节不会设置任何字段因此 profile 会继承基础配置中的完整跟踪列表包括全局层级的设置。这一规则同样适用于其他列表字段如audio.listen。为什么我配置 profile 覆盖时有些设置是缺失的需要重启 Frigate 才能生效的字段无法被 profile 覆盖因为 profile 是运行时应用、不重启的。这些字段在编辑 profile 覆盖时会被隐藏只能在基础配置中修改。我可以按时间调度自动启用/停用 profile 吗Frigate 本身不支持。Frigate 是 NVR 而非自动化平台因此刻意不内置 profile 调度器。建议从已经擅长时间/事件触发的自动化平台如 Home Assistant 或 Node-RED来激活 profile——它们与 Frigate 集成良好能提供远比内置调度器健壮、灵活的调度能力。如果你偏好轻量方案用 cron 定时任务驱动一个简单脚本来切换 profile 同样可行。相关资源功能文档docs/docs/configuration/profiles.md配置模型frigate/config/profile.py、frigate/config/camera/profile.py核心实现frigate/config/profile_manager.py校验逻辑frigate/config/config.pyMQTT 集成frigate/comms/mqtt.py、frigate/comms/dispatcher.pyHTTP APIfrigate/api/app.py测试用例frigate/test/test_profiles.py相关集成MQTT 主题文档、Home Assistant 集成、运行时开关持久化【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/10 17:05:29 · 阅读 1.2k Frigate Profiles 配置指南：无需重启的摄像头配置覆盖与运行时切换
Frigate Profiles 配置指南无需重启的摄像头配置覆盖与运行时切换【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigate导读Frigate 的 Profiles配置档案允许你在顶层配置中定义一组命名配置集合在运行时即时激活或停用无需重启 Frigate。它天然适用于在家 / 离家模式切换、白天 / 夜间检测策略切换、按需批量调整多台摄像头的检测、录制与通知行为等场景。读完本文你将掌握 Profiles 的两级配置模型、UI 与 YAML 两种配置方式、支持覆盖的完整配置区块、四种激活途径以及其底层合并与校验机制的源码级原理。Profiles 是什么两级配置覆盖系统Profiles 的核心思路是不修改基础配置而是以覆盖层的形式临时改变摄像头行为。它由两级结构组成Profile 定义顶层profiles节在配置文件的顶层声明每个定义有一个机器名作为 YAML key内部使用和一个friendly_name用于 UI 展示。摄像头 Profile 覆盖每个摄像头下的profiles节以 profile 名为 key声明该摄像头在该 profile 下需要变更的设置。只需写明想改的字段其余全部继承摄像头的基础配置。当某个 profile 被激活时Frigate 将每台摄像头的 profile 覆盖合并到其基础配置之上停用时所有摄像头恢复原设置。同一时刻只能有一个 profile 处于激活状态激活新 profile 会自动停用当前 profile。:::info 运行时生效无需重启Profile 变更以内存方式应用并立即生效不需要重启 Frigate。激活的 profile 会跨 Frigate 重启保持持久化存储在/config/.profiles文件中。:::创建与管理 Profiles最简单的配置方式是通过 Frigate UI也可以直接在配置文件里手写 YAML。方式一通过 Frigate UI 配置创建 Profile进入Settings Global configuration Profiles点击Add Profile按钮输入名称可选填 profile ID。配置覆盖进入任一摄像头配置区块如 Motion detection、Record、Notifications右上角会出现两个按钮——选择一台摄像头和一个 profile即可为该摄像头在该 profile 下编辑此区块的覆盖。只有你实际修改的字段会被保存为覆盖。需要重启才能生效的字段会被隐藏因为 Profiles 是运行时应用的。点击Remove Profile Override按钮可清除覆盖。激活 Profile通过 Frigate 主菜单中的Profiles选项选择 profile或者在Settings Global configuration Profiles页面的 Active Profile 下拉框中选择。桌面浏览器底部状态栏会显示当前激活的 profile。删除 Profile进入Settings Global configuration Profiles点击对应 profile 的垃圾桶图标。这会同时删除该 profile 定义及与之关联的所有摄像头覆盖。方式二通过 YAML 配置首先在 Frigate 配置的顶层定义 profiles。摄像头引用到的每个 profile 名称都必须在这里定义profiles: home: friendly_name: Home away: friendly_name: Away night: friendly_name: Night Mode然后在每台摄像头下添加profiles节写入每个 profile 的覆盖。只需包含想改变的设置cameras: front_door: ffmpeg: inputs: - path: rtsp://camera:554/stream roles: - detect - record detect: enabled: true record: enabled: true profiles: away: detect: enabled: true notifications: enabled: true objects: track: - person - car - package review: alerts: labels: - person - car - package home: detect: enabled: true notifications: enabled: false objects: track: - person对应到源码顶层定义由 frigate/config/profile.py 中的ProfileDefinitionConfig承载——它只有一个必填字段friendly_name而摄像头覆盖由 frigate/config/camera/profile.py 中的CameraProfileConfig承载其所有 section 字段默认均为None只有被显式设置的字段才通过model_dump(exclude_unsetTrue)进入覆盖集合这正是只覆盖你写明的字段这一语义的实现基础。支持覆盖的配置区块以下摄像头配置区块可以在 profile 中被覆盖Section说明enabled整体启用或禁用摄像头audio音频检测设置birdseyeBirdseye 视图设置detect物体检测设置face_recognition人脸识别设置lpr车牌识别设置motion运动检测设置notifications通知设置objects物体跟踪与过滤设置record录像设置review回顾告警与检测设置snapshots快照设置zones区域定义与基础区域合并这一列表与源码中 frigate/config/profile_manager.py 里的PROFILE_SECTION_UPDATES常量一一对应audio、birdseye、detect、face_recognition、lpr、motion、notifications、objects、record、review、snapshots、zones加上独立的enabled字段共 13 类可覆盖项。:::note 覆盖语义只有你在 profile 覆盖中显式设置的字段才会被应用其余字段保持基础配置值。对于掩码masks和区域zonesprofile 中的区域会覆盖摄像头基础配置中的掩码与区域。若通过 YAML 配置 profiles你不应在 profile 中定义基础配置中不存在的掩码或区域。:::激活与停用 ProfilesProfile 可以通过 Frigate UI、MQTT、HTTP API 以及 Home Assistant 集成来激活与停用。在 Frigate UI 中打开 Settings 齿轮并选择子菜单中的Profiles即可看到所有已定义的 profile从中可以激活任意 profile 或停用当前 profile。UI 会明确标示当前激活的 profile。激活或停用 profile 会清除任何运行时开关覆盖runtime toggle overrides相关机制见 运行时开关持久化避免切换前残留的过期开关状态悄然撤销 profile 的设置。通过 MQTT 激活源码中Frigate 会订阅{topic_prefix}/profile/set主题见 frigate/comms/mqtt.py。向该主题发布 profile 名即可激活对应 profile发布空字符串、none或None则停用当前 profile。每次激活/停用后Frigate 还会向{topic_prefix}/profile/state发布 retained 消息激活时发布 profile 名停用时发布none使 MQTT 客户端与 Home Assistant 始终能感知当前状态。该回调实现在 frigate/comms/dispatcher.py 的_on_profile_command中payload.strip()为空、none或None时视为停用传入None否则调用profile_manager.activate_profile(profile_name)。通过 HTTP API 激活Frigate 暴露了 profile 相关的只读 API 端点见 frigate/api/app.pyGET /api/profiles列出所有可用 profile含friendly_name以及当前激活状态与最近激活时间戳GET /api/profile/active返回当前激活的 profile 名称。激活操作本身由 UI、MQTT 或 Home Assistant 集成驱动底层统一调用ProfileManager.activate_profile()。实战示例Home / Away 双模式配置最常见的用法是在家 / 离家两套检测与通知策略。以下示例针对两台摄像头front_door与indoor_cam演示完整配置。通过 UI 配置进入Settings Global configuration Profiles创建两个 profileHome与Away。在 Settings 的 Camera configuration 区块中选择front_door摄像头在 profile 下拉框中选择Away然后在 Notifications 面板启用通知在 Review 面板将告警标签设为person和car再从 profile 下拉框选择Home进入 Notifications 禁用通知。对indoor_cam摄像头执行类似步骤——将Awayprofile 配置为启用摄像头、检测与录像将Homeprofile 配置为出于隐私考虑完全禁用摄像头。从Settings Global configuration Profiles或 Frigate 主菜单的Profiles选项激活所需 profile。通过 YAML 配置profiles: home: friendly_name: Home away: friendly_name: Away cameras: front_door: ffmpeg: inputs: - path: rtsp://camera:554/stream roles: - detect - record detect: enabled: true record: enabled: true notifications: enabled: false profiles: away: notifications: enabled: true review: alerts: labels: - person - car home: notifications: enabled: false indoor_cam: ffmpeg: inputs: - path: rtsp://camera:554/indoor roles: - detect - record detect: enabled: false record: enabled: false profiles: away: enabled: true detect: enabled: true record: enabled: true home: enabled: false此示例的行为Away profilefront_door启用通知并跟踪指定告警标签indoor_cam完全启用检测 录像。Home profilefront_door禁用通知indoor_cam出于隐私完全禁用。无 profile 激活所有摄像头使用基础配置值。源码级原理ProfileManager 的激活流程理解ProfileManagerfrigate/config/profile_manager.py的实现可以更准确地把握 Profiles 的行为边界。1. 基础配置快照。初始化时_snapshot_base_configs()为每台摄像头保存所有可覆盖 section 的配置、enabled状态以及 zones 的深拷贝作为回滚基准。2. 激活 先重置、再覆盖。activate_profile()调用_apply_to_config()先_reset_to_base()把所有摄像头恢复为基础配置再_apply_profile_overrides()逐个摄像头应用目标 profile 的覆盖。因此即使从 profile A 直接切到 profile B结果也是基础配置 B 的覆盖不会残留 A 的任何字段。覆盖采用deep_merge(overrides, base_data)的方式profile 中显式设置的字段exclude_unsetTrue提取叠在基础 section 之上。3. 变更发布。_publish_updates()只对实际发生变化的摄像头/区块组合通过 ZMQ 的CameraConfigUpdateTopic发布配置更新让各工作进程立即感知。同时对于notifications、record、review、detect、motion、snapshots、audio、birdseye、objects等区块还会按SECTION_STATE_TOPICS的定义重发对应的 retained MQTT 开关状态如front/review_alerts/state避免 Home Assistant 等外部集成停留在切换前的旧开关状态。4. 运行时覆盖清理。用户发起的激活/停用clear_runtime_overridesTrue会调用dispatcher.clear_runtime_state()清空运行时开关覆盖文件保证 profile 设置不被旧开关状态静默覆盖而启动时恢复持久化 profile 的路径则传False保留运行时状态供后续重放。对应回归测试见 frigate/test/test_profiles.py 的test_activate_profile_clears_dispatcher_runtime_state与test_startup_replay_does_not_clear_runtime_state。5. 持久化。每次激活/停用都会把active字段及last_activated时间戳写入/config/.profilesJSON 格式。启动时restore_persisted_profile_to_config()先把持久化的 profile 应用到内存配置保证工作进程拿到已带 profile 的配置restore_persisted_profile()再在订阅者就绪后补发一次完整激活广播。若持久化的 profile 已不再被任何摄像头引用例如已被删除则会被忽略并视为未激活。6. 区域合并细节。zones 的覆盖采用以基础区域为底、profile 区域合并覆盖的方式merged_zones deepcopy(base_zones); merged_zones.update(profile.zones)。由于 profile 中解析出的 zone 对象缺少颜色与轮廓源码会为无轮廓的区域按摄像头帧尺寸重新生成轮廓generate_contour并在颜色缺失时继承基础区域的颜色——这也是profile 区域会覆盖基础区域背后细致的工程处理。配置校验zone 与 mask 必须存在于基础配置Frigate 在启动解析时执行严格的校验见 frigate/config/config.py 的verify_profile_overrides_match_baseprofile 中定义的每个 zone 名称必须已存在于该摄像头的基础zones中profile 的motion.mask中每个掩码名必须已存在于基础motion.mask中profile 的objects.mask以及每个标签filters下的掩码名也必须分别存在于基础的objects.mask与对应标签的基础过滤器掩码中摄像头profiles节引用的每个 profile 名必须在顶层profiles节中有定义。违反上述任何一条配置都会在启动时被拒绝抛出ValueError。对应测试覆盖了profile 定义基础中不存在的 zone/mask 被拒绝test_profile_zone_without_base_rejected、test_profile_motion_mask_without_base_rejected以及引用未定义 profile 被拒绝test_undefined_profile_reference_rejected等场景。如果你希望某个 zone 或 mask 只在特定 profile 下生效正确做法是在基础配置中定义它并设置enabled: false然后在 profile 覆盖中将其启用。FAQ我可以在 profile 中定义一个基础配置里没有的 zone 或 mask 吗不可以。Profiles 是纯粹的覆盖层profile 中定义的每个 zone 和 mask 都必须引用基础摄像头配置中已存在的条目。引入仅存在于 profile 的 zone/mask 的配置会在启动时被拒绝。若想让某个 zone/mask 仅在特定 profile 下生效请在基础配置中定义它并设enabled: false再在 profile 覆盖中启用。如何将 profile 中的 zone/mask 覆盖恢复为基础配置删除该覆盖即可。在 Frigate UI 中编辑 profile对 zone/mask 使用 Revert override 操作垃圾桶图标。基础条目不受影响覆盖删除后该 profile 对该 zone/mask 自动继承基础值。可以同时激活多个 profile 吗不可以。同一时刻只能激活一个 profile激活新 profile 会自动停用当前 profile。如果我从基础配置中删除了某个 zone 或 mask我的 profile 覆盖会怎样在 Frigate UI 中删除基础 zone/mask 时属于该条目的所有 profile 覆盖会在同一操作中自动删除。如果通过直接编辑配置文件移除基础条目却遗留了 profile 覆盖配置会在启动时校验失败直到删掉这个孤儿覆盖为止。如何让一个 YAML profile 完全不跟踪任何物体在 profile 中将跟踪物体列表显式设为空列表cameras: front_door: profiles: home: objects: track: []注意把objects节留空或省略track不会清空列表——空节不会设置任何字段因此 profile 会继承基础配置中的完整跟踪列表包括全局层级的设置。这一规则同样适用于其他列表字段如audio.listen。为什么我配置 profile 覆盖时有些设置是缺失的需要重启 Frigate 才能生效的字段无法被 profile 覆盖因为 profile 是运行时应用、不重启的。这些字段在编辑 profile 覆盖时会被隐藏只能在基础配置中修改。我可以按时间调度自动启用/停用 profile 吗Frigate 本身不支持。Frigate 是 NVR 而非自动化平台因此刻意不内置 profile 调度器。建议从已经擅长时间/事件触发的自动化平台如 Home Assistant 或 Node-RED来激活 profile——它们与 Frigate 集成良好能提供远比内置调度器健壮、灵活的调度能力。如果你偏好轻量方案用 cron 定时任务驱动一个简单脚本来切换 profile 同样可行。相关资源功能文档docs/docs/configuration/profiles.md配置模型frigate/config/profile.py、frigate/config/camera/profile.py核心实现frigate/config/profile_manager.py校验逻辑frigate/config/config.pyMQTT 集成frigate/comms/mqtt.py、frigate/comms/dispatcher.pyHTTP APIfrigate/api/app.py测试用例frigate/test/test_profiles.py相关集成MQTT 主题文档、Home Assistant 集成、运行时开关持久化【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考