LiteNVR：ZimaOS 轻量 NVR

13次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 litenvr

LiteNVR 是给 ZimaOS 这类家庭 NAS 准备的轻量 NVR：Python 写的独立应用，RTSP 码流直接落盘（-c:v copy，不二次编码），号称 CPU 占用不到 1%。它真正的差异化不在录像，而在联动——Home Assistant 的移动侦测能触发它录像，它的摄像头又能通过 MQTT Discovery 在 HA 里生成快照实体，还留了外部 AI 识别事件的接入点。本文把两条 HA 接入链路、编码坑和它的轻的代价一次讲清，内容据仓库 README（越南语）整理，未经本地实测。

LiteNVR 软件信息一览

项目	说明
软件名称	LiteNVR（ZimaOS 轻量 NVR）
运行平台	Linux（Docker 部署，面向 ZimaOS）
接入方式	ZimaOS 一键安装模板、docker-compose
核心链路	RTSP 直存（-c:v copy）、HLS 直播、MQTT Discovery、HA WebSocket
AI 扩展	外部识别事件接口（POST /api/ai/detect）
Web 安全	独立登录页、子账号、双因素认证、防暴力破解
项目主页	GitHub 开源仓库

核心功能：录像只是基本盘，联动才是卖点

超轻录像：RTSP 码流 -c:v copy 直接写盘，不转码，据 README CPU 占用不到 1%，适合 7×24 小时挂在 NAS 上。
HA 移动侦测联动：通过 WebSocket 连 Home Assistant，订阅 binary_sensor 这类实体，状态翻转才触发对应摄像头录像加抓拍，不重复触发。
MQTT 快照实体：开启 MQTT Discovery 后，HA 里自动生成 camera.litenvr_xxx 实体，定时推快照，适合做仪表盘徽标和卡片。
外部 AI 事件接入：Frigate、DeepStack 这类识别服务把人、车结果 POST 给它，它接着走录像、事件检索、Telegram / webhook 通知全套流程。
编码自动适配：ffprobe 先探测，H.265、10-bit 这类浏览器播不了的自动转 H.264，录像保留原编码。
存储有后路：录像可存到外接盘（SMB / Samba / FTP），还支持定时备份到 Google Drive、满了自动清理旧文件。

上手指南：Docker 拉起与 HA 对接三步

ZimaOS 一键装或 docker-compose 起：仓库给了 ZimaOS 专用模板和 compose 文件，拉起后 Web 端口是 3333。首次登录默认账号是 admin / admin，进去第一件事就是改密码、开双因素认证。
接摄像头：支持 ONVIF 自动发现，扫出来填账号就行；手动加就填 RTSP 地址。建议 live 用子码流 H.264，主码流留给录像，CPU 和兼容性都稳。
对接 Home Assistant（二选一或都要）：要快照卡片，走 MQTT Discovery（HA 装 Mosquitto broker，LiteNVR 里填 broker 地址和专用账号）；要实时画面，在 HA 里加 Generic Camera 集成，指向它的 HLS 地址。两条链路互不冲突。
必查的三处配置：MQTT 密码用 HA 里建的专用小号，别用 admin；discovery_prefix 和 base_topic 两边保持一致；改 base_topic 后记得去 HA 里删旧实体。

同类对比：LiteNVR、Frigate、群晖套件怎么选

维度	LiteNVR	Frigate	群晖 Surveillance Station
定位	轻量 NVR + HA 联动	AI 侦测为核心的 NVR	NAS 厂商套件
资源占用	极低（码流直存）	高（实时 AI 推理）	中
AI 能力	靠外部事件接入	内置，强	基础
上手	ZimaOS 一键	配置较重	最省心
费用	开源免费	开源免费	授权按通道收费

明确取舍：LiteNVR 的轻是有明确代价的——CPU 不到 1% 的前提是码流直存、一律 H.264；摄像头一旦是 H.265，转码的 CPU 开销立刻回来。所以 README 反复强调 live 用子码流 H.264，这不是建议，是轻量架构成立的前提。要内置强 AI 侦测，选 Frigate；要省心且愿意付授权费，用群晖套件；要的是 NAS 上挂一个不吃资源的录像机，顺手跟 HA 联动，LiteNVR 最合适。

常见问题与注意事项

MQTT 实体是快照，不是实时视频：HA 里自动生成的 camera 实体推的是定时快照，做徽标够用，想看实时画面必须另配 Generic Camera 走 HLS。
H.265 摄像头先看 CPU：浏览器播不了 H.265，它会自动转码，但转码吃 CPU。弱性能 NAS 务必用子码流 H.264 做 live，主码流 H.265 只录像。
海康 / 萤石摄像头可能罢工：这类摄像头限制 RTSP 并发连接数（约 3 路），连接太频繁会被临时锁定，表现为 500 / 503 报错。解法是只让一个应用直连摄像头，其他走它的 restream。
项目非常新：仓库 2026 年 10 月 17 日才创建，star 只有个位数，长期维护、升级迁移、大规模部署能力都未经验证，先跑测试环境。
AI 事件接口有门槛：snapshot_url 只收 http / https、上限 8MB，调不通先查这条；接口权限和 live 共用，注意别把有录像权限的账号到处分发。

LiteNVR 适合谁：一句话选型

适合：用 ZimaOS 或其他 NAS 跑 Docker、家里有几个摄像头、已经在用 Home Assistant，想找个不吃资源的 NVR 做录像加联动的人。
不适合：要内置强 AI 侦测（看 Frigate）、要厂商级省心和售后（群晖套件）、摄像头全是 H.265 且 NAS 性能弱又不愿折腾子码流的。

一句话：NAS 上要轻，HA 里要联动——选 LiteNVR；要智能，另请高明。