Mercurial > hg > nginx-site
changeset 1744:ab56dcd73af2
Added variables to stream hash, limit_conn_zone, proxy_bind.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 05 Jul 2016 17:58:34 +0300 |
parents | 3d686cb47c2c |
children | 0dfb7628bfee |
files | xml/en/docs/stream/ngx_stream_limit_conn_module.xml xml/en/docs/stream/ngx_stream_proxy_module.xml xml/en/docs/stream/ngx_stream_upstream_module.xml xml/ru/docs/stream/ngx_stream_limit_conn_module.xml xml/ru/docs/stream/ngx_stream_proxy_module.xml xml/ru/docs/stream/ngx_stream_upstream_module.xml |
diffstat | 6 files changed, 26 insertions(+), 19 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/stream/ngx_stream_limit_conn_module.xml +++ b/xml/en/docs/stream/ngx_stream_limit_conn_module.xml @@ -10,7 +10,7 @@ <module name="Module ngx_stream_limit_conn_module" link="/en/docs/stream/ngx_stream_limit_conn_module.html" lang="en" - rev="2"> + rev="3"> <section id="summary"> @@ -114,16 +114,15 @@ limits the number of connections. Sets parameters for a shared memory zone that will keep states for various keys. In particular, the state includes the current number of connections. -Currently, the supported value for the <value>key</value> is -the client address in the binary form specified as -<literal>$binary_remote_addr</literal>. +The <value>key</value> can contain text, variables, +and their combinations (1.11.2). Connections with an empty key value are not accounted. Usage example: <example> limit_conn_zone $binary_remote_addr zone=addr:10m; </example> Here, the key is a client IP address set by the -<literal>$binary_remote_addr</literal> key. +<literal>$binary_remote_addr</literal> variable. The size of <literal>$binary_remote_addr</literal> is 4 bytes for IPv4 addresses or 16 bytes for IPv6 addresses. The stored state always occupies 32 or 64 bytes
--- a/xml/en/docs/stream/ngx_stream_proxy_module.xml +++ b/xml/en/docs/stream/ngx_stream_proxy_module.xml @@ -9,7 +9,7 @@ <module name="Module ngx_stream_proxy_module" link="/en/docs/stream/ngx_stream_proxy_module.html" lang="en" - rev="14"> + rev="15"> <section id="summary"> @@ -66,6 +66,7 @@ server { <para> Makes outgoing connections to a proxied server originate from the specified local IP <value>address</value>. +Parameter value can contain variables (1.11.2). The special value <literal>off</literal> cancels the effect of the <literal>proxy_bind</literal> directive inherited from the previous configuration level, which allows the
--- a/xml/en/docs/stream/ngx_stream_upstream_module.xml +++ b/xml/en/docs/stream/ngx_stream_upstream_module.xml @@ -9,7 +9,7 @@ <module name="Module ngx_stream_upstream_module" link="/en/docs/stream/ngx_stream_upstream_module.html" lang="en" - rev="13"> + rev="14"> <section id="summary"> @@ -383,8 +383,12 @@ This directive is available as part of o <para> Specifies a load balancing method for a server group where client-server mapping is based on the hashed <value>key</value> value. -Currently, the only supported value for the <literal>key</literal> -is the client remote address specified as <literal>$remote_addr</literal>. +The <value>key</value> can contain text, variables, +and their combinations (1.11.2). +Usage example: +<example> +hash $remote_addr; +</example> Note that adding or removing a server from the group may result in remapping most of the keys to different servers. The method is compatible with the
--- a/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml +++ b/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml @@ -10,7 +10,7 @@ <module name="Модуль ngx_stream_limit_conn_module" link="/ru/docs/stream/ngx_stream_limit_conn_module.html" lang="ru" - rev="2"> + rev="3"> <section id="summary"> @@ -115,16 +115,15 @@ IP-адреса. Задаёт параметры зоны разделяемой памяти, которая хранит состояние для разных значений ключа. Состояние в частности содержит текущее число соединений. -На данный момент возможным значением для <value>ключа</value> является -адрес клиента в бинарном виде, указываемый как -<literal>$binary_remote_addr</literal>. +В качестве <value>ключа</value> может использоваться текст, переменные +и их комбинации (1.11.2). Запросы с пустым значением ключа не учитываются. Пример использования: <example> limit_conn_zone $binary_remote_addr zone=addr:10m; </example> Здесь в качестве ключа используется IP-адрес клиента, -задаваемый ключом <literal>$binary_remote_addr</literal>. +задаваемый переменной <literal>$binary_remote_addr</literal>. Длина значения <literal>$binary_remote_addr</literal> равна 4 байтам для IPv4-адресов или 16 байтам для IPv6-адресов. При этом размер состояния всегда равен 32 или 64 байтам
--- a/xml/ru/docs/stream/ngx_stream_proxy_module.xml +++ b/xml/ru/docs/stream/ngx_stream_proxy_module.xml @@ -9,7 +9,7 @@ <module name="Модуль ngx_stream_proxy_module" link="/ru/docs/stream/ngx_stream_proxy_module.html" lang="ru" - rev="14"> + rev="15"> <section id="summary"> @@ -66,6 +66,7 @@ server { <para> Задаёт локальный IP-<value>адрес</value>, который будет использоваться в исходящих соединениях с проксируемым сервером. +В значении параметра допустимо использование переменных (1.11.2). Специальное значение <literal>off</literal> отменяет действие унаследованной с предыдущего уровня конфигурации директивы <literal>proxy_bind</literal>, позволяя системе
--- a/xml/ru/docs/stream/ngx_stream_upstream_module.xml +++ b/xml/ru/docs/stream/ngx_stream_upstream_module.xml @@ -9,7 +9,7 @@ <module name="Модуль ngx_stream_upstream_module" link="/ru/docs/stream/ngx_stream_upstream_module.html" lang="ru" - rev="13"> + rev="14"> <section id="summary"> @@ -385,9 +385,12 @@ SRV-записи с наивысшим приоритетом Задаёт метод балансировки нагрузки для группы, при котором соответствие клиента серверу определяется при помощи хэшированного значения <value>ключа</value>. -В настоящий момент единственно возможным значением для <literal>ключа</literal> -является удалённый адрес клиента, -указываемый как <literal>$remote_addr</literal>. +В качестве <value>ключа</value> может использоваться текст, переменные +и их комбинации (1.11.2). +Пример использования: +<example> +hash $remote_addr; +</example> Следует отметить, что любое добавление или удаление серверов в группе может привести к перераспределению большинства ключей на другие серверы. Метод совместим с библиотекой Perl