直播录像

2026年 5月 20日下午3:36

## 注意
适用于v3.17及之前版本，v3.18及之后使用该文档：https://www.nodemedia.cn/doc/web/#/5/132

## 功能描述
用于对推流直播进行录像，保存为mp4文件，以fMP4格式封装，并提供http静态文件访问。
>fMP4格式封装的好处类似于ts文件，不同于传统mp4文件需要在结束时回写头部信息。
>传统mp4文件在录制过程中如果程序异常，则录制的文件无法播放且无法恢复。
>fMP4文件随时都能直接终止
>fMP4文件也提供了HTML5原生播放能力。

## 开启功能
在配置文件config.ini 中, 设置
```
; 截图保存路径
; record_path 录像保存路径, 不设置则不开启录像
record_path     = ./record
; record_rule 录像匹配规则， 默认 */* 全部流录像， live/* live下的流才录像, 多个规则 | 分割
record_rule     = */*
; record_maxtime 最大单个录像时长 m,h,d
record_maxtime  = 1h
```
## web访问录像
如推流地址: rtmp://192.168.0.10/live/stream
则定时截图地址为: http://192.168.0.10:8000/record/live/stream/2020-07-15-10-12-13.mp4

## 文件名规则
录像会自动创建app_name和stream_name层级文件夹，并全部保存在stream_name目录下。
文件名以当前时间的 yyyy-MM-dd-HH-mm-ss.mp4

## 定时循环
当设置record_maxtime后，开启定时器，每隔定时器的时长生成一个新的文件。
当流中途断开并重连后，录像重新生成新文件并开始新的定时器。

## 录像事件通知
当录像开始和结束时，会通过http post 发送事件回调到指定url
### 开始录像事件
```
{
  id: '5hnnyo3qbqdash87wf5hhcpk3ysz6z8e',
  ip: '192.168.0.6:59804',
  app: 'live',
  name: 'bbb',
  query: {},
  action: 'postRecord',
  protocol: 'rtmp',
  createtime: 1594792094602,
  endtime: 0,
  inbytes: 0,
  outbytes: 0,
  filename: '2020-07-15-13-48-14.mp4'
}
```

### 结束录像事件
```
{
  id: '5hnnyo3qbqdash87wf5hhcpk3ysz6z8e',
  ip: '192.168.0.6:59804',
  app: 'live',
  name: 'bbb',
  query: {},
  action: 'doneRecord',
  protocol: 'rtmp',
  createtime: 1594792094602,
  endtime: 1594792115163,
  inbytes: 2535828,
  outbytes: 0,
  filename: '2020-07-15-13-48-14.mp4'
}
```
### 录像API
https://www.nodemedia.cn/doc/web/#/5?page_id=72

## 磁盘管理
nms未提供内置的磁盘管理功能。
linux系统可使用 find /record_path -mtime +30 -delete 并加入cron来定时执行删除31天前旧文件
时间可随磁盘容量与每日存储量来计算
简单存储量计算:
某H265摄像头1080固定1M码率，录制一小时需要的磁盘容量是450MB, 一天需要10GB。
32个摄像头一天需要320G，存储1个月需要9.6TB。
[京东4T监控硬盘](http://t.cn/A6ypWaTe "京东4T监控硬盘")

一小时计算公式： 码率 / 8 x 60 x 60

## find -mtime +n n -n 的意思
n是几个24小时的意思
任何时候执行这个命令，都是从当前时间往前算。
时间被分割为3段
<== +n   <== n ==>  -n ==>现在
如果n是1话
-1 表示从现在起往前数24小时以内的
1  就表从现在往前数24小时到48小时这个范围内的
+1 就表示从现在往前数48小时之外的

## 宝塔系统创建自动删除任务
![](https://www.nodemedia.cn/doc/server/../Public/Uploads/2022-09-26/633107f2935a8.png)