keepalive_timeout和keepalive_requests共同控制客户端到Nginx长连接生命周期，前者设空闲超时（如65 60），后者限单连接请求数（默认100），任一条件满足即断连。

直接在 http、server 或 location 块中配置 keepalive_timeout 和 keepalive_requests 两个指令即可。它们共同决定客户端到 Nginx 这一段长连接的生命周期，谁先触发就先断连。

keepalive_timeout：控制空闲等待时长

该指令设置连接空闲多久后关闭，单位为秒，可带一个或两个参数：

• 第一个值：Nginx 主动关闭空闲连接的超时时间（必填）
• 第二个值（可选）：写入响应头 Keep-Alive: timeout=xxx 的建议值，仅影响部分客户端行为

常见用法示例：

• keepalive_timeout 30s; —— 空闲 30 秒即断，响应头也写 30
• keepalive_timeout 65 60; —— 服务端等 65 秒，告诉客户端“建议你 60 秒内发下个请求”

不同场景推荐值：

• 静态资源/CDN 边缘节点：10–30 秒（快速释放）
• 移动端 API 或后台管理页：5–20 秒（适配 App 休眠）
• 常规 Web 站点：30–65 秒（兼容主流浏览器默认策略）
• 内网长轮询（SSE）或稳定服务：60–300 秒（延长复用周期）

keepalive_requests：限制单连接处理请求数

它不看时间，只计数——一条连接从建立起，最多服务多少次 HTTP 请求后必须关闭。默认是 100，现代业务通常偏小。

Nginx Hosting

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

下载

按典型用户会话设起点值：

• React/Vue 单页应用（含首屏资源 + 路由切换 + 轮询）：2000
• 高频轻量 API（如每 2–5 秒心跳）：1000–3000
• 低频后台页面或操作稀疏接口：200–500
• 后端偶发卡顿或需快速隔离异常：100–300

注意：这个值只对 HTTP/1.1 keep-alive 生效；HTTP/2 用 http_v2_max_requests 控制。

必须同步调整的配套项

单独改这两个参数效果有限，以下几项要一并检查：

• keepalive_timeout 应略大于请求平均间隔（例如平均 1 秒一次请求，timeout 可设 15–30 秒），避免过早断连
• 反向代理场景下，upstream 块必须启用 keepalive N，并确保 proxy_http_version 1.1 和 proxy_set_header Connection "" 已配置，否则前端优化白费
• 禁用老旧兼容指令如 keepalive_disable msie6，现代 SDK 或 App 客户端可能被误判
• 开启 reset_timedout_connection on，可主动清理僵死连接，防止长期占内存和文件描述符

怎么验证是否调得合理

不能只看配置写了没，要观察真实行为：

• 用 ss -tnp | grep :443 | grep ESTAB | wc -l 查活跃连接数：调优后应更平稳，不再持续缓慢上升
• 查 Nginx 日志中 $connection_requests 字段分布：多数连接应在设定区间内关闭（如设 2000，则大部分连接在 1500–2000 次请求后断开）
• 压测时对比 TIME_WAIT 数量：合理调优后，相同 QPS 下应明显下降
• 用 curl -I 连续请求，观察响应头：前几次返回 Connection: keep-alive，接近上限时变为 Connection: close