如何设置 `keepalive_requests`-Nginx-PHP中文网

keepalive_requests用于限制单个长连接最多处理的请求数，达上限后Nginx主动关闭连接；默认值100，需配合keepalive_timeout使用，二者任一触发即断连，配置于http/server/location块，设为0不推荐。

如何设置 `keepalive_requests`

在 Nginx 中，keepalive_requests 用于控制一个长连接（keep-alive connection）最多能处理多少个请求后就关闭。它不是设置“是否启用长连接”，而是限制单个连接的请求上限，防止连接长期占用资源或积累状态问题。

作用与默认值

该指令必须放在 http、server 或 location 块中，且仅对启用了 keep-alive 的连接生效（即客户端发送了 Connection: keep-alive，且服务端也返回了相同头）。默认值是 100，意味着一个 TCP 连接最多服务 100 个请求，之后 Nginx 主动关闭连接。

如何配置

直接在对应作用域内添加配置即可，例如：

http {
    keepalive_requests 1000;
<pre class="brush:php;toolbar:false;">server {
    listen 80;
    location /api/ {
        keepalive_requests 500;  # 覆盖 http 级别设置
    }
}

}

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

数值设为 0 表示不限制请求数（不推荐，可能引发连接堆积）
建议根据业务特点调整：静态资源可设高些（如 1000），高频短请求接口可适当降低（如 200–500）
需配合 keepalive_timeout 使用——前者管“请求数”，后者管“空闲时间”，两者共同决定连接生命周期

常见搭配与注意事项

单独调高 keepalive_requests 并不能提升并发性能，还需注意：

客户端是否真正复用连接（浏览器通常支持，但某些 SDK 或旧客户端可能不发 keep-alive 头）
上游代理（如负载均衡器）是否透传 Connection 头，否则 Nginx 收不到 keep-alive 请求
如果使用 HTTP/2，keepalive_requests 不生效（HTTP/2 原生多路复用，无需传统 keep-alive 控制）
修改后需重载配置：nginx -s reload，无需重启进程

怎么验证是否生效

可通过响应头和日志辅助判断：

查看响应是否有 Connection: keep-alive，并检查 Keep-Alive: timeout=XX, max=YY（其中 max 即为 keepalive_requests 设置值）
开启 log_format 记录 $connection_requests 变量，观察单连接处理请求数是否接近设定阈值
用 curl -v http://example.com 观察连接复用行为，或用 ab / wrk 做压测对比