VK Cloud

Nginx как обратный прокси: настройка, балансировка и SSL-терминация

16 ноября 2026 г.
Александр Иванов
Автор статьи
_blog_head_2.png

Бэкенд на Node.js слушает порт 3000, рядом Python-сервис на 8000, и оба надо выдать наружу по одному домену и по HTTPS. Задача решается одним Nginx перед приложениями: он принимает запросы клиентов и пересылает их на бэкенды. Ниже разберём, как настроить Nginx reverse proxy: от proxy_pass и заголовков до балансировки, SSL-терминации и кэша, с конфигами, которые можно переносить в продакшн.

Обратный прокси — сервер, который принимает запросы клиентов, пересылает их на внутренние бэкенды и отдаёт ответ от своего имени. Разница с прямым прокси в том, чью сторону он представляет: прямой прокси работает от имени клиента и прячет клиента от интернета, Nginx как обратный прокси работает от имени серверов и прячет серверную часть.

Путь запроса выглядит так: клиент обращается к одному домену и одному порту (80 или 443), Nginx принимает соединение, завершает TLS и по правилам маршрутизации передаёт запрос одному из приложений во внутренней сети — Node.js на порту 3000, Python на 8000, Java на 8080.

Что даёт такая схема:

  • единая точка входа: клиент не знает, сколько бэкендов за прокси и на каком стеке они написаны;
  • SSL-терминация: HTTPS обрабатывается на Nginx, приложения общаются с ним по HTTP;
  • балансировка нагрузки: запросы распределяются между несколькими инстансами одного сервиса;
  • кэширование: часть ответов Nginx отдаёт сам, не трогая бэкенд;
  • скрытие топологии: внутренние IP-адреса и порты приложений не видны снаружи.

Все директивы ниже относятся к модулям ngx_http_proxy_module и ngx_http_upstream_module, входящим в стандартную сборку Nginx.

Директива proxy_pass задаёт адрес проксируемого сервера и URI, на который сопоставляется запрос. Это основа любой конфигурации обратного прокси: без неё Nginx остаётся веб-сервером для статики.

Минимальный рабочий конфиг для приложения на локальном порту 3000:

