Конфигурация Nginx для Single Page Application (SPA: React, Vue, Vite)
Эталонная конфигурация 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`, которого нет.
Рекомендуемые смежные конфигурации
Дополнительные рецепты и калькуляторы для полной оптимизации данного серверного стека.