必须在专属 upstream 块中配置 keepalive_requests n，如 api_backend 中设为 30，配合 proxy_http_version 1.1 和 connection '' 启用复用，才能实现该虚拟主机到后端长连接的请求数限制。
Nginx 中 不能在 server 块内直接对某个虚拟主机（virtual host）全局限制“到后端的长连接最大请求数”，因为 keepalive_requests 是 upstream 连接池层面 的配置，作用对象是 upstream 块中定义的后端节点，而非 server 或 location。但你可以通过合理组合配置，实现“该虚拟主机所代理的流量，其发往后端的每个长连接最多处理 N 个请求”的效果。
关键点在于：keepalive_requests 必须放在 upstream 块中（或其父级 http/upstream 上下文），且它控制的是「Nginx 到后端」的连接复用行为，不是「客户端到 Nginx」的连接。
✅ 正确做法：为该虚拟主机专属 upstream 设置 keepalive_requests
假设你有一个虚拟主机 api.example.com，它只代理到特定后端集群，你想限制它发出的每个长连接最多处理 30 个请求：
# 单独为这个虚拟主机定义专用 upstream
upstream api_backend {
server 10.0.1.10:8080;
server 10.0.1.11:8080;
# ⚠️ 关键：设置每个后端连接最多复用 30 次请求
keepalive_requests 30;
# 配套：维持最多 64 个空闲长连接（连接池大小）
keepalive 64;
}
server {
listen 80;
server_name api.example.com;
location / {
proxy_pass http://api_backend;
proxy_http_version 1.1;
proxy_set_header Connection ''; # 清除 Connection header，启用 keepalive
}
}
✅ 效果：所有经由
api.example.com发往api_backend的请求，都会复用后端长连接；每条复用连接最多服务 30 个请求，之后自动关闭 —— 实现了对该虚拟主机后端链路的精准限流。
❌ 常见误解与错误写法
-
keepalive_requests 30;放在server或location块里 → 无效，Nginx 启动会报错或静默忽略 - 想用
limit_conn控制“到后端的并发请求数” →limit_conn只管「客户端到 Nginx」的连接，不作用于 upstream - 误以为
keepalive_timeout能替代keepalive_requests→ 它控制空闲超时，不控制请求数上限；两者是“或”关系，任一触发即断连
? 补充建议：协同配置更稳妥
为避免连接长期滞留或内存缓慢增长，推荐配套设置：
upstream api_backend {
server 10.0.1.10:8080;
server 10.0.1.11:8080;
keepalive_requests 30; # 主控：按请求数断连
keepalive 64; # 连接池容量
}
# 在 http 或 server 级别（非 upstream 内）设置兜底空闲超时
proxy_http_version 1.1;
proxy_set_header Connection '';
keepalive_timeout 60s; # 注意：这是 proxy_pass 的 keepalive 超时，需与 upstream 的 keepalive_requests 预期耗时匹配（如 30 请求 × 平均 1s/请求 ≈ 30s，设为 60s 较安全）
? 总结一句话
要限制某虚拟主机发往后端的长连接最大请求数，必须为其专属 upstream 块配置 keepalive_requests N，并确保 proxy_http_version 1.1 和 Connection '' 正确启用复用。这不是 server 级别的开关，而是 upstream 连接生命周期的精细调控。
