v1.0
Шаблон nginx конфига

FastAPI + Uvicorn

Готовая конфигурация nginx для Python FastAPI-приложения, запущенного через Uvicorn или Gunicorn с Uvicorn-воркерами. Включает проксирование на порт 8000, передачу реальных IP клиентов и раздачу статических файлов.

Пример конфига
nginx.conf 
upstream fastapi_backend {
    server 127.0.0.1:8000;
    keepalive 32;
}

server {
    listen 80;
    server_name example.com;

    server_tokens off;
    client_max_body_size 20m;

    access_log /var/log/nginx/fastapi-access.log combined;
    error_log  /var/log/nginx/fastapi-error.log warn;

    gzip on;
    gzip_vary on;
    gzip_comp_level 5;
    gzip_types text/plain text/css application/json application/javascript text/xml image/svg+xml;

    # Заголовки безопасности
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;

    # Статические файлы
    location /static/ {
        alias /var/www/app/static/;
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    # API и документация
    location / {
        proxy_pass http://fastapi_backend;
        proxy_http_version 1.1;
        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_set_header Connection        "";
        proxy_read_timeout    120s;
        proxy_connect_timeout 30s;
        proxy_buffering on;
        proxy_buffer_size   8k;
        proxy_buffers       8 32k;
    }

    location ~ /\. {
        deny all;
    }

    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
Как настроить
  1. Установите Uvicorn: pip install uvicorn[standard] gunicorn
  2. Запустите приложение: gunicorn app.main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 127.0.0.1:8000
  3. Скопируйте сгенерированный конфиг в /etc/nginx/sites-available/example.com
  4. Создайте символическую ссылку: ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
  5. Проверьте синтаксис: nginx -t
  6. Перезагрузите nginx: systemctl reload nginx