企业官网建设流程全解析

10 分钟部署 Frigate 本地 AI 安防 NVR：从接入摄像头到降低误报的完整入门指南

【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigate

Frigate 是一个运行在本地网络的 AI 安防监控 NVR：它持续拉取你家用 IP 摄像头的视频流，用本地运行的 AI 模型识别画面中的人、车、宠物，并自动生成可回放的事件——视频全程不出你的局域网，也不需要订阅任何云服务。你只需要一台能跑 Docker 的机器。

快速开始：三步跑起来

把 Frigate 想象成一位住在你局域网里的保安：摄像头是探头，它负责 24 小时盯着画面、记录异常，而且只在"画面里真有人动"的地方才动用 AI 分析，所以资源占用很低。

第一步：准备目录和启动文件

在服务器上创建一个目录，里面放两个空目录和一个 compose 文件（完整目录结构见 docs/docs/guides/getting_started.md）：

mkdir storage config && touch docker-compose.yml

把最小启动配置写进docker-compose.yml：

services: frigate: image: ghcr.io/blakeblackshear/frigate:stable restart: unless-stopped volumes: - ./config:/config - ./storage:/media/frigate ports: - "8971:8971"

第二步：一条命令启动

docker compose up -d

首次启动会自动生成配置文件，并创建一个 admin 账号，密码会打印在日志里，用下面这条命令查看：

docker logs frigate

第三步：打开 Web 界面

浏览器访问https://server_ip:8971，用 admin 登录。你会看到所有摄像头的实时画面墙和历史事件列表——这就是这套本地 AI 安防 NVR 的主界面 🎥。

核心功能怎么用

接入你的第一路摄像头

登录后进入 设置 > 全局配置 > 摄像头管理，点击 Add Camera 按钮，向导会带你填写 RTSP 地址、检测分辨率等参数。写入 YAML 后对应的配置长这样：

cameras: front_door: ffmpeg: inputs: rtsp: rtsp://user:pass@192.168.1.50:554/stream1 detect: resolution: 1280x720

配好后实时画面上会出现识别框，一旦检测到目标，事件列表里会自动多出一条带缩略图的记录。

用 Zone 和阈值减少误报

树叶晃动、路灯闪烁都可能触发误报，两种手段配合使用：

1. 在 Web 界面给摄像头画 Zone（区域），只有目标进入区域才生成事件：

2. 提高置信度阈值threshold（说明见 docs/docs/configuration/objects.md）：

objects: filters: person: threshold: 0.7

值越接近 1 越"较真"，误报减少但可能漏报，建议从 0.7 起步再微调。

回看事件与录像

事件页支持按对象类型和时间筛选，点击事件即可拖动时间轴回看前后上下文；配合 24/7 录像，可以把"当时到底发生了什么"完整调出来。录像保留与导出策略见 docs/docs/configuration/record.md。

关键配置详解

最常动手修改的五项参数

实用技巧与常见坑

三条直接照做的建议

• 日志里出现Bus error，基本就是shm_size不够，按 docs/docs/frigate/installation.md 中的 shm-size 计算方法加大它。
• 想让 CPU 轻松下来，就把解码交给显卡：compose 文件中加devices: - /dev/dri/renderD128:/dev/dri/renderD128，再把hwaccel_args设为preset-vaapi。
• 手上有 Coral、GPU 或 NPU 等加速卡的，去 docs/docs/configuration/object_detectors.md 按硬件找对应的detectors写法，检测性能提升非常直观。

摄像头画面是灰的？

先确认 RTSP 地址能在 VLC 里直接播放，再检查 compose 文件里FRIGATE_RTSP_PASSWORD环境变量是否与摄像头密码一致——这是新手最高频的坑。

到这里，你的局域网里已经住进了一位 Frigate 保安：摄像头接入、区域圈定、阈值调好，剩下的就是每天在事件页翻一翻"今天家里发生了什么"。想继续深挖 Home Assistant 联动、MQTT 集成或硬件加速细节，从仓库内文档 docs/ 出发即可；检测器实现位于 frigate/detectors/，对象跟踪逻辑在 frigate/track/，读源码时可以从这两处入手。

【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigate