nginx limit配置参数解读

淩亂°似流年 2021-11-26 15:14 225阅读 0赞

## 序 ##

本文主要解析一下ngx\_http\_core\_module、ngx\_http\_limit\_conn\_module以及ngx\_http\_limit\_req\_module中的limit相关配置参数。

## limit\_rate ##

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>默认配置</th> 
   <th>作用域</th> 
   <th>官方说明</th> 
   <th>中文解读</th> 
   <th>模块</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>limit_rate</td> 
   <td>limit_rate 0;</td> 
   <td>http, server, location, if in location</td> 
   <td>Limits the rate of response transmission to a client. The rate is specified in bytes per second. The zero value disables rate limiting. The limit is set per a request, and so if a client simultaneously opens two connections, the overall rate will be twice as much as the specified limit.</td> 
   <td>指定每秒该连接能下载的bytes,主要用来限制个别请求的带宽</td> 
   <td>ngx_http_core_module</td> 
  </tr> 
  <tr> 
   <td>limit_rate_after</td> 
   <td>limit_rate_after 0;</td> 
   <td>http, server, location, if in location</td> 
   <td>Sets the initial amount after which the further transmission of a response to a client will be rate limited.</td> 
   <td>设置多少bytes过后将启动limit计数,如果小于此值则不限速</td> 
   <td>ngx_http_core_module</td> 
  </tr> 
  <tr> 
   <td>limit_except</td> 
   <td>没有默认值</td> 
   <td>location</td> 
   <td>Limits allowed HTTP methods inside a location. The method parameter can be one of the following: GET, HEAD, POST, PUT, DELETE, MKCOL, COPY, MOVE, OPTIONS, PROPFIND, PROPPATCH, LOCK, UNLOCK, or PATCH. Allowing the GET method makes the HEAD method also allowed</td> 
   <td>设置除了指定的http methods外其他method将被限制，允许GET就自动允许HEAD方法</td> 
   <td>ngx_http_core_module</td> 
  </tr> 
 </tbody> 
</table>

*  实例

location /downloads {
                limit_rate_after 1m;
                limit_rate 500k;
            }
    
            location / {
                proxy_pass http://localhost:3000;
                limit_except GET {
                    deny all;
                }
            }

## limit\_conn ##

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>默认配置</th> 
   <th>作用域</th> 
   <th>官方说明</th> 
   <th>中文解读</th> 
   <th>模块</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>limit_conn</td> 
   <td>没有默认值,语法 limit_conn zone number;</td> 
   <td>http, server, location</td> 
   <td>Sets the shared memory zone and the maximum allowed number of connections for a given key value. When this limit is exceeded, the server will return the error in reply to a request.</td> 
   <td>指定一个zone的每个key最大连接数</td> 
   <td>ngx_http_limit_conn_module</td> 
  </tr> 
  <tr> 
   <td>limit_conn_zone</td> 
   <td>没有默认值,语法 limit_conn_zone key zone=name:size;</td> 
   <td>http</td> 
   <td>Sets parameters for a shared memory zone that will keep states for various keys. In particular, the state includes the current number of connections. The key can contain text, variables, and their combination. Requests with an empty key value are not accounted.</td> 
   <td>第一个参数是key,第二个参数是指定zone及其存放元数据(key,current num of conns per key,zone size)的共享内存大小</td> 
   <td>ngx_http_limit_conn_module</td> 
  </tr> 
  <tr> 
   <td>limit_conn_log_level</td> 
   <td>limit_conn_log_level error;</td> 
   <td>http, server, location</td> 
   <td>Sets the desired logging level for cases when the server limits the number of connections. This directive appeared in version 0.8.18.</td> 
   <td>指定当触发limit的时候日志打印级别</td> 
   <td>ngx_http_limit_conn_module</td> 
  </tr> 
 </tbody> 
</table>

*  实例

http {
        limit_conn_zone $binary_remote_addr zone=ips:10m;
        limit_conn_zone $server_name zone=servers:10m;
        limit_conn_log_level notice;
        server {
            # these limits apply to the whole virtual server
            limit_conn ips 10;
    
            # only 1000 simultaneous connections to the same server_name
            limit_conn servers 1000;
        }
    }

## limit\_req ##

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>默认配置</th> 
   <th>作用域</th> 
   <th>官方说明</th> 
   <th>中文解读</th> 
   <th>模块</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>limit_req</td> 
   <td>没有默认值,语法 limit_req zone=name [burst=number] [nodelay];</td> 
   <td>http, server, location</td> 
   <td>Sets the shared memory zone and the maximum burst size of requests. If the requests rate exceeds the rate configured for a zone, their processing is delayed such that requests are processed at a defined rate. Excessive requests are delayed until their number exceeds the maximum burst size in which case the request is terminated with an error.</td> 
   <td>指定zone的burst大小</td> 
   <td>ngx_http_limit_req_module</td> 
  </tr> 
  <tr> 
   <td>limit_req_zone</td> 
   <td>没有默认值,语法 limit_req_zone key zone=name:size rate=rate;</td> 
   <td>http</td> 
   <td>Sets parameters for a shared memory zone that will keep states for various keys. In particular, the state stores the current number of excessive requests. The key can contain text, variables, and their combination. Requests with an empty key value are not accounted.</td> 
   <td>第一个参数指定key,第二个参数指定zone名称和元数据的内存大小,第三个参数rate指定单位时间的请求数阈值</td> 
   <td>ngx_http_limit_req_module</td> 
  </tr> 
  <tr> 
   <td>limit_req_log_level</td> 
   <td>limit_req_log_level error;</td> 
   <td>http, server, location</td> 
   <td>Sets the desired logging level for cases when the server refuses to process requests due to rate exceeding, or delays request processing. Logging level for delays is one point less than for refusals.</td> 
   <td>指定触发req limit时打印的日志级别</td> 
   <td>ngx_http_limit_req_module</td> 
  </tr> 
 </tbody> 
</table>

*  实例

http {
     limit_req_zone $binary_remote_addr zone=myreqzone:10m
     limit_req_log_level warn;
    
     server {
        ## 每个ip限定10个连接数
        ## 正常一个浏览器给每个host开两到三个连接
        ## 触发的话会返回503
        ## nodelay表示一上来就直接计算,不经过一些预热后再计算
        limit_req zone=myreqzone burst=10 nodelay;
     }
    }

## doc ##

*  [ngx\_http\_core\_module][ngx_http_core_module]
 *  [ngx\_http\_limit\_conn\_module][ngx_http_limit_conn_module]
 *  [ngx\_http\_limit\_req\_module][ngx_http_limit_req_module]

[ngx_http_core_module]: https://link.jianshu.com?t=http%3A%2F%2Fnginx.org%2Fen%2Fdocs%2Fhttp%2Fngx_http_core_module.html
[ngx_http_limit_conn_module]: https://link.jianshu.com?t=http%3A%2F%2Fnginx.org%2Fen%2Fdocs%2Fhttp%2Fngx_http_limit_conn_module.html
[ngx_http_limit_req_module]: https://link.jianshu.com?t=http%3A%2F%2Fnginx.org%2Fen%2Fdocs%2Fhttp%2Fngx_http_limit_req_module.html