nginx中http代理的连接重用时间核心由keepalive_timeout控制客户端与nginx间长连接复用时长，而nginx到后端的复用需配合upstream keepalive指令、proxy_http_version 1.1和proxy_set_header connection ""三者协同实现。
Nginx 中 HTTP 代理的连接重用时间，核心是通过 keepalive_timeout 控制客户端与 Nginx 之间的长连接复用时长，而非直接控制 Nginx 到后端服务器的连接复用——后者需配合 upstream keepalive 指令实现。
客户端到 Nginx 的连接重用（HTTP Keep-Alive）
这是最常被问及的“连接重用”，实际影响浏览器或客户端能否复用 TCP 连接发多个请求：
- 配置
keepalive_timeout即可启用 - 第一个值（必需）：Nginx 在服务端保持空闲连接打开的时间（秒），超时即主动关闭
- 第二个值（可选）：写入响应头
Keep-Alive: timeout=N，提示客户端建议复用时长（如keepalive_timeout 30 25;） - 可放在
http、server或location块，优先级从高到低；推荐在http块统一设基础值，再按需局部调整
典型参考值：
- 静态资源密集型站点（如门户首页）：15–25 秒
- API 接口服务（移动端调用多）：45–60 秒
- 调试阶段临时禁用：
keepalive_timeout 0;
验证方式：
-
curl -I https://your-domain.com/查看响应头是否含Connection: keep-alive和Keep-Alive: timeout=XX -
netstat -an | grep :80 | grep ESTABLISHED观察活跃连接数是否稳定不陡增
Nginx 到后端服务器的连接池复用（upstream keepalive）
若你真正想优化的是 Nginx 与上游（如 Tomcat、Node.js）之间的连接复用（避免频繁建连开销），必须额外配置：
- 在
upstream块中启用连接池：upstream backend { server 10.0.0.1:8080; keepalive 32; # 保持最多 32 个空闲长连接 } - 在对应
location中启用 HTTP/1.1 并清理 Connection 头：location /api/ { proxy_pass http://backend; proxy_http_version 1.1; proxy_set_header Connection ''; } - 注意：
keepalive指令本身不设超时，它依赖keepalive_timeout（客户端侧）和后端服务自身的 keepalive 设置协同生效
配套关键参数（防连接堆积）
仅设 keepalive_timeout 不够，还需控制请求生命周期，避免假死连接占用资源：
-
client_header_timeout 10s：等待客户端发完请求头的上限 -
client_body_timeout 15s：两次接收请求体数据的间隔上限 -
send_timeout 30s：向客户端发送响应时单次写操作超时 - 这些建议统一放在
http块，与keepalive_timeout并列配置
常见误区提醒
-
proxy_*_timeout（如proxy_read_timeout）控制的是 Nginx 等后端响应的时间，不影响连接是否复用，只决定单次请求最长等多久 - 浏览器实际复用行为受自身限制（如 Chrome 通常尊重 header，IE/旧 Edge 实际上限常为 60 秒）
-
keepalive_requests（默认 100）限制单个长连接最大请求数，可配合keepalive_timeout防止连接长期占用
不复杂但容易忽略。
