HttpLimitConnModule - Revision history

Admin: /* Directives */

2012-05-02T19:33:42Z

‎Directives

Admin: /* limit_zone */

2012-04-30T16:15:07Z

‎limit_zone

Admin: /* limit_conn_log_level */

2012-04-30T16:13:51Z

‎limit_conn_log_level

Admin: /* Directives */

2012-04-30T16:13:18Z

‎Directives

Ensiferous: Renamed module.

2012-01-31T04:08:29Z

Renamed module.

New page

= Synopsis =
This module makes it possible to limit the number of concurrent connections for a defined key such as, for example, an ip address.

Example configuration
<geshi lang="nginx">
http {
limit_conn_zone $binary_remote_addr zone=one:2m;
limit_conn_log_level notice;

server {
location /download {
limit_conn one 1;
}
}
}
</geshi>

= Directives =
== limit_conn ==
'''syntax:''' ''limit_conn zone_name number''

'''default:''' ''no''

'''context:''' ''http''

Sets the maximum allowed number of connections for a given zone. When this limit is exceeded, the server will return a status error 503 (Service Temporarily Unavailable) in reply to the request.

Multiple limit directives for different zones can be used in the same context and each will apply.

Standard nginx inheritance applies. Lower contexts will inherit from higher context so long as there are no similar directives in the current context.

== limit_conn_zone ==

'''syntax:''' ''limit_conn_zone $variable zone=name:size;''

'''default:''' ''no''

'''context:''' ''http, server, location''

Sets the parameters for a zone that keeps state for various keys. This state stores the current number of connections in particular. The key is the value of the specified variable. Example usage:

<geshi lang="nginx">
limit_conn_zone $binary_remote_addr zone=addr:10m;
</geshi>

Here, an IP address of the client serves as a key. Note that instead of $remote_addr, the $binary_remote_addr variable is used here. The length of the $remote_addr variable's value can range from 7 to 15 bytes, and the stored state occupies either 32 or 64 bytes of memory on 32-bit platforms, and always 64 bytes on 64-bit platforms. The length of the $binary_remote_addr variable's value is always 4 bytes, and the stored state always occupies 32 bytes on 32-bit platforms, and 64 bytes on 64-bit platforms. One megabyte zone can keep about 32 thousand 32-bit states, and about 16 thousand 64-byte states. If the storage for a zone is exhausted, the server will return error 503 (Service Temporarily Unavailable) to all further requests.

== limit_conn_log_level ==

'''syntax:''' ''limit_conn_log_level info | notice | warn | error''

'''default:''' ''error''

'''context:''' ''http, server, location''

Sets the error log level used when a connection limit is reached.

= References =
[http://nginx.org/en/docs/http/ngx_http_limit_conn_module.html Original Documentation]

@@ Line 18: / Line 18: @@
 = Directives =
 == limit_conn ==
-<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_limit_conn_module/limit_conn.txt" />
+<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_limit_conn_module/limit_conn.txt" />
 Sets the maximum allowed number of connections for a given zone. When this limit is exceeded, the server will return a status error 503 (Service Temporarily Unavailable) in reply to the request.
@@ Line 27: / Line 27: @@
 == limit_conn_zone ==
-<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_limit_conn_module/limit_conn_zone.txt" />
+<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_limit_conn_module/limit_conn_zone.txt" />
 Sets the parameters for a zone that keeps state for various keys. This state stores the current number of connections in particular. The key is the value of the specified variable. Example usage:
@@ Line 38: / Line 38: @@
 == limit_conn_log_level ==
-<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_limit_conn_module/limit_conn_log_level.txt" />
+<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_limit_conn_module/limit_conn_log_level.txt" />
 Sets the error log level used when a connection limit is reached.

@@ Line 41: / Line 41: @@
 Sets the error log level used when a connection limit is reached.
 = References =
 [http://nginx.org/en/docs/http/ngx_http_limit_conn_module.html Original Documentation]