push_stream_ping_message_text
为 NGINX push stream 模块中发送给客户端的 ping 消息设置自定义文本。
NGINX push stream module
·
http
语法push_stream_ping_message_text text;
默认值none
上下文http
参数1
说明
push_stream_ping_message_text 指令指定要作为 ping 消息发送给 push stream 模块中已连接订阅者的自定义文本。这对于维持连接并让客户端应用程序知悉服务器仍可达且运行正常特别有用。
ping 消息按固定间隔发送以验证连接状态并防止因长时间不活动而导致的超时问题和连接丢失。默认情况下，该消息可以是一个简单字符串，实际的 ping 发送频率由另一个用于配置时间的指令控制。
在配置中使用此指令可以更灵活地定制服务器与客户端的通信方式，从而通过提供定期更新或心跳来提升用户体验。务必确保消息不会超过其他相关配置设置施加的大小限制，以避免潜在的传输错误。
配置示例
http {
push_stream_ping_message_text "Heartbeat";
push_stream_shared_memory_size 32M;
server {
location /pub {
push_stream_publisher admin;
push_stream_channels_path $arg_id;
}
location ~ /sub/(.*) {
push_stream_subscriber;
push_stream_channels_path $1;
}
}
}⚠
确保 ping 消息文本不超过 255 bytes，以防止客户端连接问题。
⚠
过度使用 ping 消息会导致网络流量增加；需要保持平衡。