Nginx Reverse Proxy для FastAPI и Uvicorn: WebSocket, асинхронные ответы и SSL

Обновлено: Август 2026 Стек: Nginx 1.24+, Python 3.12, FastAPI 0.111+, Uvicorn Проверено: Production-Ready

Готовый конфиг Nginx для микросервисов FastAPI и ASGI-сервера Uvicorn: асинхронный proxy_pass, поддержка WebSocket, буферизация больших JSON ответов.

Интерактивный генератор под ваши параметры
Параметры подставляются в код в реальном времени
/etc/nginx/sites-available/api.example.com.conf
# /etc/nginx/sites-available/{{domain}}.conf
upstream uvicorn_cluster {
    server 127.0.0.1:8000;
    server 127.0.0.1:8001;
    keepalive 32;
}

server {
    listen 80;
    server_name {{domain}};
    return 301 https://{{domain}}$request_uri;
}

server {
    listen 443 ssl http2;
    server_name {{domain}};

    ssl_certificate /etc/letsencrypt/live/{{domain}}/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/{{domain}}/privkey.pem;

    client_max_body_size {{client_max_body}};

    location / {
        proxy_pass http://uvicorn_cluster;
        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_buffering on;
        proxy_buffers 32 16k;
        proxy_busy_buffers_size 64k;
        proxy_read_timeout 120s;
    }
}

Разбор ключевых директив конфигурации

Техническое обоснование директив и их прямое влияние на процессор (CPU), оперативную память (RAM) и дисковый ввод-вывод (NVMe I/O).

Директива / Блок Рекомендуемое значение Зачем нужно и системное влияние (CPU / RAM / I-O)
upstream uvicorn_cluster Круговой балансировщик (Round-Robin) Балансирует запросы между несколькими инстансами Uvicorn воркеров, утилизируя все доступные vCPU.

Рекомендуемые системные требования VDS под этот стек

Расчет минимальной и оптимальной конфигурации виртуального сервера для стабильной работы без сбоев.

Оптимальный сайзинг: 2 vCPU, 4 GB RAM, 30 GB NVMe
Расчетная нагрузка: FastAPI Async API до 2 500 RPS
Timeweb Cloud
2 CPU / 4 GB NVMe
Процессор: 2 vCPU
Память RAM: 4 GB RAM
Накопитель: 30 GB NVMe
🔷 Selectel
2 vCPU / 4 GB RAM
Процессор: 2 vCPU
Память RAM: 4 GB RAM
Накопитель: 30 GB NVMe
🟠 Beget
Turbo 4 GB
Процессор: 2 vCPU
Память RAM: 4 GB RAM
Накопитель: 30 GB NVMe

Онлайн-утилиты SysKit для проверки этого сервера

Протестируйте корректность применения конфигурации прямо сейчас в один клик.

Частые ошибки при настройке и их решение (FAQ)

Типовые проблемы вебмастеров и сисадминов при внедрении данной конфигурации.

Как запустить несколько инстансов Uvicorn на разных портах?
Используйте supervisor или systemd unit-файлы с шаблоном `uvicorn main:app --host 127.0.0.1 --port 8000` и `8001`.