如何利用 keepalive_time（Nginx 1.19.10+）限制单个长连接的最长存活时间-Nginx-PHP中文网

keepalive_time用于限制单个keepalive连接的总存活时长，从建立开始计时，超时即关闭；它与keepalive_timeout独立共存，分别控制总时长和空闲超时。

如何利用 keepalive_time（nginx 1.19.10+）限制单个长连接的最长存活时间

在 Nginx 1.19.10 及更高版本中，keepalive_time 指令可用于直接限制单个 HTTP/1.1 长连接的最大存活时长（单位：秒），超时后连接会被主动关闭。这比仅依赖 keepalive_timeout（控制空闲超时）更精细，能有效防止连接长期占用 worker 进程资源。

keepalive_time 的作用与适用场景

该指令设定的是“从连接建立开始”的总存活上限，无论期间是否有请求、是否活跃。适用于以下情况：

防止客户端异常保持连接不释放（如移动端后台进程、调试工具未断连）
配合服务端滚动更新或优雅重启，避免旧连接持续存在数小时
在高并发下控制连接生命周期，提升连接复用率与资源周转效率

基本配置语法与位置

keepalive_time 必须放在 http 或 server 块中，不能在 location 中使用。示例：

http {
    keepalive_time 60m;  # 所有 server 默认最长存活 60 分钟
    server {
        listen 443 ssl;
        server_name example.com;
        keepalive_time 30m;  # 覆盖 http 级别，该 server 最长 30 分钟
        ...
    }
}

注意：keepalive_time 不影响连接空闲超时逻辑，keepalive_timeout 仍生效——即连接会在「空闲超过 keepalive_timeout」或「总存活超过 keepalive_time」任一条件满足时关闭。

Nginx Hosting

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

下载

与 keepalive_timeout 的协同关系

两者是独立但共存的机制，Nginx 会同时检查：

若连接空闲时间 ≥ keepalive_timeout → 立即关闭（常见于无请求的长连接）
若连接已存在时间 ≥ keepalive_time → 立即关闭（即使刚处理完一个请求）
实际连接寿命 = min(keepalive_time, 上次请求后等待时间 + keepalive_timeout)

例如：keepalive_time 10m + keepalive_timeout 5s，则：即使每秒都有请求，连接也最多活 10 分钟；若某次请求后停顿 6 秒，连接会在第 6 秒关闭（由 keepalive_timeout 触发）。

验证与调试建议

启用后可通过以下方式确认效果：

用 curl -v --http1.1 http://host/ 观察响应头是否含 Connection: keep-alive，再复用同一 TCP 连接发多次请求
结合 nginx -t && nginx -s reload 生效后，用 ss -tnp | grep :80 查看连接的 timer 字段（如 on 00:00:29 表示距超时还剩 29 秒）
开启 error_log /path/to/log notice;，连接因 keepalive_time 超时关闭时，日志中会出现 "client timed out (110: Connection timed out) while keepalive" 类提示（注意：实际提示文本可能略有差异，以 Nginx 编译版本为准）