Конфигурация Nginx для Single Page Application (SPA: React, Vue, Vite)

Обновлено: Август 2026 Стек: Nginx 1.24+, React 18/19, Vue 3, Vite, Svelte Проверено: Production-Ready

Эталонная конфигурация Nginx для статических SPA приложений на React, Vue, Vite, Svelte: маршрутизация HTML5 History API, gzip/brotli, Cache-Control.

Интерактивный генератор под ваши параметры
Параметры подставляются в код в реальном времени
/etc/nginx/sites-available/spa.example.com.conf
# /etc/nginx/sites-available/{{domain}}.conf
server {
    listen 80;
    server_name {{domain}} www.{{domain}};
    return 301 https://{{domain}}$request_uri;
}

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

    root /var/www/{{domain}}/dist;
    index index.html;

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

    # Gzip & Brotli сжатие для JS/CSS бандлов
    gzip on;
    gzip_vary on;
    gzip_min_length 1024;
    gzip_proxied expired no-cache no-store private auth;
    gzip_types text/plain text/css text/xml text/javascript application/javascript application/x-javascript application/xml application/json;

    # Маршрутизация HTML5 History API для React Router / Vue Router
    location / {
        try_files $uri $uri/ /index.html;
    }

    # Кэширование хэшированных JS/CSS файлов сборщика Vite/Webpack
    location ~* \\.(?:css|js)$ {
        expires 1y;
        add_header Cache-Control "public, max-age=31536000, immutable";
        access_log off;
    }

    # Изображения, шрифты и медиа
    location ~* \\.(?:jpg|jpeg|gif|png|ico|cur|gz|svg|svgz|mp4|ogg|ogv|webm|htc|woff|woff2)$ {
        expires 1M;
        add_header Cache-Control "public, max-age=2592000";
        access_log off;
    }

    # Запрет кэширования главного index.html во избежание проблем с обновлением версии SPA
    location = /index.html {
        add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0";
    }
}

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

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

Директива / Блок Рекомендуемое значение Зачем нужно и системное влияние (CPU / RAM / I-O)
try_files $uri $uri/ /index.html; SPA Fallback на index.html Перенаправляет любые прямые переходы по ссылкам (например /catalog/item-1) на точку входа index.html для клиентского роутинга.
location = /index.html { Cache-Control 'no-cache'; } Запрет кэша index.html Гарантирует, что при сборке нового релиза клиенты сразу получат обновленные ссылки на новые хэши бандлов.

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

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

Оптимальный сайзинг: 1 vCPU, 1 GB RAM, 20 GB NVMe (статика)
Расчетная нагрузка: до 100 000 посещений/день со статическим SPA
Timeweb Cloud
1 CPU / 1 GB NVMe
Процессор: 1 vCPU
Память RAM: 1 GB RAM
Накопитель: 20 GB NVMe
🔷 Selectel
1 vCPU / 1 GB RAM
Процессор: 1 vCPU
Память RAM: 1 GB RAM
Накопитель: 20 GB NVMe
🟠 Beget
Старт 1 GB
Процессор: 1 vCPU
Память RAM: 1 GB RAM
Накопитель: 20 GB NVMe

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

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

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

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

Почему при обновлении страницы по ссылке /profile выдается 404 ошибка?
В Nginx отсутствует директива `try_files $uri $uri/ /index.html;`. Nginx ищет физический файл `/profile`, которого нет.