ngx_http_limit_req_module
设置共享内存区域和请求的最大突发大小。如果请求速率超过为某个区域配置的速率,则它们的处理会延迟,从而使请求以定义的速率处理。过多的请求被延迟,直到它们的数量超过最大突发大小,在这种情况下请求被终止并出现错误。 默认情况下,最大突发大小等于零。例如:
平均每秒不超过 1 个请求,并且突发不超过 5 个请求。
如果在限制期间延迟请求过多,则不需要使用参数 nodelay
:
当且仅当在当前级别上没有 limit_req
指令时,这些指令才从上一级继承。
当服务器由于速率超出而拒绝处理请求或延迟请求处理时,设置所需的日志记录级别。延误情况的记录等级比拒绝情况的记录低一些。例如,如果指定了 limit_req_log_level notice
,则延迟情况将会在 info
级别记录。
设置响应拒绝请求返回的状态码。
为共享内存区域设置参数,该区域将保留各种键的状态。特别是,该状态包含当前的连接数。key
可以包含文本、变量及其组合。不包括有空键值的请求。
在这里,状态保持在 10 兆字节的区域 one,并且该区域的平均请求处理速率不能超过每秒 1 个请求。
客户端 IP 地址作为 key。请注意,不是 $remote_addr
,而是使用 $binary_remote_addr
变量。$binary_remote_addr
变量的大小始终为 4 个字节,对于 IPv6 地址则为 16 个字节。存储状态在 32 位平台上始终占用 32 或 64 个字节,在 64 位平台上占用 64 个字节。一兆字节的区域可以保持大约 32000 个 32 字节的状态或大约 16000 个 64 字节的状态或大约 8000 个 128 字节的状态。
如果区域存储耗尽,最近最少使用的状态将被删除。即使在此之后无法创建新状态,该请求也会因而终止。
速率以每秒请求数(r/s)指定。如果需要每秒小于一个请求的速率,则按每分钟请求(r/m)指定。例如,每秒半请求是 30r/m。
http://nginx.org/en/docs/http/ngx_http_limit_req_module.html