spupuz/VibeNVR

这是什么？

核心功能

• 01对 RTSP 网络摄像头进行连续录像和移动侦测触发录像。
• 02支持 OpenCV、ONVIF 硬件侦测、海康 ISAPI 及 YOLOv8 等 AI 模型的移动侦测。
• 03事件时间线可按摄像头、事件类型、检测目标和日期筛选。
• 04实时预览支持 WebCodecs、MSE、MJPEG，并可控制云台。
• 05录像可存储到本地或 SFTP，支持自动清理、配额与归档。
• 06按摄像头分配 RBAC 权限，支持 JWT 登录、SSO 与两步验证。
• 07内置 MQTT 服务，支持 Home Assistant 自动发现。

适用场景

• 在树莓派或迷你主机上搭建本地存储的家庭安防系统。
• 用自托管存储替代云端摄像头订阅服务。
• 通过联邦功能在一个主实例中管理多个站点。
• 将摄像头移动和目标事件接入 Home Assistant 自动化。

快速上手

1. 1

   安装 Docker 和 Docker Compose V2

2. 2

   克隆仓库

   git clone https://github.com/spupuz/VibeNVR.git
3. 3

   进入项目目录并在 .env 中设置安全值

   cd VibeNVR
4. 4

   使用生产环境 compose 文件启动服务

   docker compose -f docker-compose.prod.yml up -d

使用前须知

• !需要 Docker 和 Docker Compose，部署依赖容器相关知识。
• !项目被标注为 Vibe Coding 项目，需注意稳定性，更新前请查看发布说明。
• !硬件加速和 AI 检测功能依赖主机硬件。

标签

常见问题

VibeNVR 是什么？

基于 Docker 部署的自托管网络录像机（NVR），支持 IP 摄像头本地录像、移动侦测、AI 目标识别与事件时间线。 VibeNVR 是一个以容器方式部署的网络录像机（NVR），用于管理 IP 摄像头。引擎基于 PyAV 与 FFmpeg 接入 RTSP 视频流，支持 7×24 小时连续录像或按移动侦测录像，并在统一的事件时间线中按摄像头、事件类型、检测目标和时间筛选录像与截图。

VibeNVR 可以免费使用吗？用的什么许可证？

VibeNVR 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

VibeNVR 还在维护吗？

活跃维护中。VibeNVR 最近一次提交是在 2026年10月19日。

VibeNVR 适合用来做什么？

在树莓派或迷你主机上搭建本地存储的家庭安防系统。 用自托管存储替代云端摄像头订阅服务。 通过联邦功能在一个主实例中管理多个站点。 将摄像头移动和目标事件接入 Home Assistant 自动化。

VibeNVR 怎么安装和运行？

安装 Docker 和 Docker Compose V2 克隆仓库: git clone https://github.com/spupuz/VibeNVR.git 进入项目目录并在 .env 中设置安全值: cd VibeNVR 使用生产环境 compose 文件启动服务: docker compose -f docker-compose.prod.yml up -d

在哪里获取 VibeNVR？

源代码和安装说明在 GitHub 上：https://github.com/spupuz/VibeNVR