在 nginx 中结合 limit_conn 限制单 ip 连接,核心做法是先在 http 块定义 limit_conn_zone 以 $binary_remote_addr 为键建立共享内存区,然后在目标 location 块中使用 limit_conn 指令引用该区域并指定上限。这样做会针对每个客户端 ip 维护一个活跃连接计数器,一旦超过设定值,nginx 将立即返回 503 service temporarily unavailable 错误。

如何配置全局连接限制区域
要启用基于 IP 的连接限制,必须在 http 上下文中预先声明一个共享内存区域。使用 limit_conn_zone 指令,设置 key=$binary_remote_addr 可以确保每个 IPv4 地址占用固定的 64 字节内存,IPv6 占用 128 字节,从而高效地追踪每个 IP 的状态。参数 rate=0 表示我们只统计连接数,而不像 limit_req 那样统计请求速率。这个区域是后续所有 location 限制的基础,必须在全局生效。

worker_processes auto;
events {
worker_connections 1024;
}
http {
# 定义共享内存区,名称为 one,大小为 10m
# key 使用 binary_remote_addr 以节省内存
limit_conn_zone $binary_remote_addr zone=one:10m;
server {
listen 80;
server_name example.com;
location /api/ {
# 引用上面定义的 'one' 区域
# 限制每个 IP 最多同时保持 5 个连接
limit_conn one 5;
proxy_pass http://backend;
}
}
}
上述配置中,zone=one:10m 创建了一个名为 one 的区域,容量为 10MB。在 /api/ 路径下,limit_conn one 5 意味着来自同一个 IP 的客户端,如果同时有超过 5 个未关闭的连接(包括正在处理中的请求),第 6 个连接将被拒绝。这种机制适用于防止单个用户耗尽服务器资源,或者应对简单的 CC 攻击。
不同 Location 如何复用或隔离限制策略
在实际部署中,静态资源和动态 API 对连接的容忍度不同。可以通过定义多个 limit_conn_zone 或使用不同的 limit_conn 组合来实现差异化限制。例如,可以为静态文件设置较高的并发上限,而为写操作接口设置严格的低上限。关键在于每个 limit_conn 指令引用的 zone 名称必须与 http 块中定义的 zone 名称一致,且 Nginx 会对匹配的所有 limit_conn 指令所引用的 zone 进行累加计数。

http {
# 定义两个独立的区域
limit_conn_zone $binary_remote_addr zone=static_zone:10m;
limit_conn_zone $binary_remote_addr zone=api_zone:10m;
server {
listen 80;
server_name example.com;
location /static/ {
# 静态资源允许较高并发,每个 IP 最多 20 个连接
limit_conn static_zone 20;
root /var/www/html;
}
location /api/write {
# 写操作严格限制,每个 IP 最多 2 个连接
limit_conn api_zone 2;
proxy_pass http://backend_write;
}
location /api/read {
# 读操作中等限制,每个 IP 最多 10 个连接
limit_conn api_zone 10;
proxy_pass http://backend_read;
}
}
}
在这个例子中,/static/ 路径独立使用 static_zone,而 /api/write 和 /api/read 都使用 api_zone。需要注意的是,如果在一个 location 中同时引用了多个 zone,Nginx 会检查所有这些 zone 的限制。但在本例中,每个 location 只引用一个特定的 zone,从而实现了对不同业务场景的精细化控制。当请求进入 /api/write 时,只有 api_zone 中的计数器会增加,不会影响 /static/ 的连接统计。
超过限制时客户端收到什么响应
当某个 IP 的连接数达到 limit_conn 设定的阈值时,新的连接请求会被直接拒绝。默认情况下,Nginx 会返回 HTTP 状态码 503 Service Temporarily Unavailable。这个响应由 Nginx 自身生成,而不是后端应用服务器。对于前端开发者或客户端来说,这意味着需要实现重试机制,通常建议配合指数退避算法来处理 503 错误,以避免在服务器恢复期间造成更多的请求堆积。











