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

# /etc/nginx/sites-available/spa.example.com.conf

    listen 80;
    server_name spa.example.com www.spa.example.com;
    return 301 https://spa.example.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name spa.example.com;

    root /var/www/spa.example.com/dist;

    # Security Headers
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
    add_header Permissions-Policy "geolocation=(), microphone=(), camera=()" always;

    index index.html;

    ssl_certificate /etc/letsencrypt/live/spa.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/spa.example.com/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";
    }
}