record
NGINX RTMP 模块中的 `record` 指令用于将直播流录制下来以便存储或稍后回放。
NGINX RTMP module
语法record all | want | off;
默认值off
上下文
参数1+
说明
record 指令属于 NGINX RTMP 模块的一部分,用于在 application 块中控制流的录制行为。它接受一个或多个参数,用于定义流应如何以及何时被录制。该指令最常见的取值包括 all、want 和 off 等选项。all 表示录制所有已发布的流,而 want 则仅在明确请求时才录制。录制文件可以以多种格式保存并存放在指定路径,从而便于之后检索或回放。
与用于指定录制文件存放目录的 record_path 指令配合使用时,record 能无缝集成到流媒体工作流程中。它还可以通过 record_unique 等选项进行配置,record_unique 会在录制文件名后追加唯一标识(例如时间戳),以确保多个录制不会互相覆盖。在需要为不同事件或会话保留唯一录制文件的直播场景中,这一点尤其有用。正确使用时,它可以增强流媒体服务的内容管理和归档能力。
配置示例
application live {
live on;
record all;
record_path /tmp/recordings;
record_unique on;
}⚠
确保 record_path 目录存在,并具有允许 NGINX 写入文件的正确权限。
⚠
错误地配置 record 指令可能导致录制文件被意外覆盖,尤其是在发布多个流且未使用 record_unique 的情况下。
⚠
在长时间录制多个流时,请注意磁盘空间使用情况,因为这会很快耗尽存储空间。