push_stream_ping_message_interval
设置发送 ping 消息的间隔,以维持打开的 WebSocket 连接。
NGINX push stream module
·
httpserverlocation
语法push_stream_ping_message_interval interval;
默认值none
上下文http, server, location
参数1
说明
The push_stream_ping_message_interval 指令指定在 WebSocket 连接中向订阅者发送 ping 消息的时间间隔,以确保连接保持活动状态。这在空闲期间保持连接存活并检测断开的连接时尤其重要。默认情况下,该值未设置,这意味着不会发送 ping 消息,除非显式定义。
配置此指令时,应考虑网络状况和通道上的预期活动水平。较短的间隔可以更快地检测到断开的连接,但可能产生额外的网络开销。另一方面,较长的间隔会降低 ping 消息的发送频率,但可能导致无响应的客户端在更长时间内保持连接。在配置时找到适合特定用例和系统负载的平衡,对于保持性能和可靠性至关重要。
配置示例
http {
push_stream_ping_message_interval 1m;
}⚠
此指令必须设置为有效的时间间隔;无效的值会导致配置错误。
⚠
注意不要将间隔设置得过短,因为这可能导致网络流量过大,尤其是在大量客户端的情况下。