Nginx gzip_static: отдавать готовые .gz файлы

Категория: Nginx · Язык: Bash · Обновлено:

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 заранее и оставьте оригиналы рядом:

Bash
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.