Svyaz

14.07.2026

proxy protocol nginx

Svyaz VPN — свобода без границ

Настройка Proxy Protocol на NGINX: Полное руководство

Если вы являетесь администратором веб-сервера или разработчиком, вы, скорее всего, услышали о Proxy Protocol — протоколе, который позволяет серверам обмениваться информацией о подключающихся клиентах. В этой статье мы рассмотрим, как настроить Proxy Protocol на NGINX, популярном веб-сервере, используемом в масштабах всего мира.

Личность Proxy Protocol

Proxy Protocol — это открытый протокол, разработанный HAProxy в сотрудничестве с Red Hat. Он позволяет серверам обмениваться информацией о подключающихся клиентах, включая IP-адреса, порты и другие параметры подключения. Это может быть полезно для различных целей, таких как анализация трафика, авторизация и аутентификация.

Настройка Proxy Protocol на NGINX

Настройка Proxy Protocol на NGINX относительно проста. Начнем с создания конфигурационного файла NGINX, где мы включим поддержку Proxy Protocol:

http {
    ...
    upstream backend {
        server localhost:8080;
    }
    server {
        listen 80;
        proxy_pass http://backend;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_protocol on;
    }
}

В этом примере мы включаем поддержку Proxy Protocol на сервере NGINX, используя директиву proxy_protocol on. Мы также настраиваем Proxy Protocol для передачи IP-адреса клиента на сервере backend.

Правила включения Proxy Protocol

Когда вы включаете Proxy Protocol на NGINX, сервер ожидает команды от клиента с использованием протокола Proxy. Если клиент не поддерживает Proxy Protocol, сервер NGINX может работать в режиме "fallback" и использовать другой протокол для связи с клиентом.

Заключение

Настройка Proxy Protocol на NGINX — простая и эффективная возможность для серверов, позволяющая обмениваться информацией о подключающихся клиентах. В этой статье мы рассмотрели основные аспекты настройки Proxy Protocol на NGINX и предоставили пример конфигурационного файла, где включена поддержка этого протокола.

Советы и рекомендации

  • Если вы используете NGINX в Production, убедитесь, что включена поддержка Proxy Protocol, чтобы избежать ошибок связи с клиентами.
  • Используйте директиву proxy_protocol on для включения поддержки Proxy Protocol на сервере NGINX.
  • Настройте Proxy Protocol для передачи IP-адреса клиента на сервере backend.

Дополнительные ресурсы

  • Документация NGINX по Proxy Protocol
  • Руководство по Proxy Protocol на HAProxy

Анализ sniff

  • Тема: proxy protocol nginx