Nginx限流

• 示例配置
• 指令
• • 无延迟的排队
  • 开启dry运行模式
  • 设置所需的记录级别
  • 设置状态代码以响应被拒绝的请求返回
  • 设置共享内存区参数

官方文档
ngx_http_limit_req_module模块，用于限制每个定义密钥的请求处理率，特别是来自单个 IP 地址的请求的处理率。限制是使用"漏水桶"方法完成的。

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

    ...

    server {

        ...

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

Syntax:	limit_req zone=name [burst=number] [nodelay | delay=number];
Default: —
Context: 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参数指定过度请求被延迟的限制。默认值为零，即所有过多请求均被延迟。

例如，以下配置将限制来自单个 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 在当前级别上定义的指令。

在此模式下，请求处理率不限于共享内存区，超额请求的数量将照常计入。

Syntax:	limit_req_dry_run on | off;
Default: limit_req_dry_run off;
Context: http, server, location
This directive appeared in version 1.17.1.

当服务器因费率超标而拒绝处理请求或延迟请求处理时，为所需记录级别设置。延迟记录水平比拒绝少一点：例如, 如果 “limit_req_log_level notice” 已指定，延迟记录在 info 等级.

Syntax:	limit_req_log_level info | notice | warn | error;
Default: limit_req_log_level error;
Context: http, server, location
This directive appeared in version 0.8.18.

Syntax:	limit_req_status code;
Default: limit_req_status 503;
Context: http, server, location
This directive appeared in version 1.3.15.

为共享内存区设置参数，该区域将保留各种键的状态。 特别，该状态存储当前过多请求的数量。可以包含文本,变量及其组合。具有空密钥值的请求不占key。

示例：状态保存在 10 兆字节区域"一"中，该区域的平均请求处理率不能超过每秒 1 个请求。

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

客户端IP地址用作密钥。注意这里使用的是变量，对于IPv4地址，变量大小始终为4字节；对于IPv6地址，变量大小始终为16字节。存储状态在32位平台上始终占用64字节，在64位平台上始终占用128字节。一个兆字节的区域可以保存大约16000个64字节的状态或大约8000个128字节的状态。

$remote_addr$binary_remote_addr$binary_remote_addr

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

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