Moonfire NVR 安装与配置完全指南

Moonfire NVR 安装与配置完全指南

Moonfire NVR 是一款开源的网络视频录像机软件，专为 IP 摄像头监控系统设计。本文将详细介绍如何在不同架构的 Linux 系统上安装和配置 Moonfire NVR，包括硬件准备、系统配置和优化建议。

系统要求与准备

Moonfire NVR 支持 x86-64、arm64 和 arm 架构，推荐使用 Linux 操作系统。在开始安装前，请确保您的系统满足以下基本要求：

1. 至少 1GB 可用内存
2. 快速存储设备（如 SSD）用于数据库存储
3. 大容量硬盘用于视频样本存储
4. 稳定的网络连接

安装 Moonfire NVR

Moonfire NVR 提供了预编译的二进制文件，安装过程简单直接。以下是安装步骤：

1. 确定系统架构：

   ARCH=$(uname -m)
   

2. 下载并安装最新版本（以 v0.7.21 为例）：

   VERSION=v0.7.21
   curl -OL "下载地址/moonfire-nvr-$VERSION-$ARCH"
   sudo install -m 755 "moonfire-nvr-$VERSION-$ARCH" /usr/local/bin/moonfire-nvr
   

系统配置

创建专用用户

为安全考虑，建议为 Moonfire NVR 创建专用用户：

sudo useradd --user-group --create-home --home /var/lib/moonfire-nvr moonfire-nvr

配置文件设置

创建配置文件 /etc/moonfire-nvr.toml，内容如下：

[[binds]]
ipv4 = "0.0.0.0:8080"
allowUnauthenticatedPermissions = { viewVideo = true }

[[binds]]
unix = "/var/lib/moonfire-nvr/sock"
ownUidIsPrivileged = true

初始化数据库

初始化 Moonfire NVR 数据库：

sudo -u moonfire-nvr moonfire-nvr init

专用硬盘配置

对于视频存储，建议使用专用硬盘以获得最佳性能：

1. 创建文件系统（推荐 ext4）：

   sudo mkfs.ext4 -T largefile -m 1 /dev/您的设备
   

2. 设置挂载点：

   sudo mkdir -p /media/nvr
   sudo chown moonfire-nvr:moonfire-nvr /media/nvr
   

3. 在 /etc/fstab 中添加挂载配置：

   UUID=您的设备UUID /media/nvr ext4 nofail,noatime,lazytime,data=writeback,journal_async_commit 0 2
   

4. 创建样本文件目录：

   sudo install -d -o moonfire-nvr -g moonfire-nvr -m 700 /media/nvr/sample
   

通过 UI 完成配置

运行配置工具进行最终设置：

sudo -u moonfire-nvr moonfire-nvr config 2>debug-log

在配置界面中，您需要：

1. 添加样本文件目录（如 /media/nvr/sample）
2. 添加摄像头并配置 RTSP 流
3. 为每个摄像头分配存储空间（保留约 1GiB 的缓冲空间）
4. 创建管理员用户

系统服务配置

创建 systemd 服务文件 /etc/systemd/system/moonfire-nvr.service：

[Unit]
Description=Moonfire NVR
After=network-online.target

[Service]
ExecStart=/usr/local/bin/moonfire-nvr run
Environment=MOONFIRE_FORMAT=systemd
Environment=MOONFIRE_LOG=info
Environment=RUST_BACKTRACE=1
Type=notify
TimeoutStartSec=300
User=moonfire-nvr
Restart=on-failure
CPUAccounting=true
MemoryAccounting=true
BlockIOAccounting=true

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable --now moonfire-nvr

常见管理命令

• 查看服务状态：sudo systemctl status moonfire-nvr
• 查看日志：sudo journalctl --unit=moonfire-nvr --since='-5 min' --follow
• 重启服务：sudo systemctl restart moonfire-nvr
• 停止服务：sudo systemctl stop moonfire-nvr

安全注意事项

默认配置下，Moonfire NVR 的 web 界面（端口 8080）是不安全的，建议：

1. 仅在受信任的网络中使用
2. 尽快配置 HTTPS 和身份验证
3. 考虑使用防火墙限制访问

安装完成后，您可以通过 http://localhost:8080/ 访问 web 界面。

性能优化建议

1. 对于多摄像头系统，适当增加 flush_if_sec 值（默认 120 秒）以减少 SSD 写入
2. 确保数据库目录（默认 /var/lib/moonfire-nvr/db）位于快速存储设备上
3. 为每个物理硬盘创建一个单独的样本文件目录
4. 定期检查系统日志和存储空间使用情况

通过以上步骤，您应该已经成功安装并配置了 Moonfire NVR 监控系统。如需更高级的安全配置或故障排除，请参考相关文档。