record_path
在使用 NGINX RTMP 模块时,'record_path' 指令指定保存录制流的目录路径。
NGINX RTMP module
语法record_path path;
默认值none
上下文
参数1
说明
'record_path' 指令在 NGINX RTMP 模块中用于定义录制期间存储视频流的特定目录。它对利用直播功能的应用至关重要,因为它允许对已录制内容进行管理。当流被发布时,该流的所有数据会被捕获并写入指定路径。该路径必须可被 NGINX 用户访问,并应具有允许写入文件的适当权限。
在配置 'record_path' 时,请确保提供有效的目录位置。该路径可以是绝对路径,也可以是相对于 NGINX 工作目录的相对路径。如果指定的目录不存在或存在权限问题,则不会创建录制,可能导致服务中断或数据丢失。还应管理磁盘空间,因为录制流的大小可能会根据流持续时间和比特率快速增长。
除了指定存储路径外,用户还可以将 'record_path' 与其他指令结合使用,以更好地控制录制过程,例如 'record_max_size'(限制录制文件的大小)或 'record_unique'(可根据时间戳确保录制流具有唯一的文件名)。这有助于有效地组织录制内容并避免文件被覆盖。
配置示例
rtmp {
server {
listen 1935;
application live {
live on;
record all;
record_path /var/rtmp/recordings;
record_max_size 1G;
record_unique on;
}
}
}⚠
确保指定路径对 NGINX 用户可写,以防出现权限被拒绝的错误。
⚠
如果使用相对路径,请核实它相对于 NGINX 工作目录是否已正确解析。
⚠
如果不监控磁盘空间,记录的文件可能会占满磁盘,导致 NGINX 崩溃或变得无响应。