Сравните адрес TCP-соседа и выбранный IP клиента на каждом переходе: Cloudflare, nginx, внутренний прокси, приложение. Заголовок с IP становится основанием для доверия только там, где известен отправивший его прокси. Простая подстановка любого CF-Connecting-IP в REMOTE_ADDR допускает подмену при прямом запросе к origin.
Какой адрес видит каждый участник
Cloudflare работает обратным прокси: origin обычно видит соединение от его сети. Для исходного IP посетителя Cloudflare передаёт CF-Connecting-IP. Документация restoring original visitor IPs проверена 25 октября 2026 года. Если до приложения есть ещё балансировщик, нужно разобрать и этот переход, а не считать заголовок достоверным по одному названию.
| Точка | Что сопоставить |
|---|---|
| Внешний вход nginx | Адрес непосредственного соседа |
| realip nginx | Разрешённый источник заменяющего заголовка |
| Внутренний proxy | Какие поля он удаляет и формирует заново |
| Backend | Список доверенных прокси приложения |
| Прямой запрос | Игнорирование подставленного IP |
Сначала нарисуйте фактическую схему. Настройка для Cloudflare → nginx отличается от Cloudflare → балансировщик → nginx. Во втором случае непосредственный сосед nginx — балансировщик. Политика доверия должна охватывать подтверждённую цепочку и правила перезаписи заголовков, а не случайный список внешних подсетей.
Доверенный источник ограничивается явно
# Учебный фрагмент nginx, не готовый список Cloudflare
# 192.0.2.10 — условный доверенный прокси
set_real_ip_from 192.0.2.10;
real_ip_header CF-Connecting-IP;
# Настоящие адреса определяются фактической цепочкойВ nginx set_real_ip_from задаёт источники, которым доверяют заменяющий адрес; real_ip_header выбирает поле. Модуль realip должен присутствовать в сборке. Переменная realip_remote_addr сохраняет исходный адрес соединения до замены. Эти свойства сверены по документации nginx 25 октября 2026 года; фрагмент показывает принцип на вымышленном адресе.
Для прямого подключения Cloudflare используйте актуальные официальные диапазоны и поддерживайте их обновление. Не ставьте 0.0.0.0/0 вместо списка доверенных прокси: это меняет смысл проверки. Для локального балансировщика ограничьте доступ к нему и задайте, какие входные заголовки он заменяет перед передачей дальше.
Backend может иметь собственную настройку trusted proxies. Если nginx уже выбрал адрес, а приложение заново разбирает произвольный X-Forwarded-For, вы получите другую идентичность на последнем шаге. Назначьте один понятный контракт передачи и проверьте, что прямой клиент не может управлять результатом.
Два маршрута и попытка подмены
- В разрешённом тестовом окружении отправить запрос через обычный прокси.
- Сопоставить адрес соседа и итоговый адрес в приложении.
- Отправить разрешённый прямой запрос с искусственным IP в заголовке.
- Убедиться, что недоверенный заголовок не определяет клиента.
- Повторить после внутреннего балансировщика и для используемого IPv6-маршрута.
Если прямой доступ к origin закрыт, не открывайте его всему интернету ради проверки. Используйте изолированный стенд или уже разрешённый диагностический маршрут. Проверяется конкретное правило доверия; временная отмена сетевой защиты способна добавить новую проблему вместо объяснения старой.
IP не является надёжным идентификатором человека: несколько пользователей могут выходить через один адрес. После исправления real IP пересмотрите последствия для журналов и ограничений скорости. Не заменяйте проверку сессии или роли сравнением адреса, который теперь стал выглядеть правдоподобнее.
Для сопровождения сохраните схему переходов, обезличенные значения до и после замены и источник списка доверенных сетей. Удалите временный расширенный лог после проверки. Исправление подтверждено, когда обычный маршрут передаёт ожидаемый адрес, а прямой запрос не может назначить себе другой IP одним заголовком.