nchan_eventsource_ping_event
为 NGINX 的 Nchan 模块中的 EventSource 连接设置 ping 事件间隔。
Scalable, flexible pub/sub server for the modern web
·
serverlocationif in location
语法nchan_eventsource_ping_event interval;
默认值none
上下文server, location, if in location
参数1
说明
nchan_eventsource_ping_event 指令用于配置向 EventSource (SSE) 连接的客户端发送 ping 事件的间隔。 这对于维持与客户端的开放连接尤为重要，有助于防止因不活动而导致的超时。 设置该指令允许管理员指定服务器应多久向已连接的 EventSource 客户端发送一次 ping 事件，从而确保客户端能够及时获知连接的状态。
当指定时，nchan_eventsource_ping_event 中设置的值以秒为单位定义这些 ping 消息的频率。如果客户端在设定的时间范围内未发送消息，或服务器未收到通信，则连接可能被视为过期并关闭，因此对于依赖实时数据传输的应用程序而言，正确配置该指令至关重要。ping 机制对于长时间保持的连接特别有用，可使服务器和客户端的交互更为紧密，并确保双方能够及时检测到断开连接。
要启用 nchan_eventsource_ping_event，可以在 NGINX 配置文件的 server 或 location 上下文中包含该指令。请根据应用的需求适当设置，权衡资源使用与连接稳定性之间的平衡。
配置示例
server {
location /events {
nchan_eventsource_ping_event 30;
nchan_pubsub;
}
}⚠
将 ping 间隔设置得过短可能会因为频繁的 ping 消息而给服务器带来不必要的负载。
⚠
如果 ping 间隔过长，客户端可能会因为中间代理或防火墙的超时而断开连接。