Viseron项目中的NVR录像片段保存问题排查指南

问题背景

在使用Viseron项目搭建NVR监控系统时，用户遇到了无法保存和下载运动检测事件录像片段的问题。系统报错提示"Preparation of download failed: No fragments found for recording"，同时在日志中出现了FFmpeg相关的错误信息。

环境配置分析

用户的环境配置如下：

• 运行在Proxmox上的Ubuntu 22.04虚拟机
• 使用TrueNAS提供的SMB共享存储
• 监控摄像头型号为Reolink RLC-510A
• 通过Docker容器部署Viseron服务

配置细节

Docker配置

容器配置中指定了多个卷挂载点，包括：

• 录像片段存储目录(/segments)
• 快照存储目录(/snapshots)
• 缩略图目录(/thumbnails)
• 事件剪辑目录(/event_clips)

Viseron配置

主要配置了三个部分：

1. FFmpeg摄像头配置：设置了主码流和子码流的访问路径
2. MOG2运动检测：配置了检测帧率和触发事件录像
3. NVR功能：启用了基础录像功能

错误现象

系统表现出以下异常行为：

1. 无法下载运动检测触发的录像片段
2. 存储共享中找不到预期录像文件
3. 日志中出现关键错误：
   • "Could not find init.mp4 file for camera"
   • "pipe:: Invalid data found when processing input"
   • FFmpeg命令返回非零状态

问题根源

经过深入分析，问题的根本原因是NFS共享存储的权限设置不当。具体表现为：

1. Docker容器对挂载的共享存储没有写入权限
2. 文件系统权限阻止了FFmpeg创建必要的视频片段文件
3. 由于无法写入初始片段(init.mp4)，导致后续的HLS流媒体功能失效

解决方案

解决此问题需要确保以下几点：

1. 正确配置共享存储权限：

   • 确保Docker容器用户对挂载目录有读写权限
   • 检查SMB/NFS共享的导出选项，允许容器用户访问

2. 验证存储挂载：

   • 在容器内手动测试文件创建和写入
   • 检查挂载选项(如uid,gid,权限掩码)

3. 日志级别调整：

   • 临时启用debug级别日志有助于诊断权限问题
   • 监控FFmpeg命令执行时的详细输出

最佳实践建议

1. 存储配置建议：

   • 为Viseron创建专用存储账户
   • 设置明确的目录权限(如775/664)
   • 考虑使用本地存储测试后再迁移到网络存储

2. 监控配置建议：

   • 定期检查录像片段是否正常生成
   • 设置存储空间监控，避免磁盘满导致失败

3. 故障排查流程：

   • 首先验证基础录像功能
   • 然后测试运动检测触发
   • 最后验证片段下载功能

总结

NVR系统的存储配置是确保功能正常的关键因素。通过正确配置共享存储权限，用户可以解决Viseron中遇到的录像片段保存问题。建议用户在部署类似系统时，首先验证存储访问权限，再逐步启用各项功能，以便快速定位和解决问题。