Nginx gzip_static: отдавать готовые .gz файлы
gzip_static on отдаёт клиенту заранее сжатый файл file.gz, если он лежит рядом с оригиналом и клиент поддерживает gzip. Nginx не тратит CPU на сжатие при каждом запросе и не буферизует ответ. Это быстрее динамического gzip on для статики, которую можно сжать на этапе сборки.
Включить отдачу .gz для статики
server {
listen 80;
root /var/www/app;
gzip_static on;
gzip_vary on;
location /assets/ {
gzip_static on;
expires 1y;
add_header Cache-Control "public, immutable";
}
}Соберите .gz заранее и оставьте оригиналы рядом:
find dist/assets -type f \( -name '*.css' -o -name '*.js' -o -name '*.svg' \) \
-exec gzip -9 -k {} \;gzip_vary on добавляет Vary: Accept-Encoding, чтобы прокси и CDN не отдали gzip-версию клиенту без поддержки. Без Vary промежуточный кеш может смешать варианты. gzip_static always отдаёт .gz независимо от заголовка клиента — это допустимо только в полностью контролируемой среде и легко ломает старые клиенты.
Сжимайте текстовые форматы: CSS, JS, SVG, JSON, HTML. Изображения JPEG/PNG/WebP и видео уже сжаты, повторный gzip может увеличить размер. Не сжимайте файлы, которые отдаются через приложение с Content-Encoding вручную, иначе получите двойное сжатие.
Модуль ngx_http_gzip_static_module входит в стандартные сборки Nginx, но проверьте nginx -V. Если .gz отсутствует, Nginx отдаст оригинал; при включённом gzip on он может сжать его на лету. Для Brotli нужен отдельный модуль и файлы .br.
Проверьте ответ через curl -H 'Accept-Encoding: gzip' -I: должны быть Content-Encoding: gzip и корректный Content-Length сжатого файла. Убедитесь, что оригинал и .gz обновляются одной сборкой, иначе клиент получит старую версию.
Документация: ngx_http_gzip_static_module, gzip_vary.