Nginx reverse proxy — самый распространённый способ выпустить в интернет приложение, которое слушает локальный порт: Node.js, Python, Java, Docker-контейнер или что угодно ещё. Обратный прокси принимает запросы на 80 и 443 порту, а затем передаёт их приложению, добавляя по пути HTTPS, кэширование, сжатие и защиту. В этой статье разберём настройку nginx в роли reverse proxy с нуля: от минимального конфига до заголовков, WebSocket и тонкой настройки таймаутов. Все команды проверены на Ubuntu 22.04/24.04 и подойдут для любого VPS с root-доступом.
Что такое обратный прокси и зачем он нужен
Обычный (forward) прокси стоит на стороне клиента и ходит в интернет от его имени. Обратный прокси — наоборот: он стоит на стороне сервера, принимает входящие запросы и решает, какому внутреннему приложению их отдать. Клиент при этом видит только nginx и не знает, что за ним работает.
Что это даёт на практике:
- Единая точка входа. Все приложения доступны через 80/443 порт, наружу не нужно открывать порты 3000, 8080 и прочие.
- HTTPS в одном месте. Сертификат ставится на nginx, а приложения продолжают работать по обычному HTTP внутри сервера.
- Несколько сервисов на одном IP. Nginx разбирает запросы по доменам (
server_name) и маршрутизирует каждый на свой бэкенд. - Буферизация и защита. Медленные клиенты общаются с nginx, а не держат воркеры приложения; сюда же легко добавить лимиты запросов.
- Кэш и статика. Nginx отдаёт файлы и кэшированные ответы сам, разгружая бэкенд.
Установка Nginx
Если nginx ещё не стоит, установка занимает минуту. Подробный разбор со всеми нюансами есть в статье установка Nginx на Ubuntu, здесь — короткая версия:
# Обновляем индекс пакетов и ставим nginx
sudo apt update && sudo apt install -y nginx
# Включаем автозапуск и проверяем статус
sudo systemctl enable --now nginx
systemctl status nginx --no-pager
Откройте порты в файрволе, если используете ufw:
# Разрешаем HTTP и HTTPS
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw status
Для теста нам нужно какое-нибудь приложение на локальном порту. Возьмём простейший HTTP-сервер на Python — в реальности на его месте будет ваш бэкенд:
# Тестовый бэкенд на 127.0.0.1:3000 (запустите в отдельной сессии или через nohup)
python3 -m http.server 3000 --bind 127.0.0.1
Обратите внимание на --bind 127.0.0.1: приложение за прокси должно слушать только localhost, чтобы к нему нельзя было обратиться напрямую в обход nginx.
Минимальная конфигурация reverse proxy
Создаём отдельный файл конфигурации для сайта:
sudo nano /etc/nginx/sites-available/app.example.com
Минимальный рабочий конфиг выглядит так:
server {
listen 80;
server_name app.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
}
}
Директива proxy_pass — сердце всей схемы: она говорит nginx, куда пересылать запрос. Активируем конфиг и перечитываем nginx:
# Включаем сайт симлинком и проверяем синтаксис
sudo ln -s /etc/nginx/sites-available/app.example.com /etc/nginx/sites-enabled/
sudo nginx -t
# Если "syntax is ok" — применяем без разрыва соединений
sudo systemctl reload nginx
Теперь запрос на http://app.example.com уходит приложению на порт 3000. Уже работает, но в таком виде бэкенд не знает ни реального IP посетителя, ни исходного домена — исправим это.
Проброс заголовков: X-Forwarded-For и другие
Без дополнительных заголовков приложение видит все запросы как пришедшие с 127.0.0.1. Расширенный блок location решает проблему:
server {
listen 80;
server_name app.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
# Версия протокола и keep-alive к бэкенду
proxy_http_version 1.1;
proxy_set_header Connection "";
# Передаём бэкенду реальные данные запроса
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 | $host | Бэкенд узнаёт исходный домен — важно для редиректов и мультисайтовости |
X-Real-IP | $remote_addr | Реальный IP клиента для логов и rate-limit на стороне приложения |
X-Forwarded-For | $proxy_add_x_forwarded_for | Цепочка IP, если прокси несколько |
X-Forwarded-Proto | $scheme | Приложение понимает, что снаружи был HTTPS, и не зацикливает редиректы |
На стороне приложения нужно включить доверие к прокси: в Express это app.set('trust proxy', 1), в Django — SECURE_PROXY_SSL_HEADER, в Rails — config.action_dispatch.trusted_proxies.
Проксирование WebSocket
WebSocket начинается с HTTP-запроса Upgrade, и по умолчанию nginx его не пропускает. Для чатов, живых дашбордов и hot-reload в дев-режиме добавьте в location:
location /ws/ {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
# WebSocket-соединения живут долго — поднимаем таймаут чтения
proxy_read_timeout 3600s;
}
Без proxy_read_timeout nginx разорвёт молчащее соединение через 60 секунд — классическая причина «отваливающихся» вебсокетов.
Несколько приложений на одном сервере
Обратный прокси раскрывается по-настоящему, когда приложений больше одного. Два подхода:
По доменам — на каждый сервис свой server-блок со своим server_name:
server {
listen 80;
server_name api.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
}
}
server {
listen 80;
server_name admin.example.com;
location / {
proxy_pass http://127.0.0.1:4000;
}
}
По путям — один домен, разные location:
server {
listen 80;
server_name example.com;
location /api/ {
# Слэш в конце proxy_pass отрезает /api/ из пути запроса
proxy_pass http://127.0.0.1:3000/;
}
location / {
proxy_pass http://127.0.0.1:4000;
}
}
Важный нюанс: proxy_pass http://127.0.0.1:3000/; со слэшем на конце заменяет /api/что-то на /что-то, а без слэша путь передаётся как есть. Это самая частая ошибка при маршрутизации по путям. Больше сценариев — в статье про несколько сайтов на одном VPS, а типовую связку с Node.js мы разбирали в материале про Node.js-приложение на VPS.
HTTPS для прокси
Схема стандартная: HTTPS терминируется на nginx, к бэкенду трафик идёт по HTTP внутри localhost. Certbot сделает всё сам, включая правку конфига и автопродление:
# Ставим certbot и получаем сертификат для домена
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d app.example.com --redirect
Флаг --redirect добавит автоматический переход с HTTP на HTTPS. Подробности, wildcard-сертификаты и ручной режим — в отдельном руководстве по SSL-сертификату Let's Encrypt.
Таймауты, буферы и кэширование
Дефолтные значения nginx подходят не всем: долгие API-запросы обрываются, а большие ответы пишутся во временные файлы. Ключевые директивы:
location / {
proxy_pass http://127.0.0.1:3000;
# Таймауты: соединение с бэкендом, отправка, ожидание ответа
proxy_connect_timeout 5s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
# Буферы ответа бэкенда
proxy_buffers 8 16k;
proxy_buffer_size 16k;
# Ограничение размера тела запроса (загрузка файлов)
client_max_body_size 50m;
}
Для тяжёлых, но редко меняющихся ответов (страницы каталога, публичное API) включите микрокэширование:
# В блоке http (например, /etc/nginx/conf.d/proxy-cache.conf)
proxy_cache_path /var/cache/nginx/app levels=1:2 keys_zone=appcache:10m
max_size=512m inactive=10m use_temp_path=off;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_cache appcache;
proxy_cache_valid 200 10s;
proxy_cache_use_stale error timeout updating;
add_header X-Cache-Status $upstream_cache_status;
}
Даже кэш на 10 секунд снимает с бэкенда практически всю нагрузку при наплыве трафика: nginx отвечает из памяти, а приложение видит один запрос в 10 секунд вместо сотен. Остальные приёмы разгона — worker_connections, gzip, keep-alive — собраны в статье про оптимизацию Nginx под нагрузку.
Частые вопросы
Чем reverse proxy отличается от обычного прокси?
Forward-прокси работает на стороне клиента и скрывает клиента от сервера. Reverse proxy работает на стороне сервера и скрывает внутреннюю инфраструктуру от клиента. С точки зрения посетителя nginx-прокси — это и есть сайт, он не видит, что за ним стоят другие приложения.
Почему приложение видит IP 127.0.0.1 вместо адреса посетителя?
Потому что TCP-соединение к бэкенду устанавливает nginx со своего локального адреса. Реальный IP передаётся в заголовках X-Real-IP и X-Forwarded-For — их нужно явно прописать через proxy_set_header, а в приложении включить доверие к прокси, иначе фреймворк продолжит брать адрес из соединения.
Нужно ли открывать порт приложения наружу?
Нет, и не стоит: пусть бэкенд слушает только 127.0.0.1, а наружу смотрят лишь 80 и 443 порты nginx. Так приложение нельзя дёрнуть в обход прокси со всеми его лимитами, HTTPS и логами. Если бэкенд в Docker, публикуйте порт как 127.0.0.1:3000:3000, а не 3000:3000.
Что делать при ошибке 502 Bad Gateway?
502 означает, что nginx не смог достучаться до бэкенда. Проверьте, что приложение запущено (ss -tlnp | grep 3000), что адрес и порт в proxy_pass совпадают с реальными, и загляните в /var/log/nginx/error.log — там будет точная причина: connection refused, таймаут или слишком большой заголовок ответа.
Подойдёт ли для reverse proxy недорогой VPS?
Да, nginx крайне экономен: тысячи запросов в секунду обходятся ему в доли ядра и десятки мегабайт памяти. Ресурсы сервера в основном потребляет само проксируемое приложение, поэтому размер VPS выбирайте под бэкенд, а не под nginx.
Вместо заключения
Обратный прокси на nginx — навык, который пригодится в каждом проекте: один раз настроив связку proxy_pass + заголовки + HTTPS, вы сможете выпускать в интернет любое приложение за пять минут. Для такой схемы отлично подходит тариф Start от Cheap-Host — 450 ₽/мес за 6 vCPU, 8 ГБ RAM и 96 ГБ NVMe на KVM-виртуализации в Москве: этого с запасом хватит и на nginx, и на пару бэкендов рядом. Сервер выдаётся за 45–60 секунд — заказать VPS можно здесь.