如何通过 limit_conn 限制单个 Server 维度的全局总连接数保障资源均衡-Nginx-PHP中文网

通过$server_name定义limit_conn_zone可实现单个server维度的全局总连接数限制，即对同一域名所有入站连接统一计数并设硬上限，保障多租户资源隔离。

如何通过 limit_conn 限制单个 server 维度的全局总连接数保障资源均衡

要通过 limit_conn 限制单个 Server 维度的全局总连接数，核心是用 $server_name 作为 key 定义连接计数区域，让 Nginx 对该虚拟主机（即 server 块监听的域名或 IP:port 组合）所有入站连接统一计数，从而实现“整个站点级”的并发连接上限控制。

这个做法不看客户端 IP，而是把整台 Nginx 实例上、所有访问该 server 的 TCP 连接（无论来自多少个不同用户）加总起来，一旦超过设定阈值，新连接就会被拒绝。它适合防止某个高流量域名独占全部连接资源，保障多租户或多个业务共存时的资源均衡。

H3：定义基于 server_name 的共享内存区域

必须放在 http{} 块内，不能写在 server 或 location 中：

http {
    limit_conn_zone $server_name zone=per_server:10m;
}

$server_name 取当前匹配到的 server_name 指令值（如 api.example.com），同一个域名的所有请求都会归入同一计数桶。
zone=per_server:10m 表示分配 10MB 共享内存存储该 zone 的状态；10MB 在 64 位系统中约可记录 16 万个独立域名状态（实际你通常只配几个 server，完全够用）。
不要用 $host 或 $http_host，它们可能被客户端篡改，不安全；$server_name 是 Nginx 内部匹配结果，更可靠。

H3：在目标 server 块中启用总连接限制

在对应 server{} 块里直接使用 limit_conn 绑定上面定义的 zone：

server {
    listen 443 ssl;
    server_name api.example.com;

    limit_conn per_server 500;  # 整个该 server 最多 500 并发连接
}

这行配置生效后，所有命中此 server 的连接（包括 HTTP/1.1、HTTP/2、keepalive 空闲连接）都会计入总数。
注意：limit_conn per_server 500 是“硬上限”，超出立即拒绝，不排队、不延迟。
若同时还要限制单 IP 连接数，可叠加一行：limit_conn per_ip 20;（需提前定义 per_ip zone），形成双层防护。

H3：配合关键参数提升可控性与可观测性

单独限连接数容易“静默失败”，加上这几项能让行为更明确、问题更好排查：

limit_conn_log_level error;
把触发限流的日志等级提到 error，避免被大量 warn 日志淹没，便于监控告警。
limit_conn_status 503;
明确返回 503 Service Temporarily Unavailable（也可设为 429 Too Many Requests，语义更精准，但需确认下游兼容）。
keepalive_timeout 15;
缩短空闲 keepalive 连接生命周期，避免长期占着配额却不干活；15 秒是较平衡的取值。
记录真实客户端 IP（如有前置 LB）
若 Nginx 前有 CDN 或代理，记得用 set_real_ip_from + real_ip_header 还原 $binary_remote_addr，否则 $server_name 区域虽正确，但单 IP 限流会失效。

H3：典型多 server 场景下的资源隔离效果

假设一台 Nginx 托管三个服务：

server { server_name a.example.com; limit_conn per_server 300; }
server { server_name b.example.com; limit_conn per_server 300; }
server { server_name c.example.com; limit_conn per_server 400; }