Директивы модуля ngx_http_gzip

Персональный
сайт
Игоря
Сысоева

english

sysoev.ru

nginx
поехали!
документация
поддержка
изменения
скачать
ссылки

mod_accel
mod_realip
mod_deflate
программирование
всякая всячина
windows
freebsd
apache
pppd
unix
web

обо мне
для писем
для денег

Директивы модуля ngx_http_gzip_module

28.08.2009

Модуль ngx_http_gzip_module - это фильтр, сжимающий ответ методом gzip, что позволяет уменьшить размер передаваемых данных в 2 и более раз.

Содержание

Пример конфигурации
Директивы

Пример конфигурации

    gzip             on;
    gzip_min_length  1000;
    gzip_proxied     expired no-cache no-store private auth;
    gzip_types       text/plain application/xml;

Для записи в лог степени сжатия можно использовать переменную $gzip_ratio.

Директивы

syntax: gzip on|off
default: gzip off
context: http, server, location, if в location

Разрешает или запрещает сжатие ответа методом gzip.

syntax: gzip_buffers число размер
default: gzip_buffers 32 4k/16 8k
context: http, server, location

Директива задаёт число и размер буферов, в которые будет сжиматься ответ. По умолчанию размер одного буфера равен размеру страницы, в зависимости от платформы это или 4K, или 8K. До версии 0.7.28 по умолчанию использовалось 4 буфера размером 4K или 8K.

syntax: gzip_comp_level 1..9
default: gzip_comp_level 1
context: http, server, location

Устанавливает уровень сжатия ответа методом gzip.

syntax: gzip_disable regex [regex ...]
default: нет
context: http, server, location

Директива (0.6.23) запрещает сжатие ответа методом gzip для запросов со строками "User-Agent", совпадающими с заданными регулярными выражениями.

Специальная маска "msie6" (0.7.12) соответствует регулярному выражению "MSIE [4-6]\.", но работает быстрее. Начиная с версии 0.8.11, из этой маски исключается "MSIE 6.0; ... SV1".

syntax: gzip_min_length длина
default: gzip_min_length 20
context: http, server, location

Устанавливает минимальную длину ответа, для которых будет выполняться сжатие ответа методом gzip. Длина определяется только из строки "Content-Length" заголовка ответа.

syntax: gzip_http_version 1.0|1.1
default: gzip_http_version 1.1
context: http, server, location

Устанавливает минимальную версию HTTP запроса для сжатия ответа.

Разрешает или запрещает сжатие ответа методом gzip для проксированных запросов в зависимости от запроса и ответа. То что, запрос проксированный, определяется на основании строки "Via" в заголовке запроса. В директиве можно указать одновременно несколько паарметров:

off — запрещает сжатие для всех проксированных запросов, игнорируя остальные параметры;
expired — разрешить сжатие, если в ответе есть строка "Expires" со значением, запрещающим кэширование;
no-cache — разрешить сжатие, если в ответе есть строка "Cache-Control" с параметром "no-cache";
no-store — разрешить сжатие, если в ответе есть строка "Cache-Control" с параметром "no-store";
private — разрешить сжатие, если в ответе есть строка "Cache-Control" с параметром "private";
no_last_modified — разрешить сжатие, если в ответе нет строки "Last-Modified";
no_etag — разрешить сжатие, если в ответе нет строки "ETag";
auth — разрешить сжатие, если в запросе есть строка "Authorization";
any — разрешить сжатие для всех проксированных запросов;

syntax: gzip_types mime-тип [mime-тип ...]
default: gzip_types text/html
context: http, server, location

Разрешает сжатие ответа методом gzip для указанных MIME-типов в дополнение к "text/html". "text/html" сжимается всегда.

syntax: gzip_vary on|off
default: gzip_vary off
context: http, server, location

Разрешает или запрещает выдавать в ответе строку заголовка "Vary: Accept-Encoding", если директивы gzip или gzip_static активны.

ПерсональныйсайтИгоряСысоева