功能总览
适用于 MiBeeNvr v0.13.0（2026-09 发布）
一页看全 MiBee NVR 的全部能力。每一节都附上对应的专题文档链接——本文是地图，细节请进对应的"景点"。
摄像头接入
| 接入方式 | 适用设备 | 亮点 |
|---|---|---|
| RTSP | 海康、大华、宇视等主流 IP 摄像头 | H.264 / H.265 / MJPEG，子码流，自动重连 |
| ONVIF | 支持 ONVIF 协议的摄像头 | 自动发现 + 自动编码检测 + PTZ 云台控制 + 相机侧移动侦测 |
| 小米摄像头 | C200 / C300 / 双镜头等 | 免云订阅本地录像，CS2 + 7 款 TUTK 老型号 |
| GB/T 28181 | 国标 SIP 设备/平台（实验性） | 注册、目录、PTZ、对讲、报警订阅、下级级联 |
| SRT / RTMP 推流接入 | 异地/跨网络摄像头 | 摄像头主动推流到 NVR，无需 NVR 反向连接 |
| WebRTC (WHIP) | 浏览器 / 手机 / OBS | 一条 URL 即可把任意设备变成监控源（H.264 + Opus） |
| HTTP JPEG / MJPEG | ESP32 等低功耗自制摄像头 | 快照流与 MJPEG 流，搭配 MiBeeCam 固件 |
| 树莓派摄像头 | USB / CSI 摄像头 | 通过 RTSP 服务（rpi-cam）接入 |
零配置发现：ONVIF WS-Discovery 自动扫描 + mDNS/DNS-SD 局域网服务通告 + UDP 广播应答——同一网络内打开网页就能看到 NVR 和摄像头。
直播观看
| 协议 | 延迟 | 适用场景 |
|---|---|---|
| WebRTC (WHEP) | 亚秒级 | 手机 / 平板实时看家，G.711 与 Opus 音频零转码直入 |
| WebSocket | ~0.5s | 通用低延迟，WASM 解码管线 |
| HTTP-FLV | 1–3s | 浏览器友好，长观看 |
| HLS / LL-HLS | 2–5s | 兼容性优先，iOS 原生支持 |
| WASM 播放器 | ~1s | 纯 HTTP 播放 H.265，无需 HTTPS 与专用客户端 |
| RTSP 输出 | 实时 | 第三方平台（群晖 Surveillance Station 等）直接取流，每机一址 rtsp://<NVR-IP>:8554/<camera_id>；v0.13 起支持 MJPEG/JPEG 相机（RTP-JPEG） |
- H.265 全链路：直播（WASM 软解 / WebCodecs 硬解自动择优）、录制、回放、延时摄影全面支持 H.265
- 子码流按需：宫格「流畅」模式走低分辨率子码流，无观看者自动停拉零成本；ONVIF 子流自动发现，取不到自动回退主码流
- 前端按设备能力自动选择最优协议（WebCodecs → WebGPU → WASM 逐级回退），无需手动配置
- MJPEG / JPEG 摄像头有专属播放器（最新帧轮询 + ETag 304 省流）
录制与回放
- MP4 分段录制：IDR 对齐起段（不黑屏）、音频同步混入（AAC / G.711 / Opus）、原子写入防崩溃损坏
- 自适应录制：画面安静时自动降为延时摄影级稀疏写入，检测到活动 / 异常声音 / 外部触发立即恢复全帧率——静态场景磁盘占用直降 75%–98%，事件第一帧不丢；v0.13 新增分层录制 + 像素域门控——智能编码器相机（静态 ~0.5fps / 5MP VBR）以子码流 24/7 连续录制为基线、主码流按需补全，配合约 1fps 采样的经典 CV 细门控，不依赖相机侧配合
- 音频触发录像：异常声音（玻璃破碎 / 呼喊）即触发全速录制并回填预触发音频（G.711 相机）
- 即时截图：H.264 / H.265 最新帧截图（可选 FFmpeg 加速），可由 MQTT / webhook 触发
- 连续回放时间轴：双缓冲无缝换段（无黑屏闪烁）+ 全天 VOD 时间轴——跨录像、跨空隙一拖到底
- 滚动合并：录像片段按策略自动合并为大文件，流式处理（1MB 缓冲），不吃内存
- 保留策略：按摄像头设置保留天数 + 磁盘水位自动清理，AI 标记的录像受保护不被清理；可按活动清理——磁盘吃紧时优先删安静片段，把空间留给有事件的录像
- 活动检索：每段录像带压缩域活动分与标签，录像库按「有活动 / 安静 / 场景切换」过滤、按最低活动分筛选，回放时间轴可切活动热力着色（绿=安静 → 红=活跃）
- AVI 帧浏览：旧容器录像可逐帧拖动查看
- 延时摄影 v3：双模——独立延时模式或从录像抽帧（v0.13 起 MJPEG 相机双模可用）；自然日 / 1h / 8h / 24h / 7d / 30d 窗口自动合并，合并历史入库可检索、可回放，
timelapse-mergeCLI 批量转换（见延时摄影） - 全局录像默认开关：
recording.default_enabled一键关闭全部录像——纯直播部署零写盘
GB/T 28181 国标接入（实验性）
SIP 摄像头/平台直接 REGISTER 到 NVR，以普通摄像头形式出现在界面里：
- 设备注册 + Digest 鉴权、目录查询、通道自动入册
- PTZ 方向/变倍/预置位、语音对讲、校时
- 报警 / 目录 / 移动位置订阅推送，报警联动
- 设备侧录像检索（RecordInfo）+ 回放取流（倍速/拖动）
- 下级级联：NVR 作为下级平台注册到上级，转发目录/报警，上级可点播 NVR 本地录像（v0.13 起点播时按需激活主码流，空闲不上拉）；可按相机收敛上报目录、可选上报子码流（上行带宽减负）
- GB35114 试点：A 级安全注册（SM2 证书，需
-tags gb35114构建）——国标视频安全链路尝鲜
默认关闭，不开启无任何影响。详见 GB/T 28181 指南。
智能功能
- 浏览器端 AI 检测：ONNX Runtime Web（WebGPU → WASM SIMD 回退），YOLO11 模型在浏览器推理——服务器零负载，老旧 NVR 主机也能跑
- ROI 区域：划出入口/通道等关键区域，只对区域内目标报警；置信度、跳帧率、类别过滤全可调（见 AI 调参指南）
- MiBeeVision 集成：可接入外部 AI 后端（v0.13 起支持多实例路由
vision.instances+ 推送熔断自动退避），NVR 主动推送录像段、掉线自动补偿重推；AI 事件快照端点 - 相机侧移动侦测：ONVIF MotionAlarm 事件直接作为录像触发源（
motion_source: camera:onvif，见 ONVIF 指南）——侦测算力下放给相机，NVR 零解码开销 - 健康监控：多层级摄像头健康检测、自动补救、掉线黑名单、IP 漂移自愈（按 ONVIF 序列号重新发现）
- SSE 实时事件：摄像头状态、健康事件、录像段完成全部实时推送
推流与分发
- 直播转推：把任意摄像头直播流转推到 B 站 / YouTube / 斗鱼 / SRS 等 RTMP / RTSP 目标——原生 Go 实现，FFmpeg 仅作兼容兜底
- 推流接入：SRT / RTMP / WebRTC WHIP 三种入流方式，异地摄像头跨网络回传
- 协议转出：同一帧总线同时供给录制 / 直播 / 转推，互不干扰
音频系统
- 录制：AAC / G.711（μ-law、A-law）/ Opus 全部落入 MP4 音轨
- 直播试听：G.711 与 Opus 实时解码播放，AAC 走 WebCodecs
- 双向对讲：按住说话对摄像头喊话（小米 CS2 机型）
存储与集成
- SQLite（WAL 模式）：单文件数据库存全部元数据，为 SD 卡调优（NORMAL 同步 + 忙等待），零外部数据库依赖
- 按相机存储与热迁移：运行时切换存储根 / 为单路相机指定专属盘，历史录像后台限速迁移（可配时间窗），全程无需重启；数据库与录像根解耦，换盘不丢索引
- 对象存储冷备：合并完成的录像异步上传 S3 兼容对象存储（R2 / B2 / MinIO / OSS / COS 等），远端校验通过后可安全逐出本地副本——本地录像行为不变，默认关闭
- WebDAV 服务器：浏览器直接访问录像库（可配置只读/读写）
- FTP 服务器：远程上传 + 支持摄像头自动注册（摄像头填 FTP 地址即完成接入）
- MQTT 集成：事件总线转发（
mqtt.status_events）+ 触发式 / 定时强制录像 + 快照触发（家庭自动化联动） - Webhook 触发：HMAC-SHA256 签名触发端点（Stripe 风格签名 + 双向防重放），供外部系统拉起录像 / 快照
- Home Assistant 集成：官方定制集成随包发布（mDNS 自动发现 + 按相机生成实体 / 开关）；也可用内置 RTSP 输出 + MQTT 纯原生拼装
- Prometheus 指标：300+ 指标族，
/api/metrics抓取 - REST API：全部功能可编程，支持 API Key（
mbv_前缀）与 BasicAuth 双认证
部署与分发
| 方式 | 说明 |
|---|---|
| 一键脚本 | curl … install.sh | sudo bash——装二进制、建系统用户、配 systemd、启动 |
| 预编译二进制 | amd64 / arm64 / armv7 三架构，GitHub Releases 下载 |
| 桌面版 | Windows / macOS 单文件安装器（桌面版指南）：托盘 / 菜单栏助手、本机免密，与服务器版功能一致 |
| 裸机自动更新 | release 产物 ed25519 签名校验 + 健康门失败自动回滚，Web 一键升级与升级历史（update.auto_apply 默认关闭） |
| Docker | ghcr.io/mi-bee-studio/mibeenvr + 阿里云镜像（国内拉取提速），多架构 manifest |
| NAS 商店 | 飞牛 fnOS（离线 + 在线双包）、群晖、威联通、极空间、unRAID、iStoreOS、zSpace |
| systemd / 裸跑 | 单二进制 + 一个 YAML 配置文件即是全部 |
Web 界面
- 现代化 Svelte 5 SPA，中文 / English 双语，明暗双主题，PWA 可安装
- 初始化向导（首次 3 分钟配完）、监控大屏（页头「流畅 / 高清」子码流切换）、录像库（活动筛选 + 热力时间轴）、延时摄影、仪表盘、健康页、统计页
- 相机分组：卡片拖拽分组 / 排序 / 重命名，宫格选机面板按分组过滤、整组一键选入
- 仪表盘四子页：存储趋势（每相机存储占用 + 每日写入堆叠图，图例即相机选择器）、健康历史、转码历史、AI 事件（配置外部 AI 后端后显示）
- 摄像头状态链路诊断：仪表盘逐相机展开链路树（采集源 → 分发中枢 → 录像落盘 / 直播观看 / 健康检测 / 转发 / 子码流），状态一目了然——绿色 = 活跃、灰色 = 空闲、橙色 = 异常（如标记录制但无帧流入）、红色 = 严重丢帧；附健康评分扣分因素（中文人话解释）与该相机存储占用
- 全功能响应式，手机浏览器体验完整（无阉割）
版本演进
性能与可靠性
- I/O 预算调度：后台任务（合并 / 清理 / 修复 / 延时 / 转码 / 冷备上传）共享令牌桶让路前台，不再平权争抢磁盘；录像写 / 回放读计费的灰度开关默认关闭
- 录像写卡顿根除：MP4 段增量落盘消除 Close 突发写、每段独立写锁、NALU 缓冲池化（见性能调优）
- 内存自适应：按物理内存 / cgroup 配额自动设置 GOMEMLIMIT（min(45% 物理内存, 1GiB) 或 cgroup 的 80%），小内存板不再 OOM
- 运维保险：
validate-configCLI 预检配置、深层孤儿目录扫描、启动配置防呆（last-good 备份恢复 + 崩溃循环保险丝）
资源基准与约束
设计基准是低端 ARM 设备（1GB 内存、Cortex-A53 级），并以此保守取值：
| 项目 | 基准 |
|---|---|
| 进程内存上限 | 512MB |
| 并发 HLS 流 | ≤ 4 路 |
| 录像分段时长 | ≤ 30s |
| 运行依赖 | 无（FFmpeg 可选，仅 H.265↔H.264 转码需要） |
| 数据库 | SQLite 单文件（WAL） |