Nginx Reverse Proxy для FastAPI и Uvicorn: WebSocket, асинхронные ответы и SSL
Готовый конфиг Nginx для микросервисов FastAPI и ASGI-сервера Uvicorn: асинхронный proxy_pass, поддержка WebSocket, буферизация больших JSON ответов.
Интерактивный генератор под ваши параметры
Параметры подставляются в код в реальном времени
/etc/nginx/sites-available/api.example.com.conf
# /etc/nginx/sites-available/api.example.com.conf
upstream uvicorn_cluster {
server 127.0.0.1:8000;
server 127.0.0.1:8001;
keepalive 32;
}
server {
listen 80;
server_name api.example.com;
return 301 https://api.example.com$request_uri;
}
server {
listen 443 ssl http2;
server_name api.example.com;
ssl_certificate /etc/letsencrypt/live/api.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/api.example.com/privkey.pem;
client_max_body_size 32M;
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. |
client_max_body_size |
64M / 128M | Устанавливает максимальный размер загружаемых файлов через веб-формы и медиабиблиотеку CMS. |
gzip_comp_level |
5 | Оптимальный уровень сжатия текстовых ресурсов (CSS/JS/HTML), обеспечивающий до 75% экономии трафика без избыточной нагрузки на процессор. |
keepalive_timeout |
65s | Поддерживает открытое соединение для повторных запросов одного клиента, ускоряя загрузку ассетов страницы. |
Рекомендуемые системные требования VDS под этот стек
Расчет минимальной и оптимальной конфигурации виртуального сервера для стабильной работы без сбоев.
Оптимальный сайзинг: 2 vCPU, 4 GB RAM, 30 GB NVMe
Расчетная нагрузка: FastAPI Async API до 2 500 RPS
2 CPU / 4 GB NVMe
Timeweb Cloud
Рекомендуемые ресурсы
2 vCPU /
4 GB RAM /
30 GB NVMe
2 vCPU / 4 GB RAM
Selectel
Рекомендуемые ресурсы
2 vCPU /
4 GB RAM /
30 GB NVMe
Turbo 4 GB
Beget
Рекомендуемые ресурсы
2 vCPU /
4 GB RAM /
30 GB NVMe
Онлайн-утилиты SysKit для проверки этого сервера
Протестируйте корректность применения конфигурации прямо сейчас в один клик.
Частые ошибки при настройке и их решение (FAQ)
Типовые проблемы вебмастеров и сисадминов при внедрении данной конфигурации.
Как запустить несколько инстансов Uvicorn на разных портах?
Используйте supervisor или systemd unit-файлы с шаблоном `uvicorn main:app --host 127.0.0.1 --port 8000` и `8001`.
Как проверить конфигурацию Nginx перед перезагрузкой?
Всегда выполняйте команду `nginx -t`. Если синтаксис верный, примените настройки командой `systemctl reload nginx` без остановки сайта.
Что делать при ошибке 413 Request Entity Too Large?
Увеличьте директиву `client_max_body_size 128M;` в блоке `http {}` или `server {}` и перезагрузите веб-сервер.
Рекомендуемые смежные конфигурации
Дополнительные рецепты и калькуляторы для полной оптимизации данного серверного стека.