Модуль ngx_http_realip

Модуль ngx_http_realip_module

english
русский

简体中文
עברית
日本語
türkçe

новости [en]
об nginx
скачать
безопасность [en]
pgp ключи [en]
документация
faq
ссылки [en]
книги [en]
поддержка
пожертвования [en]

trac
wiki
twitter
nginx.com

Пример конфигурации
Директивы
     set_real_ip_from
     real_ip_header
     real_ip_recursive

Модуль ngx_http_realip_module позволяет менять адрес клиента на переданный в указанном поле заголовка.

По умолчанию этот модуль не собирается, его сборку необходимо разрешить с помощью конфигурационного параметра --with-http_realip_module.

Пример конфигурации

set_real_ip_from  192.168.1.0/24;
set_real_ip_from  192.168.2.1;
set_real_ip_from  2001:0db8::/32;
real_ip_header    X-Forwarded-For;
real_ip_recursive on;

Директивы

синтаксис:	`set_real_ip_from адрес \| CIDR \| unix:;`
умолчание:	—
контекст:	`http`, `server`, `location`

Задаёт доверенные адреса, которые передают верный адрес для замены. Если указано специальное значение unix:, доверенными будут считаться все UNIX-сокеты.

IPv6-адреса поддерживаются начиная с версий 1.3.0 и 1.2.1.

синтаксис:	`real_ip_header поле \| X-Real-IP \| X-Forwarded-For;`
умолчание:	real_ip_header X-Real-IP;
контекст:	`http`, `server`, `location`

Задаёт поле заголовка запроса, в котором передаётся адрес для замены.

синтаксис:	`real_ip_recursive on \| off;`
умолчание:	real_ip_recursive off;
контекст:	`http`, `server`, `location`

Эта директива появилась в версиях 1.3.0 и 1.2.1.

При выключенном рекурсивном поиске исходный адрес клиента, совпадающий с одним из доверенных адресов, заменяется на последний адрес, переданный в поле заголовка запроса, заданного директивой real_ip_header. При включённом рекурсивном поиске исходный адрес клиента, совпадающий с одним из доверенных адресов, заменяется на последний не доверенный адрес, переданный в заданном поле заголовка запроса.