通过$server_name定义limit_conn_zone可实现单个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_ipzone),形成双层防护。
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; }- 总连接上限不是
300+300+400=1000,而是三者各自独立计数; - 即使
a.example.com突发打满 300 连接,也不会影响b和c的可用连接数; - 后端资源(如 upstream 连接池、CPU、内存)就能按域名维度被均分,避免一个业务雪崩拖垮整台网关。
这种设计天然适配 SaaS 多租户、灰度环境隔离、或内部服务分级保障等生产需求。

















