Nginx proxy_protocol: IP клиента от балансировщика
PROXY protocol — короткий заголовок, который балансировщик отправляет перед HTTP-запросом, чтобы передать настоящий IP клиента. Nginx принимает его директивой proxy_protocol на listen и подставляет адрес через real_ip_header proxy_protocol. Включайте его только на доверенном listener: клиент, который умеет отправить такой заголовок, иначе подделает IP.
Принять PROXY protocol от балансировщика
server {
listen 80 proxy_protocol;
set_real_ip_from 10.0.0.0/8;
real_ip_header proxy_protocol;
location / {
proxy_pass http://backend;
proxy_set_header X-Real-IP $remote_addr;
}
}listen 80 proxy_protocol означает, что Nginx ожидает заголовок в начале каждого соединения. Если клиент подключится напрямую без него, соединение не будет обработано как обычный HTTP. Поэтому такой порт открывают только для балансировщика или слушают два порта: обычный для прямых клиентов и proxy_protocol для доверенной сети.
set_real_ip_from перечисляет CIDR балансировщика, а real_ip_header proxy_protocol говорит модулю realip взять адрес из PROXY-заголовка. После этого $remote_addr содержит клиентский IP, а $proxy_protocol_addr — исходное значение из заголовка. Для TLS-терминации на балансировщике используйте HTTP-listener, для TCP-passthrough — listen 443 ssl proxy_protocol.
Проверьте, что healthcheck балансировщика тоже умеет PROXY protocol, иначе Nginx будет отвечать ошибкой. Для AWS NLB, HAProxy и Envoy включите соответствующую опцию на backend pool. proxy_protocol_timeout ограничивает ожидание заголовка.
Не доверяйте PROXY protocol из интернета и не включайте его на публичном порту без фильтрации. Для обычных прокси с X-Forwarded-For используйте real_ip_header X-Forwarded-For и real_ip_recursive on; это другой механизм.
Документация: ngx_http_core_module: proxy_protocol, ngx_http_realip_module.