nginx как reverse proxy для Django: полная настройка

Схема работы

nginx принимает запросы снаружи и проксирует их на uvicorn/gunicorn, который слушает на localhost. Статику и медиафайлы nginx отдаёт сам — это быстрее.

Базовый конфиг

upstream django {
    server 127.0.0.1:8000;
}

server {
    listen 80;
    server_name example.com;

    location /static/ {
        alias /srv/myapp/staticfiles/;
        expires 30d;
    }

    location /media/ {
        alias /srv/myapp/media/;
    }

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

SSL через certbot

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d example.com

certbot сам добавит нужные директивы в конфиг и настроит автообновление сертификата.

Rate limiting

limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;

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

Буферизация и таймауты

proxy_connect_timeout 60s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
proxy_buffering on;
proxy_buffer_size 4k;
proxy_buffers 8 4k;

Для WebSocket отключай буферизацию: proxy_buffering off.

Проверка конфига

sudo nginx -t && sudo systemctl reload nginx

Всегда проверяй конфиг перед reload — синтаксическая ошибка положит весь nginx.