nginx

Модуль 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. При включённом рекурсивном поиске исходный адрес клиента, совпадающий с одним из доверенных адресов, заменяется на последний не доверенный адрес, переданный в заданном поле заголовка запроса.