server { listen 80; server_name example.com; location / { proxy_pass http://localhost:3000; } }

Такой конфиг уже проксирует трафик, но бэкенд получит искажённую картину запроса: исходный хост и IP клиента до него не дойдут.

Заголовки, которые нужно передать бэкенду

Директива proxy_set_header переопределяет и добавляет поля заголовка запроса к проксируемому серверу. По умолчанию Nginx передаёт Host со значением $proxy_host, то есть адрес из proxy_pass, а не домен, который запросил клиент.

location / { proxy_pass http://localhost:3000; proxy_set_header Host $host; 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; }

Что делает каждая строка:

  • Host передаёт исходное имя хоста; без него приложение увидит localhost и может собрать неправильные ссылки или не найти нужный виртуальный хост;
  • X-Real-IP отдаёт реальный адрес клиента, иначе в логах бэкенда будет только адрес Nginx;
  • X-Forwarded-For собирает цепочку адресов, если проксей несколько (например, CDN перед Nginx);
  • X-Forwarded-Proto сообщает протокол клиента, что критично для редиректов и генерации абсолютных URL.

Слеш в proxy_pass меняет путь запроса

Самая частая ошибка в nginx proxy_pass связана с завершающим слешем. Если в proxy_pass указан URI, часть запроса, совпавшая с location, заменяется на этот URI; если URI не указан, запрос уходит на бэкенд в том виде, в каком пришёл от клиента.

# Запрос /api/users уходит на http://backend/api/users location /api/ { proxy_pass http://backend; } # Запрос /api/users уходит на http://backend/users (префикс срезается) location /api/ { proxy_pass http://backend/; }

Правило простое: слеш нужен, когда бэкенд не знает о внешнем префиксе /api/ и ожидает путь от корня. Если приложение само маршрутизирует по /api/, слеш в proxy_pass не ставится.

Директива upstream описывает группу серверов, между которыми Nginx распределяет запросы. На имя этой группы ссылается proxy_pass, поэтому добавление ещё одного инстанса приложения не меняет остальную конфигурацию.

upstream backend_pool { server 10.0.0.1:3000; server 10.0.0.2:3000; server 10.0.0.3:3000; } server { listen 80; server_name example.com; location / { proxy_pass http://backend_pool; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }

По умолчанию в блоке upstream работает взвешенный round-robin: запросы идут по кругу с учётом весов серверов.

Round-robin (по умолчанию)

Подходит, когда серверы одинаковой мощности, а запросы примерно равной стоимости. Отдельная директива не нужна — это поведение Nginx по умолчанию.

Least connections (least_conn)

Подходит, когда время обработки запросов сильно различается. Метод least_conn отправляет запрос серверу с наименьшим числом активных соединений, учитывая веса.

upstream backend_pool { least_conn; server 10.0.0.1:3000; server 10.0.0.2:3000; }

IP hash (ip_hash)

Нужна привязка клиента к одному серверу. Метод ip_hash распределяет запросы по хэшу IP-адреса клиента, благодаря чему клиент попадает на один и тот же сервер, пока тот доступен.

upstream backend_pool { ip_hash; server 10.0.0.1:3000; server 10.0.0.2:3000; }

У ip_hash есть цена: клиенты за общим NAT попадут на один сервер, и распределение перестанет быть равномерным. Если приложение умеет хранить сессии во внешнем хранилище, лучше обойтись без привязки.

Weighted (weight=N)

Подходит для серверов разной мощности. Параметр weight задаёт пропорцию нагрузки: по умолчанию вес равен 1, и чем он больше, тем больше запросов получает сервер относительно соседей.

upstream backend_pool { server 10.0.0.1:3000 weight=3; server 10.0.0.2:3000 weight=1; }

В Nginx Open Source проверка живости пассивная: Nginx судит о сервере по результатам реальных запросов. Параметры max_fails и fail_timeout задают число неудачных попыток и время, в течение которого сервер считается недоступным после их превышения; параметр backup помечает сервер резервным, он принимает трафик только когда основные недоступны.

upstream backend_pool { server 10.0.0.1:3000 max_fails=3 fail_timeout=30s; server 10.0.0.2:3000 max_fails=3 fail_timeout=30s; server 10.0.0.3:3000 backup; }

Граница применимости у такой схемы жёсткая: активных health-check-запросов к отдельному URL в открытой версии нет, поэтому «подвисший, но отвечающий 200» бэкенд пассивные проверки не отловят. Для таких случаев нужен внешний мониторинг или коммерческая сборка.

SSL-терминация означает, что HTTPS завершается на Nginx, а дальше во внутренней сети запрос идёт по HTTP. Сертификаты хранятся и обновляются в одном месте, приложения не занимаются TLS.

server { listen 443 ssl; server_name example.com; ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers HIGH:!aNULL:!MD5; location / { proxy_pass http://backend_pool; proxy_set_header Host $host; 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 https; } } # Редирект HTTP на HTTPS server { listen 80; server_name example.com; return 301 https://$host$request_uri; }

Заголовок X-Forwarded-Proto https здесь задан константой: за прокси приложение не видит исходную схему и без подсказки начнёт выдавать редиректы и абсолютные ссылки на http://. Фреймворки вроде Django, Flask, Rails и Laravel читают именно этот заголовок.

Важно знать

Список протоколов в примере ограничен TLS 1.2 и 1.3 не случайно: PCI DSS v4.0.1, обязательный к исполнению с 31 марта 2025 года, требует для передачи данных держателей карт TLS 1.2 или выше и запрещает SSL и ранние версии TLS как средство защиты. Даже вне платёжного контура это разумная база.

Nginx умеет складывать ответы бэкенда на диск и отдавать их сам. Для редко меняющегося контента это снимает с приложения основную часть нагрузки.

Директива proxy_cache_path задаёт путь к кэшу, зону разделяемой памяти для метаданных (keys_zone), максимальный размер данных на диске (max_size) и время, после которого невостребованные записи удаляются (inactive).

# В секции http {} файла nginx.conf proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off; server { # ... location / { proxy_pass http://backend_pool; proxy_cache my_cache; proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m; add_header X-Cache-Status $upstream_cache_status; } }

Разбор параметров:

  • keys_zone=my_cache:10m — зона в разделяемой памяти под метаданные кэша;
  • max_size=1g — предел объёма кэша на диске;
  • inactive=60m — запись удаляется, если к ней не обращались час;
  • proxy_cache_valid 200 302 10m задаёт время жизни кэша по кодам ответа;
  • X-Cache-Status выводит в ответ значение переменной $upstream_cache_status, которая принимает значения MISS, HIT, EXPIRED, STALE, UPDATING, REVALIDATED и BYPASS.

Заголовок с $upstream_cache_status удобно держать включённым во время отладки: по нему сразу видно, работает ли кэш и какие запросы его обходят. Персонализированные страницы и ответы с куками из кэша стоит исключать, иначе один пользователь получит страницу другого.

Nginx перед Node.js-приложением

upstream nodejs_app { server 127.0.0.1:3000; } server { listen 80; server_name myapp.example.com; location / { proxy_pass http://nodejs_app; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection 'upgrade'; proxy_set_header Host $host; proxy_cache_bypass $http_upgrade; } }

Для соединений с проксируемым сервером Nginx по умолчанию использует HTTP/1.0 и не передаёт заголовки Upgrade и Connection, поэтому для WebSocket нужны proxy_http_version 1.1 и явная передача этих заголовков. Без них Socket.io и библиотека ws будут бесконечно падать в polling или получать ошибку апгрейда.

Nginx перед несколькими микросервисами

upstream users_service { server 10.0.0.1:8001; } upstream orders_service { server 10.0.0.2:8002; } upstream catalog_service { server 10.0.0.3:8003; } server { listen 80; server_name api.example.com; location /api/users/ { proxy_pass http://users_service/; } location /api/orders/ { proxy_pass http://orders_service/; } location /api/catalog/ { proxy_pass http://catalog_service/; } }

Один Nginx принимает весь трафик к api.example.com и раздаёт его по path-префиксу: типичный паттерн API Gateway. Обратите внимание на слеш в конце каждого proxy_pass: сервисы получают пути без внешнего префикса, то есть /api/users/42 придёт в сервис как /42.

ОшибкаПричинаЧто делать
502 Bad GatewayNginx не смог соединиться с бэкендомПроверить, что процесс приложения запущен и слушает нужный адрес; сверить IP и порт в *proxy_pass*
504 Gateway TimeoutБэкенд отвечает дольше *proxy_read_timeout*Увеличить *proxy_read_timeout* и *proxy_connect_timeout* либо ускорить сам обработчик
В логах бэкенда адрес Nginx вместо клиентскогоНе переданы заголовкиДобавить *proxy_set_header X-Real-IP $remote_addr*
Редиректы приложения ломают URLБэкенд редиректит на внутренний адрес или на httpПередать *X-Forwarded-Proto* и при необходимости настроить *proxy_redirect*
WebSocket не поднимаетсяНет апгрейда протоколаДобавить *proxy_http_version 1.1* и заголовки *Upgrade*/*Connection*

Таймауты proxy_connect_timeout, proxy_send_timeout и proxy_read_timeout по умолчанию равны 60 секундам каждый и отвечают соответственно за установление соединения, паузу между операциями записи и паузу между операциями чтения ответа. Для долгих отчётов их поднимают, для быстрых API-эндпоинтов, наоборот, снижают, чтобы зависший бэкенд не держал соединения.

location / { proxy_pass http://backend; proxy_connect_timeout 10s; proxy_send_timeout 30s; proxy_read_timeout 30s; }

После каждой правки конфигурации проверяйте синтаксис командой nginx -t и применяйте изменения через systemctl reload nginx: перезагрузка не рвёт установленные соединения.


Частые вопросы про Nginx как обратный прокси

Чем обратный прокси отличается от балансировщика нагрузки?

Балансировщик нагрузки — частный случай обратного прокси. Nginx в роли обратного прокси и маршрутизирует запросы по путям и доменам, и распределяет их между инстансами через upstream, и терминирует TLS, и кэширует ответы. Отдельный специализированный балансировщик оправдан при очень высоких нагрузках или сложных правилах маршрутизации по заголовкам и метаданным.

Nginx или Apache в роли обратного прокси?

Для задач проксирования и балансировки Nginx остаётся отраслевым стандартом: его асинхронная событийная модель рассчитана на удержание большого числа одновременных соединений при небольшом расходе памяти. Apache с mod_proxy справляется с той же задачей, но под высокой конкурентной нагрузкой проигрывает в расходе ресурсов.

Как это выглядит в Kubernetes?

В кластере роль обратного прокси играет ingress-контроллер: он принимает внешний трафик и направляет его к сервисам по правилам ресурса Ingress, а конфигурация описывается манифестами, а не файлом nginx.conf. Важная деталь для новых кластеров: репозиторий ingress-nginx переведён в режим «только чтение» 24 марта 2026 года, последние патч-релизы 1.13.9, 1.14.5 и 1.15.1 вышли 19 марта 2026 года, новых исправлений, включая патчи безопасности, не будет. Для миграции на Gateway API выпущен инструмент ingress2gateway 1.0, который понимает более 30 распространённых аннотаций ingress-nginx, в том числе CORS, backend TLS, regex-матчинг и rewrite пути. На отдельной виртуальной машине вне кластера обычный Nginx с proxy_pass и upstream этой истории не касается.

Нужно ли открывать порты бэкендов наружу?

Нет, и это одно из преимуществ схемы. Приложения слушают внутренние адреса и порты (3000, 8000, 8080), наружу открыты только 80 и 443 на машине с Nginx. В VK Cloud доступ по портам настраивается группами безопасности: входящий трафик на 80 и 443 разрешается только для инстанса с Nginx, а бэкенды принимают соединения исключительно из внутренней сети.

Минимальный продакшн-набор обратного прокси умещается в четыре вещи: proxy_pass с правильным слешем, набор proxy_set_header, блок upstream с выбранным алгоритмом балансировки и явные таймауты. Если приложение одно и трафик небольшой, хватит первых двух пунктов. Если инстансов несколько, подключается upstream с подходящим методом и пассивными проверками. SSL-терминация и кэш добавляются поверх, когда базовая схема уже отвечает.

Следующий шаг: собрать конфиг на тестовой машине, проверить nginx -t, прогнать нагрузку и посмотреть на X-Cache-Status и коды ответа. Расхождение с ожиданиями всплывает в первые же минуты.

Развернуть такую схему можно на Cloud Servers в VK Cloud: 4 геозоны, безлимитный трафик на скорости 1 Гбит/с, бесплатные внешние IP-адреса, программная СХД с тройной репликацией, масштабирование без остановки виртуальной машины и управление через Terraform-провайдер, CLI и API. Платформа работает с SLA 99,95% и поддержкой 24/7 на русском языке.

Оставьте заявку, чтобы получить консультацию

Наши специалисты свяжутся с вами в ближайшее время и ответят на все вопросы.

            Узнавайте о выходе новых статей в блоге первыми!

            Будем держать в курсе новостей и облачных трендов

            section-subscribe_2x.png
              section-subscribe_2x.png
              Теги: Nginx, обратный прокси, балансировка нагрузки, SSL-терминация, VK Cloud
              Ссылка скопирована
              Поделиться

              Почитать по теме

              _blog_head_19.png
              18 ноября

              Установка WordPress на облачный сервер: настройка LAMP с нуля

              _blog_head_20.png
              10 сентября

              Git rebase vs merge: в чём разница и когда что использовать

              40+ готовых сервисов