模块 ngx_http_limit_req_module

主要用到的指令

 limit_req 
 limit_req_log_level 
 limit_req_status 
 limit_req_zone
 

所述 ngx_http_limit_req_module 模块（0.7.21）用于限制每一个定义的键值的请求的处理速率，特别是从一个单一的 IP 地址的请求的处理速率。使用“漏桶”方法进行限制。

示例配置

http { 
    limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s; 

    ... 

    server { 

        ... 

        location / search / {limit_req zone=one burst=5;}

指令

句法：limit_req zone=name [burst=number] [nodelay | delay=number];
默认：–
语境：http，server，location

设置共享内存区域和请求的最大突发大小。如果请求速率超过为区域配置的速率，则延迟处理，以便以定义的速率处理请求。过多的请求被延迟，直到它们的数量超过最大突发大小，在这种情况下请求以错误终止。默认情况下，最大突发大小等于零。例如，指令

limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

server { 
    location / search / {limit_req zone=one burst=5;}

平均每秒允许不超过 1 个请求，突发不超过 5 个请求。

如果不希望在请求受限的情况下延迟过多的请求，nodelay 则应使用以下参数：

limit_req zone=one burst=5 nodelay;

delay参数（1.15.7）指定在该过度请求成为被延迟请求的最大值。默认值为零，即所有过多的请求都会延迟。

可以有多个 limit_req 指令。例如，以下配置将限制来自单个 IP 地址的请求的处理速率，同时限制虚拟服务器的请求处理速率：

limit_req_zone $binary_remote_addr zone=perip:10m rate=1r/s;
limit_req_zone $server_name zone=perserver:10m rate=10r/s;

server {
    ...
    limit_req zone=perip burst=5 nodelay;
    limit_req zone=perserver burst=10;
}

当且仅当 limit_req 当前级别没有指令时，这些指令才从先前级别继承。

句法：limit_req_log_level info | notice | warn | error;
默认：
limit_req_log_level 错误;
语境：http，server，location
该指令出现在 0.8.18 版本中。

为服务器因速率超过或延迟请求处理而拒绝处理请求的情况设置所需的日志记录级别。延迟的记录水平比拒绝的记录水平低一个点; 例如，如果 limit_req_log_level notice 指定了“”，则会使用 info 级别记录延迟。

句法：limit_req_status code;
默认：
limit_req_status 503;
语境：http，server，location
该指令出现在 1.3.15 版本中。

设置要响应拒绝的请求而返回的状态代码。

句法：limit_req_zone key zone=name:size rate=rate [sync];
默认：–
语境：http
设置共享内存区域的参数，该区域将保留各种键的状态。特别是，状态存储当前的过多请求数。该 key 可以包含文本，变量，他们的组合。具有空键值的请求不计算在内。

在 1.7.6 版之前，键值 key 可以只包含一个变量。

用法示例：

limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

这里，状态保持在 10 兆字节区域“one”，并且该区域的平均请求处理速率不能超过每秒 1 个请求。

客户端 IP 地址用作键值。需要注意的是，而不是 $remote_addr，该 $binary_remote_addr 变量在这里使用。$binary_remote_addr 对于 IPv4 地址，变量的大小始终为 4 个字节，对于 IPv6 地址，变量的大小始终为 16 个字节。存储状态在 32 位平台上总是占用 64 个字节，在 64 位平台上占用 128 个字节。一兆字节区域可以保留大约 16,000 个 64 字节状态或大约 8 千个 128 字节状态。

如果区域存储空间耗尽，则删除最近最少使用的状态。即使在此之后无法创建新状态，该请求也会因错误而终止。

速率以每秒请求数（r/s）指定。如果需要每秒少于一个请求的速率，则在每分钟请求（r/m）中指定。例如，每秒半请求为 30r/m。

的 sync 参数（1.15.3）使 同步 共享存储器区。

该 sync 参数作为我们商业订阅的一部分提供。