做视频监控项目的人大概都经历过这种痛苦：装一台 NVR 软件，先拉一堆运行时依赖，再配数据库，前端还得单独部署，ARM 板子上交叉编译更是一场灾难。MiBee NVR 的思路很直接——用 Go 把后端、前端、录像逻辑全部塞进一个静态二进制，拷到机器上就能跑。
它到底做了什么
MiBee NVR 是一个纯 Go 实现的网络视频录像机，核心能力覆盖了监控场景的三个刚需：
- 协议接入：RTSP（H.264/H.265/MJPEG）、HTTP JPEG 源、ONVIF 设备发现与管理——市面上主流的 IP 摄像头基本都能接进来。
- 录像与直播：实时流转发和录像存储同时进行，不需要额外转码中间件。
- 存储管理：内置存储生命周期管理，不用再挂一套外部存储调度服务。
最关键的一点：编译产物是单个静态二进制文件，内置 Svelte 编译后的前端管理界面。这意味着你在任何 AMD64 或 ARM64 的 Linux 机器上，只需要一个文件就能启动整套 NVR 服务——没有 Python 环境、没有 Node 运行时、没有 PostgreSQL。
单文件架构怎么做到的
Go 的静态编译能力是基础，但把前端也塞进去才是真正省事的地方。Svelte 构建产出的是纯静态 HTML/JS/CSS，Go 用 embed 包直接把这些文件编译进二进制：
// 前端静态资源在编译时嵌入二进制
import "embed"
//go:embed frontend/dist/*
var frontendFS embed.FS
func setupFrontend(mux *http.ServeMux) {
fs, err := fs.Sub(frontendFS, "frontend/dist")
if err != nil {
log.Fatal(err)
}
mux.Handle("/", http.FileServer(http.FS(fs)))
}
用户访问 http://<host>:<port>/ 直接拿到管理界面，API 路径挂在同一端口下。部署时不需要关心前端怎么 serve，也不需要 Nginx 反代。
五分钟跑起来
下面是一个从下载到运行的完整流程，适合在 Ubuntu 或 Debian 的 ARM64 边缘设备上操作：
# 1. 下载最新 release（以 ARM64 Linux 为例）
# 到 GitHub Releases 页面找到对应架构的二进制
wget https://github.com/mibee-nvr/mibee-nvr/releases/latest/download/mibee-nvr-linux-arm64 -O mibee-nvr
# 2. 赋予执行权限
chmod +x mibee-nvr
# 3. 创建数据目录（录像文件会存这里）
mkdir -p /var/lib/mibee-nvr/recordings
# 4. 启动服务，指定端口和存储路径
./mibee-nvr \
--listen :8080 \
--storage-path /var/lib/mibee-nvr/recordings \
--config ./config.yaml
启动后浏览器打开 http://<设备IP>:8080，就能看到 Svelte 管理界面。接下来添加摄像头源：
# config.yaml — 摄像头源配置示例
cameras:
- name: "大门入口"
protocol: rtsp
url: "rtsp://admin:password123@192.168.1.100:554/stream1"
codec: h265
recording:
enabled: true
schedule: "always" # 也可设为 "motion" 或自定义时间段
retention_days: 7
- name: "停车场"
protocol: onvif
host: "192.168.1.200"
port: 80
username: admin
password: password456
recording:
enabled: true
schedule: "motion"
retention_days: 30
storage:
path: "/var/lib/mibee-nvr/recordings"
max_disk_usage_percent: 90 # 磁盘用量超过 90% 自动清理最旧录像
server:
listen: ":8080"
这个配置文件展示了两种典型接入方式：RTSP 直连和 ONVIF 自动发现。ONVIF 模式下 MiBee NVR 会自动探测设备能力并获取流地址，不需要手动拼 RTSP URL。
Docker 部署也不复杂
如果你在服务器上跑，用 Docker 管理更干净：
# Dockerfile — 单文件镜像，极小体积
FROM scratch
COPY mibee-nvr-linux-amd64 /mibee-nvr
ENTRYPOINT ["/mibee-nvr"]
# docker-compose.yaml
version: "3.8"
services:
mibee-nvr:
build: .
ports:
- "8080:8080"
volumes:
- ./config.yaml:/config.yaml:ro
- nvr-storage:/var/lib/mibee-nvr/recordings
command: >
--listen :8080
--storage-path /var/lib/mibee-nvr/recordings
--config /config.yaml
restart: unless-stopped
volumes:
nvr-storage:
FROM scratch 加单文件二进制，镜像体积通常在 20MB 以内。比起那些需要 Alpine + Node + PostgreSQL 的 NVR 方案，这个差距是数量级的。
边缘场景下的取舍
MiBee NVR 的轻量化不是没有代价。几个需要想清楚的点：
| 优势 | 边界 |
|---|---|
| 单文件部署，运维成本极低 | 不内置转码，非 H.264/H.265 源需要摄像头本身输出可解码流 |
| Go 静态编译，ARM64/AMD64 通用 | 大规模集群场景（几百路以上）需要评估单进程性能上限 |
| 无外部数据库依赖 | 录像元数据存储方案需确认是否满足审计检索需求 |
| 内置前端，零配置开箱 | 前端定制化需求高时需要自行修改 Svelte 源码重新编译 |
适合的场景很明确：中小规模监控部署、边缘网关设备、快速验证原型。如果你的需求是几十路摄像头、一台 ARM 盒子搞定录像和回看，这类方案比传统重型 NVR 省太多事。
上手检查清单
准备试 MiBee NVR 之前，确认这几项：
- 摄像头协议：确认你的设备支持 RTSP 或 ONVIF，拿到正确的流地址和认证信息。
- 磁盘空间：H.265 录像大约 1-2GB/天/路（1080p），按路数和保留天数算好存储需求。
- 网络拓扑：NVR 和摄像头在同一局域网内效果最好；跨公网拉 RTSP 延迟和稳定性要单独测试。
- 架构匹配：边缘设备注意下载 ARM64 版本，服务器用 AMD64。
- 端口开放：确保 8080（或你指定的端口）在内网可访问。
一个二进制文件、一行启动命令、一个 YAML 配置——这就是 MiBee NVR 想交付的体验。对于厌倦了依赖地狱的监控开发者来说，值得花半小时验证一下。