max_message

`max_message` 指令限制 NGINX RTMP 模块中消息的最大大小。

语法max_message size_in_bytes;
默认值none
上下文
参数1

说明

max_message 指令(位于 NGINX RTMP 模块中)用于在媒体流传输时设置传入消息大小的上限。这对于管理服务器的资源消耗以及防止因过大的消息导致滥用或过载至关重要。当消息超过指定大小时,该消息会被丢弃,并可能记录一条警告。

该指令接受一个表示最大消息大小(以字节为单位)的单个参数。如果未指定,默认行为允许任意大小的消息,这可能在处理大型不受信任输入时导致性能问题或稳定性隐患。在配置 max_message 时,管理员应考虑预期的媒体流类型并相应调整该值,以在性能和必要功能之间取得平衡。

在尤其是发生消息大小突增的直播场景中,正确使用此指令非常重要。因此,使用 max_message 有助于维持更可预测和更稳定的服务器性能。该配置在大量并发用户连接时尤为重要,可确保单个连接不会抢占其他连接的资源。

配置示例

rtmp {
    server {
        application live {
            max_message 1048576;
            live on;
        }
    }
}

max_message 设置得太低可能会导致合法消息被丢弃,影响流式传输体验。

在预期会有较大消息时未配置 max_message 可能会导致不可预测的行为。

← 返回所有指令