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

Бэкенд на 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 читают именно этот заголовок.
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 Gateway | Nginx не смог соединиться с бэкендом | Проверить, что процесс приложения запущен и слушает нужный адрес; сверить 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 на русском языке.
Оставьте заявку, чтобы получить консультацию
Наши специалисты свяжутся с вами в ближайшее время и ответят на все вопросы.
Узнавайте о выходе новых статей в блоге первыми!
Будем держать в курсе новостей и облачных трендов


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

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

Как работает git reset: разница между soft, mixed и hard

