Frigate 完整安装教程:30 分钟部署本地监控 AI NVR 与实时对象检测 📅 发布时间:2026/9/1 10:18:58 👁 浏览次数: Frigate 完整安装教程30 分钟部署本地监控 AI NVR 与实时对象检测【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigateFrigate 是一款面向 IP 摄像头的本地监控 NVR内置实时对象检测所有视频分析都在你自己的机器上完成不依赖云端适合家庭门口、店铺前台这类场景。本文按选硬件 → 部署第一路摄像头 → 进阶优化的顺序讲完整流程。三分钟看懂Frigate 是什么Frigate 的定位是本地优先的 NVR。它拉取摄像头的 RTSP 流后先用开销极低的运动检测帧差法加高斯模糊判断画面哪里在动再只对运动区域运行对象检测。底层基于 OpenCV 与 TensorFlow检测运行在独立进程中以保证实时性结果通过 MQTT 对外广播方便接入其他系统。核心能力一次说清实时对象检测人、车等目标出现即画框只在必要时分析事件录像支持 7x24 小时录像按检测到的对象决定保留多久旧片段自动清理通知推送事件可经 MQTT 集成推送到 Home Assistant 或手机鸟瞰图一个画面看所有摄像头支持按连续、运动、对象三种模式过滤更多背景可以看官方文档。开始之前硬件与环境怎么选Frigate 推荐跑在安装了 Docker 的 Debian 系 Linux 上虚拟机Proxmox、ESXi 等不推荐因为加速器设备透传不稳定、开销更大。硬件起步建议按摄像头路数可以先低配后升级场景CPU内存存储加速器建议单路摄像头双核 2.0GHz 以上4GB64GB SSD可选内置 OpenVINO CPU 推理即可4 路摄像头四核i5 级8GB256GB SSD推荐 Google Coral USB 或 Hailo-8L8 路及以上八核i7 级16GB1TB SSD 或 NASHailo-8 或独立显卡软件前提Docker Engine Docker Compose不需要 Docker Desktop按官方文档用 apt 源安装摄像头建议 H.264 视频 AAC 音频兼容性最好WiFi 摄像头流不稳定优先有线共享内存默认 128MB 约够 2 路 720p 检测摄像头多时需在 compose 里加shm_size加速器是可选项官方支持 Google CoralUSB/M.2、Hailo-8/8L树莓派 5 与 x86、Intel 显卡OpenVINO、AMD/Nvidia 显卡等具体选型见检测模块与文档中的硬件推荐章节。 首次部署第一路摄像头上线第一步准备目录。在服务器上建两个目录mkdir storage config touch docker-compose.yml第二步写docker-compose.yml按官方文档示例精简services: frigate: restart: unless-stopped # 异常退出自动拉起 image: ghcr.io/blakeblackshear/frigate:stable environment: FRIGATE_RTSP_PASSWORD: changeme # RTSP 密码配置里引用 volumes: - ./config:/config # 配置文件 - ./storage:/media/frigate # 录像与事件存储 ports: - 8971:8971 # Web 界面与 API - 8554:8554 # RTSP 重推流第三步写config/config.yml。文件可以留空——Frigate 首次启动会自动生成基础配置之后在设置界面里补。这里给一个最小示例mqtt: enabled: False # 不接 Home Assistant 时保持关闭 cameras: front_door: # 摄像头名称改成你自己的 ffmpeg: inputs: - path: rtsp://user:{FRIGATE_RTSP_PASSWORD}192.168.1.10:554/stream1 roles: - detect # 该流用于运动检测与对象检测 record: enabled: True # 开启录像第四步启动并验证。docker compose up -d首次启动会生成管理员账号和初始密码用docker logs frigate查看。浏览器打开https://服务器IP:8971登录在添加摄像头向导里填 RTSP 地址即可。Live 页面有人或车经过时应能看到检测框实时出现。 进阶用法三个高频配置接入 Coral 或 Hailo 加速器先把设备透传给容器再在配置里声明检测器# docker-compose.yml 的 services.frigate 下添加二选一 devices: - /dev/bus/usb:/dev/bus/usb # USB Coral - /dev/hailo0 # Hailo-8/8L # config.yml 中声明检测器以 Coral 为例 detectors: coral: type: edgetpu device: usbHailo 需先在宿主机装好驱动安装指南附一键脚本默认模型 YOLOv6n 会自动生效无需手选Coral 主要适配 ssdlite、mobilenet 一类模型。改完 compose 后重新docker compose up -d。录像保留多久事件驱动的策略思路一句话平时少留有事多留。默认 Frigate 会为所有被跟踪的对象保留 10 天视频可按连续录像 → 有运动 → 有告警/检测分级设置record: enabled: True # 开启录像 continuous: days: 3 # 连续录像保留 3 天可省略 motion: days: 7 # 出现运动的画面保留 7 天 alerts: retain: days: 30 # 触发告警的事件保留 30 天 mode: all文件按日期存放在/media/frigate/recordings过期自动清理。实现细节见录像模块。低配设备降载调小 detect 流的width/height/fps720p 5fps 是常见的检测起步点给低配机器配一条专门的低清流只承担detect角色高清流仅用于录像用 Docker 的资源限制cpus / memory给容器封顶日志反复出现Bus error一般是共享内存不足调大shm_size❓ 常见问题与优化问模型要手动下载吗不用。默认走 CPU 上的 OpenVINO容器自带 ssdlite_mobilenet_v2 模型Hailo 默认 YOLOv6n。想换自定义模型时在model段指定path与labelmap_path即可。问日志出现 Connection refused / 401 / 404refused 表示地址无人监听或摄像头并发连接数已满401 是账号密码错误404 是流地址路径写错。先用 VLC 或摄像头 Web 管理页逐项核对再改配置。问摄像头连上了但没有检测框按顺序排查detect.enabled是否为 True要跟踪的目标person、car 等是否在 objects 配置里运动遮罩是否误盖住整屏。可在单摄像头视图打开调试开关观察运动框是否在目标区域触发。问硬盘快写满了怎么办保留策略自动执行不会无限增长。某个片段想长期保存时在 WebUI 里导出它——导出的文件不受保留策略影响不会被删除。小结到这里一套完全本地运行的 Frigate 本地监控系统已经可用实时对象检测、事件录像、通知、鸟瞰图全部就绪。配置项的完整参考和逐条错误说明都在官方文档的 troubleshooting 章节社区也非常活跃遇到问题优先查那里。家里有摄像头的选一路信号最稳定的先跑起来半小时内就能见到效果。【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigate创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考