frigate-hass-integration

把 Frigate AI 监控无缝接入 Home Assistant，实时看事件、玩自动化

开源 free 计算机视觉

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1281

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类计算机视觉

开发团队blakeblackshear

所属国家

官网地址

GitHubhttps://github.com/blakeblackshear/frigate-hass-integration

定价模式free

价格说明开源免费，定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,camera,frigate,hacs,nvr,object-detection

GitHub 星标★ 1281

30天Star增速

HF 下载量

上线时间2020-11-10 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-01

浏览次数8

项目介绍

Frigate Hass Integration 是 Home Assistant 的官方集成组件，用于将 Frigate NVR（网络视频录像机）无缝接入 Home Assistant 智能家居平台。它解决了用户在 Home Assistant 中无法直接管理和查看 Frigate 摄像头事件、物体检测结果的问题。该集成通过 MQTT 和 REST API 与 Frigate 通信，提供实时事件流、物体检测快照、区域监控、人员/车辆识别等功能，并支持在 Home Assistant 的仪表盘中展示摄像头画面和事件时间线。用户可以通过 Lovelace UI 卡片自定义监控布局，设置自动化规则（如检测到人时触发警报）。该项目核心能力包括：双向同步 Frigate 实体、事件回调、媒体浏览器集成、以及通过 HACS 轻松安装。它让非技术用户也能在 Home Assistant 生态中充分利用 Frigate 的 AI 视觉能力，实现本地化、隐私安全的智能监控。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：进阶约 15 分钟部署方式：本地安装 5 步

环境要求

已运行并可登录的 Home Assistant 实例
已安装 HACS（推荐方式，非必需）
Home Assistant 中已安装并配置好 mqtt 集成
已部署可访问的 Frigate NVR 实例

安装与启动步骤

1配置 MQTT 集成

Frigate 集成依赖 mqtt 集成，必须先手动完成配置，否则集成无法工作。进入配置 > 集成添加 mqtt。
2通过 HACS 添加

在 HACS 中依次进入集成 -> 浏览并添加仓库 -> 搜索 Frigate，完成下载安装。这是最简单的安装方式。
3或手动复制组件

高级用户可手动安装：克隆仓库后，把 custom_components/frigate 整个目录复制到 Home Assistant 配置目录下的 custom_components 中。
```
git clone https://github.com/blakeblackshear/frigate-hass-integration.git
cp -r frigate-hass-integration/custom_components/frigate /your/path/homeassistant/custom_components/
```
4重启 Home Assistant

复制文件后需重启 Home Assistant，才能让新的自定义组件被加载识别。
5添加 Frigate 集成

HACS 只负责安装、不会自动配置。请前往配置 > 集成，点击添加集成并选择 Frigate 完成配置。

如何确认成功

在配置 > 集成页面中可以看到 Frigate 集成已成功添加且状态正常，并出现摄像头、传感器等实体。

常见问题

Q：通过 HACS 安装后为什么看不到 Frigate 设备？

A：HACS 不会自动配置集成。必须再进入配置 > 集成，手动添加 Frigate 集成后才会生成实体。

Q：集成添加后无法正常工作怎么办？

A：检查 mqtt 集成是否已安装并正确配置。README 明确指出 mqtt 是前置依赖，且需手动配置，无法自动完成。

Q：不想用 HACS 可以安装吗？

A：可以。高级用户可手动把 custom_components/frigate 目录复制到 Home Assistant 的 custom_components 文件夹，然后重启。

Q：需要支持多个 Frigate 实例怎么配置？

A：该集成支持多个 Frigate 实例，重复执行「添加集成」操作，为每个实例分别添加一次即可。

注意事项

HACS 只安装代码，安装后必须到配置 > 集成手动添加 Frigate。
mqtt 集成必须提前安装并配置，这是集成正常工作的前提。
完整安装说明请参考 Frigate 官方文档的 Home Assistant 集成页面。

核心亮点

官方集成，与 Frigate 和 Home Assistant 同步更新，兼容性好
支持实时事件流和物体检测快照，可在 HA 仪表盘直接查看
深度集成 HA 自动化，可基于检测事件触发场景（如人形识别报警）

不足之处

依赖 Frigate 和 MQTT 服务，部署链路较长，新手配置有门槛
文档/社区待观察

适用场景

家庭安防：在 HA 中集中查看门口、庭院等摄像头 AI 检测事件
智能联动：检测到人/车时自动开灯、推送通知或启动录像
多设备监控：在 HA 仪表盘统一管理多个 Frigate 实例和摄像头

替代项目

Home Assistant 原生 Camera 集成、Blue Iris Integration、MotionEye Integration

上一篇：samexporter

下一篇：TensorRT-YOLO