push_reconnect
push_reconnect 指令在 NGINX RTMP 模块中配置直播推流客户端的自动重新连接行为。
NGINX RTMP module
语法push_reconnect time_in_seconds;
默认值none
上下文
参数1
说明
push_reconnect 指令是 NGINX RTMP 模块中的一个配置选项，允许你定义当连接断开时服务器应如何处理来自推流客户端的重新连接。 在直播流媒体时，保持连接稳定至关重要。如果推流客户端因网络问题或服务器停机而断开连接，该指令允许服务器在指定的间隔后尝试自动重新连接，而不是立即终止连接。该功能对直播场景尤其有用，能够确保连接中断不会导致流被中断，从而为观众提供更平滑的观看体验。
参数由一个单一参数组成，指定重连尝试的时间间隔，单位为秒。例如，设置 push_reconnect 5; 会使服务器在尝试与推流客户端重新建立连接之前等待五秒。该指令应在相关的应用上下文中设置才能生效。此外，需要注意的是，如果客户端在定义的时间范围内未恢复，可能会导致流中断，因此需要根据预期的网络可靠性进行适当调整。
配置示例
application live {
live on;
push rtmp://backup_server/live;
push_reconnect 5;
}⚠
确保使用正确的单位（秒）；指定不正确的格式会导致配置错误。
⚠
在网络不稳定的情况下，将重连间隔设置得过短可能会因频繁重连尝试而使服务器过载。
⚠
确保影响流行为的任何依赖指令（例如 push）已与 push_reconnect 一并正确配置。