exec_options

NGINX RTMP 模块中的 exec_options 指令指定用于直播和录制事件的执行选项。

语法exec_options command;
默认值none
上下文
参数1

说明

exec_options 指令允许在 RTMP 应用设置中针对特定流操作发生时配置执行行为。例如,该指令使用户能够在响应某些事件时定义 shell 命令的执行,例如开始或停止流会话。此功能便于与外部进程集成,使开发人员能够根据实时事件自动调用脚本或应用程序,从而实现更动态的流媒体解决方案。

在使用时,exec_options 指令通常接受一个参数,用于指定要执行的命令。例如,这可以包括指向 shell 脚本的路径或在特定 RTMP 事件发生时执行的特定命令行指令。该命令可以包含与流会话相关的变量,这些变量可以传递给被执行的程序,以提供有关流状态或元数据的上下文。

exec_options 指令的正常运行还需要仔细的错误处理,因为被执行命令中的问题可能影响流媒体服务器的稳定性。用户应彻底验证其命令,并确保它们能够在不导致整个 RTMP 服务器运行失败的情况下执行。这种基于上下文的执行能力可以大大增强服务器的灵活性和性能,是参与媒体流应用的开发人员和系统管理员的重要功能。

配置示例

application live {
    live on;
    exec_options /path/to/script.sh;
}

确保该命令可执行并设置了正确的权限。

指定的路径应为绝对路径,以避免执行错误。

在将其集成到 NGINX 之前,单独测试脚本以确认其行为符合预期。

← 返回所有指令