Mastering Nginx

Directive Reference

[ 234 ]

Directive Explanation Context/Default

least_conn Activates the load-balancing

algorithm where the server

with the least number of active

connections is chosen for the next

new connection.

Valid context:

upstream

Default value: -

limit_conn Specifies a shared memory zone

(configured with limit_conn_

zone) and the maximum number

of connections that are allowed per

key value.

Valid contexts: http,

server, location

Default value: -

limit_conn_log_

level

When NGINX limits a connection

due to the limit_conn directive,

this directive specifies at which log

level that limitation is reported.

Valid contexts: http,

server, location

Default value: error

limit_conn_zone Specifies the key to be limited

in limit_conn as the first

parameter. The second parameter,

zone, indicates the name of the

shared memory zone used to store

the key and current number of

connections per key and the size of

that zone (name:size).

Valid context: http

Default value: -

limit_except Will limit a location to the

specified HTTP verb(s) (GET also

includes HEAD).

Valid context:

location

Default value: -

limit_rate Limits the rate (in bytes per

second) at which clients can

download content. The rate limit

works on a connection level,

meaning that a single client could

increase their throughput by

opening multiple connections.

Valid context: http,

server, location,

if in location

Default value: 0

limit_rate_after Starts the limit_rate after

this number of bytes have been

transferred.

Valid contexts: http,

server, location,

if in location

Default value: 0