ngx_http_limit_req_module 模块 (0.7.21) 用于限制每个定义的键的请求处理率，特别是来自单个 IP 地址的请求的处理率。限制是使用 “leaky bucket” 方法完成的。
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_dry_run on | off; 默认值：limit_req_dry_run off; 上下文：http, server, location
该指令出现在 1.17.1 版中。
启用试运行模式。在这种模式下，请求处理速率不受限制，但是在共享内存区域中，过度请求的数量照常计算。
语 法：limit_req_log_level info | notice | warn | error; 默认值：limit_req_log_level error; 上下文：http, server, location
该指令出现在 0.8.18 版本中。
为服务器因速率超过或延迟请求处理而拒绝处理请求的情况设置所需的日志记录级别。延迟的记录级别比拒绝的记录级别低1分；例如，如果指定了 “limit_req_log_level notice”，则使用信息级别记录延迟。
语 法：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
为共享内存区域设置参数，该区域将保持各种键的状态。特别是，状态存储了当前的过度请求数。键可以包含文本、变量及其组合。 不考虑具有空键值的请求。
在 1.7.6 版之前，一个键可以只包含一个变量。
用法示例：
limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;
在这里，状态保存在一个 10 兆字节的区域 “one” 中，并且该区域的平均请求处理速率不能超过每秒 1 个请求。
客户端 IP 地址用作密钥。请注意，这里使用的是 $binary_remote_addr 变量而不是 $remote_addr。$binary_remote_addr 变量的大小对于 IPv4 地址始终为 4 个字节，对于 IPv6 地址始终为 16 个字节。存储状态在 32 位平台上总是占用 64 字节，在 64 位平台上总是占用 128 字节。一兆字节区域可以保留大约 16000 个 64 字节状态或大约 8000 个 128 字节状态。
如果区域存储耗尽，则删除最近最少使用的状态。 如果即使在此之后无法创建新状态，请求也会因错误而终止。
速率以每秒请求数 (r/s) 为单位指定。如果需要每秒小于一个请求的速率，则以每分钟请求数 (r/m) 指定。例如，每秒半请求为 30r/m。
sync 参数 (1.15.3) 启用共享内存区域的同步。
sync 参数作为我们商业订阅的一部分提供。
此外，作为我们商业订阅的一部分，从 1.17.7 开始，可以使用 API 获取或重置每个此类共享内存区域的状态信息。
保持限制请求处理速率的结果（1.17.6）：PASSED、DELAYED、REJECTED、DELAYED_DRY_RUN或REJECTED_DRY_RUN
