Nginx 中 limit_conn_zone 必须在 http 块最外层定义,以 $binary_remote_addr 等稳定变量为 key,zone 名全局唯一;需配合 limit_conn 指令生效,后者可置于 server 或 location 中取最小值限制连接数。

在 Nginx 中设置 limit_conn_zone 共享内存区,核心是用一个稳定、省内存的变量作 key,在 http 块中声明一块共享内存,用来实时统计每个客户端的当前活跃连接数。
必须写在 http 块里,不能嵌套在 server 或 location 中
limit_conn_zone 只能在 http 上下文中使用。写在 server 或 location 里会报错:unknown directive "limit_conn_zone"。
- 正确位置:所有
server块之前、http { ... }内部最外层 - 典型写法:
limit_conn_zone $binary_remote_addr zone=perip:10m; - zone 名称(如
perip)需全局唯一,后续limit_conn指令靠它引用
推荐用 $binary_remote_addr 作 key
它把 IPv4 地址压缩成固定 4 字节、IPv6 压缩成 16 字节,比 $remote_addr 更省内存,且不受 X-Forwarded-For 伪造影响。
- 不建议直接用
$remote_addr:字符串长度不固定,内存开销大 - 代理环境下要换用
$realip_remote_addr,但前提是已配置real_ip_module和set_real_ip_from - 若需按域名限流,可用
$server_name;按后端服务区分,可用map构造的自定义变量(如$backend_id)
size 大小要够用,否则会丢连接状态
10MB 的 zone 约支持 16 万~32 万个独立 IP 的连接计数。如果 error.log 出现 limit_conn: cannot add connection,说明共享内存溢出。
- 常见调整:从
10m改为20m或50m - 不必过度预留——每个 IP 状态只占约 64 字节,实际用量取决于并发 IP 数量
- 可配合日志观察:
limit_conn_log_level warn;能记录溢出或拒绝细节
定义完 zone 不代表生效,还需搭配 limit_conn
limit_conn_zone 只是“建表”,真正限制行为由 limit_conn 触发。后者可出现在 http、server、location 任一级,但实际生效值取嵌套中最内层的最小数值。
- 例如:
server设了limit_conn perip 10,而location /api/里又设了limit_conn perip 3,则该路径实际限制为 3 - 不要直接放在
location /下,否则静态资源也受限,徒增 CPU 开销 - 建议只对高连接消耗路径启用,比如
/ws/、/download/、/login











