简介Moonfire NVR 是一款开源的安全摄像机网络视频录像机面向需要自建 IP 摄像机录像方案、又希望控制硬件成本的开发者与运维人员。它把来自摄像机的 H.264-over-RTSP 流直接落盘视频帧以旋转目录形式存放其余元数据写入 SQLite3 数据库并可动态拼装任意时间段的 .mp4 文件由于不解码、不分析、不重编码CPU 占用极低可在普通机器上同时处理多路 1080p/30fps 流。资源包共 116 个文件约 5.22MB以 Rust 源码48 个 .rs为核心辅以 24 个 JavaScript 前端脚本、11 个 Markdown 文档、5 个 SQL 建表脚本以及 TOML 配置、Dockerfile 与容器编排文件便于直接构建与部署。目前已有 1420 人学习下载。借助完整源码与数据库结构读者可理解低开销录像管线的设计思路并在此基础上做二次开发或排错参考。1. 装 Moonfire NVR 之前先把 Rust 工具链和 FFmpeg 版本对齐第一次在一台旧工控机上装 Moonfire NVR我图省事用了系统自带的 Rust 1.65cargo build --release跑到一半直接报edition2021相关错误回头查才发现项目已经要求更新的工具链。这类 NVR 项目不像普通 Node 服务装错了不会给你友好提示而是编译阶段就翻车。Moonfire NVR 是一套用 Rust 写的网络视频录像机负责从 RTSP 摄像头拉流、切片存盘、再通过内置 HTTP 服务回放适合想把几路 IP 摄像头统一管起来、又不想依赖厂商云平台的开发者。它把录像落成标准格式的片段文件元数据进 SQLite装好之后浏览器就能看回放。这篇笔记按「环境清单 → 编译安装 → 配置摄像头 → 排错 → 验证」走一遍新手能照抄熟手能看清版本取舍。2. 环境准备Rust 版本、FFmpeg 依赖和磁盘布局2.1 先定版本别用发行版自带的 RustMoonfire NVR 的编译对 Rust 版本有硬要求常见做法是用 rustup 装稳定版而不是发行版仓库里的旧包。我一般固定一个较新的 stable比如 1.75 以上避免 edition 和依赖解析的兼容问题。装之前先确认系统架构和 glibc 版本老 CentOS 7 这类 glibc 2.17 的机器在链接阶段容易出问题能换 Debian 12 或 Ubuntu 22.04 就换。# 安装 rustup 并固定 stable 工具链 curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y source $HOME/.cargo/env rustup default stable rustc --version # 确认输出 1.75 以上 cargo --version这段先装 rustup 再切 stable-y表示非交互安装适合脚本化。source那行是把 cargo 加进当前 shell 的 PATH不执行的话后面cargo会提示找不到命令。rustc --version是自检版本低于项目要求就别急着往下走先rustup update stable。2.2 FFmpeg 和系统库编译期和运行期都要Moonfire NVR 依赖 FFmpeg 做转码和封装编译时需要开发头文件运行时需要动态库。Debian/Ubuntu 系一条命令能装齐注意装的是-dev包而不是只装运行时。# Debian/Ubuntu编译依赖 运行时库 sudo apt update sudo apt install -y build-essential pkg-config libssl-dev \ libavcodec-dev libavformat-dev libavutil-dev libavfilter-dev \ libavdevice-dev libswscale-dev libswresample-dev ffmpeg sqlite3build-essential提供 gcc 和 makepkg-config让 cargo 能找到 FFmpeg 的.pc文件libssl-dev是 HTTPS 相关依赖。后面一串libav*-dev是 FFmpeg 各模块的开发包少装一个编译时就会报Package xxx was not found。ffmpeg和sqlite3是运行时和排查用的命令行工具建议一起装上。2.3 磁盘和目录录像盘单独挂别和系统盘混NVR 最怕的是录像把系统盘写满导致服务挂掉。我一般单独挂一块盘挂到/var/lib/moonfire-nvr文件系统用 ext4 或 xfs 都行挂载参数里加noatime减少无谓写入。目录规划上数据库和录像片段放同一个根目录下Moonfire NVR 会自己建子目录。# 假设新盘是 /dev/sdb格式化和挂载 sudo mkfs.ext4 /dev/sdb sudo mkdir -p /var/lib/moonfire-nvr sudo mount -o noatime /dev/sdb /var/lib/moonfire-nvr # 写入 fstab 保证重启后自动挂载 echo /dev/sdb /var/lib/moonfire-nvr ext4 defaults,noatime 0 2 | sudo tee -a /etc/fstabnoatime的作用是读文件时不更新访问时间对大量小片段文件的录像场景能明显减少元数据写入。写 fstab 时用设备名还是 UUID 看习惯生产环境我更倾向 UUID避免盘符漂移。挂载完df -h确认容量再往下走。3. 编译与初始化从源码到能启动的二进制3.1 拉源码并编译 release 版本Moonfire NVR 目前以源码编译为主没有现成的通用二进制包。克隆后进目录编译第一次编译会拉不少 crate时间取决于网络和机器性能十几分钟到半小时都正常。git clone https://github.com/scottlamb/moonfire-nvr.git cd moonfire-nvr # 编译 release 版本产物在 target/release/ cargo build --release--release会开优化编译慢但运行快NVR 这种长期跑的服务必须用 release。编译过程中如果卡在某个 crate 下载多半是网络问题可以配 cargo 镜像源。编译成功后二进制在target/release/moonfire-nvr可以先./target/release/moonfire-nvr --version确认能执行。3.2 初始化数据库和目录结构Moonfire NVR 第一次运行前要初始化它会建 SQLite 数据库和录像目录。用init子命令指定根目录这个目录就是前面挂载的录像盘路径。# 初始化--dir 指向录像根目录 ./target/release/moonfire-nvr init --dir /var/lib/moonfire-nvrinit会创建db和sample等子目录数据库文件在db下。如果提示目录已存在且非空说明之前初始化过别重复执行否则可能覆盖配置。初始化完成后可以用sqlite3 /var/lib/moonfire-nvr/db/db.sqlite3 .tables看看表结构确认数据库正常生成。3.3 配置文件的写法摄像头、时区和端口配置是 Moonfire NVR 落地最关键的一步主配置文件通常叫moonfire-nvr.toml放在录像根目录下。里面要写监听地址、时区、摄像头列表。摄像头用 RTSP URL 描述凭据直接嵌在 URL 里所以文件权限要收紧。# /var/lib/moonfire-nvr/moonfire-nvr.toml [server] # 监听所有网卡的 8080 端口前面一般再挂反向代理 bind_addrs [0.0.0.0:8080] [[cameras]] # 摄像头短名回放 URL 里会用到 short_name front-door # RTSP 地址用户名密码按实际填 url rtsp://user:pass192.168.1.50:554/stream1 # 录像保留天数 retain_bytes 200000000000bind_addrs决定服务监听在哪只给内网用就写内网 IP。short_name是摄像头标识不能重复。url里的 RTSP 路径各家摄像头不一样常见的是/stream1或/h264填错会一直拉流失败。retain_bytes是保留容量上限按盘大小和路数算别设得比盘还大。配置文件权限建议chmod 600因为里面有摄像头密码。4. 避坑与排查编译、拉流、权限三类高频问题4.1 编译报 FFmpeg 找不到现象是cargo build中途报Package libavcodec was not found in the pkg-config search path。原因是只装了运行时库没装-dev包或者PKG_CONFIG_PATH没指对。解决是先补装对应libav*-dev再用pkg-config --modversion libavcodec确认能查到版本。如果装在非标准路径导出PKG_CONFIG_PATH/usr/local/lib/pkgconfig再编译。4.2 服务起来了但摄像头一直离线现象是 Web 界面里摄像头状态一直是未连接日志里反复出现 RTSP 超时。原因通常是 URL 路径不对、凭据错误或者摄像头只允许特定网段访问。解决是先用ffplay或ffmpeg -i在命令行直接拉这个 RTSP URL能出画面说明 URL 没问题问题在 Moonfire NVR 的配置或网络拉不出来就先修摄像头侧。常见做法是把摄像头和 NVR 放同一网段减少中间设备干扰。4.3 录像目录权限不足导致写盘失败现象是服务能启动、能看实时画面但回放里没有新片段日志报Permission denied。原因是运行服务的用户对录像根目录没有写权限。解决是chown -R把目录给运行用户或者用 systemd 的User指定用户并确保该用户对目录有读写权限。别图省事用 root 跑出问题不好排查。4.4 磁盘写满后服务异常现象是跑一段时间后服务响应变慢甚至退出。原因是保留策略没生效或retain_bytes设得过大录像把盘写满。解决是调小retain_bytes并确认服务有权限删除旧片段。我一般还会加一个磁盘监控使用率超过 85% 就告警给自己留处理时间。5. 装完怎么验证从拉流到回放走一遍闭环装完不能只看进程在不在要验证「拉流 → 切片 → 回放」整条链路。第一步看服务状态和日志确认没有启动错误。# 前台启动观察日志输出 ./target/release/moonfire-nvr run --dir /var/lib/moonfire-nvrrun子命令前台运行日志直接打到终端方便看拉流和切片是否正常。看到类似stream和recording相关的日志说明在正常工作。确认没问题后再交给 systemd 托管写一个 unit 文件ExecStart指向二进制和run --dirRestarton-failure保证异常退出能拉起。第二步用浏览器访问http://服务器IP:8080进摄像头列表看状态是否在线点进回放看有没有新片段生成。第三步直接查磁盘确认片段文件在增长。# 看录像目录下片段文件数量和总大小 find /var/lib/moonfire-nvr -name *.mp4 | wc -l du -sh /var/lib/moonfire-nvrfind统计片段数量du看总占用两个数都在涨说明切片和落盘正常。如果数量不涨回到日志看拉流是否中断。最后一步是模拟回放在 Web 界面选一个时间段播放能正常拖动进度条、画面不花这套环境就算跑通了。我自己的习惯是每次装完都强制走一遍「命令行拉流 → 服务日志 → 浏览器回放 → 磁盘增长」这四步少一步都可能留下隐患。有次偷懒跳过磁盘检查结果保留策略没生效一周后盘满服务挂了从那以后这四步一步不敢省。希望帮到你。本文还有配套的精品资源点击获取
