← Все статьи

Nginx как reverse proxy: полный гайд

Зачем нужен reverse proxy

Reverse proxy — это сервер, который принимает входящие запросы клиентов и перенаправляет их на backend-сервисы. Nginx идеально подходит для этой роли: он обрабатывает десятки тысяч одновременных соединений с минимальным потреблением памяти, терминирует SSL, балансирует нагрузку и кэширует ответы.

Базовая конфигурация

# /etc/nginx/conf.d/app.conf
upstream backend {
    server 127.0.0.1:3000;
    server 127.0.0.1:3001;
}

server {
    listen 80;
    server_name app.example.com;

    location / {
        proxy_pass http://backend;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        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;
        proxy_cache_bypass $http_upgrade;
    }
}

Директива proxy_set_header важна: без неё backend-сервис не узнает реальный IP клиента и протокол (HTTP/HTTPS).

Терминация SSL

В продакшене SSL обязателен. Nginx может терминировать HTTPS и проксировать HTTP на backend:

server {
    listen 443 ssl http2;
    server_name app.example.com;

    ssl_certificate /etc/letsencrypt/live/app.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/app.example.com/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;

    location / {
        proxy_pass http://127.0.0.1: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 https;
    }
}

# Редирект HTTP -> HTTPS
server {
    listen 80;
    server_name app.example.com;
    return 301 https://$server_name$request_uri;
}

Балансировка нагрузки

Nginx поддерживает несколько алгоритмов балансировки:

# Round-robin (по умолчанию)
upstream backend {
    server 10.0.0.1:3000;
    server 10.0.0.2:3000;
}

# Weighted — пропорционально весу
upstream backend {
    server 10.0.0.1:3000 weight=3;
    server 10.0.0.2:3000 weight=1;
}

# Least connections — меньше всего соединений
upstream backend {
    least_conn;
    server 10.0.0.1:3000;
    server 10.0.0.2:3000;
}

# IP hash — привязка клиента к серверу
upstream backend {
    ip_hash;
    server 10.0.0.1:3000;
    server 10.0.0.2:3000;
}

Кэширование

# В контексте http
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;
        proxy_cache my_cache;
        proxy_cache_valid 200 302 10m;
        proxy_cache_valid 404 1m;
        proxy_cache_key "$scheme$request_method$host$request_uri";
        add_header X-Cache-Status $upstream_cache_status;
    }

    # Кэширование статических файлов
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        root /var/www/static;
        expires 30d;
        add_header Cache-Control "public, immutable";
    }
}

Заголовок X-Cache-Status покажет: HIT (из кэша), MISS (запрос к backend), EXPIRED (кэш истёк).

WebSocket proxy

location /ws {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 86400;
    proxy_send_timeout 86400;
}

Без правильных заголовков Upgrade и Connection WebSocket соединение не установится. Это самая частая ошибка при настройке.

Rate limiting

# Лимит: 10 запросов в секунду на IP
limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;

server {
    location /api/ {
        limit_req zone=api burst=20 nodelay;
        proxy_pass http://backend;
    }
}

Параметр burst=20 разрешает до 20 запросов превышения лимита без задержки. nodelay — не ставить в очередь, а сразу обрабатывать.

Блокировка по IP

location /admin {
    allow 10.0.0.0/8;
    allow 192.168.1.0/24;
    deny all;
    proxy_pass http://backend;
}

Вывод

Nginx как reverse proxy — это надежное и проверенное решение для маршрутизации трафика. Правильная настройка заголовков, кэширования и балансировки позволяет построить отказоустойчивую инфраструктуру. Регулярно проверяйте конфигурацию через nginx -t перед перезагрузкой.