Настройка PROXY Protocol в nginx на личном VPS (2026)

Чтобы принимать реальные IP‑адреса клиентов через прокси или балансировщик на вашем личном VPS SANSARA, включите поддержку PROXY Protocol в nginx. Это позволит правильно логировать IP, применять ограничения по IP и использовать гео‑базы. После регистрации в кабинете SANSARA вы получите данные подключения к личному серверу и сможете импортировать их в клиент на iPhone, Android, Windows или macOS без терминала.

Коротко:

• PROXY Protocol передаёт реальный IP клиента через прокси‑сервер или балансировщик нагрузки.
• Настройка делается в конфигурации nginx на вашем личном VPS SANSARA.
• Вы получаете выделенный узел в одной из 9+ локаций и можете подключиться с iPhone, Android, Windows, macOS.
• Telegram‑бот SANSARA помогает управлять подключением и получать уведомления.

Что это и кому подходит

PROXY Protocol — это способ передачи информации о клиенте (например, исходного IP‑адреса) через промежуточный сервер, который сам принимает соединения. Если вы используете прокси‑сервер, балансировщик нагрузки или CDN перед вашим личным VPS, то без PROXY Protocol nginx будет видеть только IP балансировщика, а не реального пользователя.

Этот подход подходит:

• Если вы размещаете сайт или веб‑приложение за балансировщиком нагрузки или CDN.
• Если вы используете прокси‑серверы перед вашим личным сервером для маршрутизации трафика.
• Когда вам нужны точные логи по IP, ограничения по IP или геолокация на уровне приложения.

В SANSARA вы получаете личный VPS с готовым подключением: регистрируетесь, получаете данные в кабинете и импортируете их в клиент на своём устройстве. Сервер работает в одной из 9+ стран, и вы можете использовать его как защищённый шлюз для ваших приложений.

Как настроить по шагам (с личным VPS SANSARA)

Настройка PROXY Protocol в nginx состоит из двух частей: включения поддержки на стороне nginx и настройки прокси‑сервера или балансировщика на передачу заголовков.

Шаг 1. Проверьте поддержку PROXY Protocol в nginx

На вашем личном VPS SANSARA откройте терминал (если у вас есть доступ по SSH) и выполните:

`bash nginx -V 2>&1 | grep -o with-http_proxy_protocol_module `

Если команда выводит with-http_proxy_protocol_module, значит модуль уже собран. Если нет — потребуется пересборка nginx с этим модулем или установка версии, которая его включает.

Шаг 2. Настройте listen-директиву для PROXY Protocol

В конфигурации вашего сайта (обычно в файле типа /etc/nginx/sites-available/example.com) измените блок server:

`nginx server { listen 80 proxy_protocol; listen 443 ssl proxy_protocol;

set_real_ip_from 192.0.2.1; # IP вашего балансировщика или прокси real_ip_header proxy_protocol; } `

• listen ... proxy_protocol указывает nginx принимать соединения с PROXY Protocol.
• set_real_ip_from задаёт доверенный IP балансировщика или прокси.
• real_ip_header proxy_protocol говорит nginx брать реальный IP из PROXY Protocol.

Шаг 3. Настройте прокси или балансировщик на передачу PROXY Protocol

Если вы используете HAProxy перед nginx, в секции backend добавьте строку send-proxy:

`haproxy backend nginx_backend server nginx1 192.0.2.10:80 send-proxy `

Для других прокси (например, Envoy, Traefik) настройка аналогична: включается опция отправки PROXY Protocol на бэкенд.

Шаг 4. Проверьте логи

Перезагрузите nginx:

`bash sudo systemctl reload nginx `

Проверьте логи доступа (например, /var/log/nginx/access.log). Вместо IP балансировщика должен отображаться реальный IP клиента.

Шаг 5. Используйте кабинет SANSARA для управления сервером

В кабинете SANSARA вы можете:

• Посмотреть статус вашего личного VPS.
• Переустановить ОС или изменить конфигурацию, если потребуется пересобрать nginx.
• Получить данные для подключения к вашему выделенному узлу.

Telegram‑бот SANSARA уведомляет о событиях на сервере и помогает быстро получить доступ к кабинету.

Устройства: iPhone, Android, Windows, macOS

Хотя настройка PROXY Protocol выполняется на стороне сервера, вы можете управлять своим личным VPS SANSARA и подключаться к нему с любых устройств:

• iPhone / Android: установите клиент, поддерживающий импорт конфигураций. В кабинете SANSARA скачайте файл конфигурации и откройте его в приложении — подключение настроится автоматически.
• Windows / macOS: используйте десктопный клиент. Импортируйте конфигурацию из кабинета SANSARA, и защищённый канал к вашему личному серверу будет готов.

Вам не нужен терминал на клиентском устройстве: вся работа с nginx и PROXY Protocol выполняется на вашем выделенном узле.

Частые ошибки и как их избежать

1. 01Nginx не принимает соединения после включения proxy_protocol

Проверьте, что балансировщик или прокси действительно отправляет PROXY Protocol. Если они работают в обычном режиме (без PROXY), nginx будет отвергать соединения. Убедитесь, что на стороне прокси включена отправка PROXY‑заголовков.

1. 01В логах всё равно отображается IP балансировщика

Убедитесь, что:

• В listen указано proxy_protocol.
• real_ip_header установлен в proxy_protocol.
• IP балансировщика указан в set_real_ip_from.
• Вы перезагрузили nginx после изменений.

1. 01Ошибка при перезагрузке nginx из‑за неизвестной директивы

Если модуль PROXY Protocol не собран в вашей версии nginx, директивы proxy_protocol и real_ip_header вызовут ошибку. Установите версию nginx с поддержкой этого модуля или соберите её самостоятельно.

1. 01Проблемы с HTTPS при использовании PROXY Protocol

Убедитесь, что SSL‑сертификаты настроены корректно и listen 443 ssl proxy_protocol указан правильно. Проверьте, что балансировщик не обрывает SSL‑соединение раньше, чем нужно.

1. 01Неверный порядок директив в конфиге

Директивы set_real_ip_from и real_ip_header должны находиться на уровне server или http, а не внутри location, если вы хотите применять их глобально.

FAQ

Итог

• Включите listen ... proxy_protocol и настройте real_ip_header proxy_protocol в nginx на вашем личном VPS SANSARA.
• Убедитесь, что прокси или балансировщик перед сервером отправляет PROXY Protocol.
• Проверьте логи, чтобы реальные IP клиентов отображались корректно.
• Используйте кабинет SANSARA для управления сервером и импортируйте конфигурацию на iPhone, Android, Windows или macOS без терминала.
• При ошибках проверяйте поддержку модуля в nginx и правильность IP балансировщика в set_real_ip_from.