keepalive_disable指令用于针对特定User-Agent禁用HTTP长连接,仅支持msie6/msie7/msie8/msie9/gecko/konqueror/safari等预设关键词,须配置在http或server块中,影响Nginx与客户端连接。

在 Nginx 中,keepalive_disable 指令用于**针对特定用户代理(User-Agent)禁用 HTTP 长连接(Keep-Alive)**,避免某些老旧或存在兼容性问题的浏览器复用 TCP 连接,从而规避连接异常、响应错乱等问题。
作用范围与生效位置
该指令只能出现在 http 块或 server 块中,不能在 location 块内使用。它影响的是 Nginx 与客户端之间的连接行为,而非 Nginx 到上游服务器的连接。
- 若写在
http块,则对所有匹配的 User-Agent 全局生效 - 若写在
server块,则仅对该虚拟主机生效
支持的浏览器标识关键词
keepalive_disable 不接受正则或自定义字符串,只识别以下预设关键字(不区分大小写):
- msie6:IE6 及更早版本(已基本淘汰,但旧系统可能仍需考虑)
- msie7:IE7
- msie8:IE8
- msie9:IE9
- gecko:基于 Gecko 引擎的浏览器(如 Firefox 早期版本)
- konqueror:Konqueror 浏览器
- safari:Safari(注意:仅影响较老版本,现代 Safari 默认兼容良好)
例如:keepalive_disable msie6 msie7; 表示对 IE6 和 IE7 禁用长连接。
实际配置示例
在 http 块中添加:
keepalive_disable msie6 msie7 gecko;
# 其他配置...
}
这样配置后,当 Nginx 检测到请求头中的 User-Agent 包含对应标识(如 Mozilla/5.0 (Windows; U; MSIE 7.0; ...)),就会在响应头中省略 Connection: keep-alive,并主动关闭连接。
注意事项与替代思路
- 该指令依赖 User-Agent 字符串匹配,无法覆盖所有变体,且现代浏览器 UA 可能伪装或省略关键字段
- 禁用 Keep-Alive 会增加 TCP 握手和 TLS 协商开销,降低性能,应仅在确认存在兼容问题时启用
- 更推荐的做法是升级客户端或服务端协议栈;若必须兼容旧环境,可结合
keepalive_timeout缩短超时时间,而非完全禁用 - Nginx 1.1.19+ 版本才完整支持
gecko和safari关键词,低版本请确认文档兼容性


















