Модуль Apache mod_deflate

Краткое описание

Модуль mod_deflate предоставляет фильтр вывода DEFLATE, который позволяет сжимать данные, отправляемые сервером клиенту по сети, перед их отправкой.

Поддерживаемые кодировки

Поддерживается только кодировка gzip, чтобы обеспечить полную совместимость со старыми браузерами. Кодировка deflate не поддерживается, пожалуйста, ознакомьтесь с документацией zlib для получения полной информации.

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

Это простая конфигурация, которая сжимает распространённые текстовые типы содержимого.

AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript

Включение сжатия

Сжатие вывода

Сжатие реализовано фильтром DEFLATE фильтр. Следующая директива включит сжатие для документов в контейнере, где она размещена:

SetOutputFilter DEFLATE
SetEnvIfNoCase Request_URI "\.(?:gif|jpe?g|png)$" no-gzip

Если вы хотите ограничить сжатие определёнными MIME-типами, вы можете использовать директиву AddOutputFilterByType. Вот пример включения сжатия только для HTML-файлов документации Apache:

<Directory "/your-server-root/manual">
    AddOutputFilterByType DEFLATE text/html
</Directory>

Распаковка вывода

Модуль mod_deflate также предоставляет фильтр для распаковки/рассжатия gzip-сжатого тела ответа. Для активации этой функции необходимо вставить фильтр INFLATE в цепочку фильтров вывода, используя SetOutputFilter или AddOutputFilter, например:

<Location "/dav-area">
    ProxyPass "http://example.com/"
    SetOutputFilter INFLATE
</Location>

Этот пример распакует gzip-сжатый вывод с example.com, чтобы другие фильтры могли выполнить дальнейшую обработку.

Распаковка ввода

Модуль mod_deflate также предоставляет фильтр для распаковки тела запроса, сжатого gzip. Для активации этой функции необходимо вставить фильтр DEFLATE в цепочку фильтров ввода, используя SetInputFilter или AddInputFilter, например:

<Location "/dav-area">
    SetInputFilter DEFLATE
</Location>

Теперь, если запрос содержит заголовок Content-Encoding: gzip, тело будет автоматически распаковано. Несколько браузеров способны сжимать тела запросов gzip. Однако некоторые специальные приложения фактически поддерживают сжатие запросов, например, некоторые клиенты WebDAV.

Работа с прокси-серверами

Модуль mod_deflate отправляет заголовок HTTP ответа Vary: Accept-Encoding для уведомления прокси-серверов о том, что кэшированный ответ должен быть отправлен только клиентам, которые отправляют соответствующий заголовок запроса Accept-Encoding. Это предотвращает отправку сжатого содержимого клиентам, которые его не поймут.

Если вы используете специальные исключения, зависящие, например, от заголовка User-Agent, вы должны вручную настроить добавление к заголовку Vary для уведомления прокси-серверов об дополнительных ограничениях. Например, в типичной конфигурации, где добавление фильтра DEFLATE зависит от User-Agent, вы должны добавить:

Header append Vary User-Agent

Если ваше решение о сжатии зависит от другой информации, кроме заголовков запросов (например, версии HTTP), вам необходимо установить заголовок Vary в значение *. Это предотвращает кэширование полностью совместимыми прокси-серверами.

Header set Vary *

Обработка предварительно сжатого содержимого

Поскольку mod_deflate пересжимает содержимое каждый раз при поступлении запроса, можно получить выгоду от предварительного сжатия содержимого и указания mod_deflate на предоставление этих данных без пересжатия. Это можно сделать с помощью следующей конфигурации:

<IfModule mod_headers.c>
    # Serve gzip compressed CSS and JS files if they exist
    # and the client accepts gzip.
    RewriteCond "%{HTTP:Accept-encoding}" "gzip"
    RewriteCond "%{REQUEST_FILENAME}\.gz" -s
    RewriteRule "^(.*)\.(css|js)"         "$1\.$2\.gz" [QSA]

    # Serve correct content types, and prevent mod_deflate double gzip.
    RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-gzip:1]
    RewriteRule "\.js\.gz$"  "-" [T=text/javascript,E=no-gzip:1]


    <FilesMatch "(\.js\.gz|\.css\.gz)$">
      # Serve correct encoding type.
      Header append Content-Encoding gzip

      # Force proxies to cache gzipped &
      # non-gzipped css/js files separately.
      Header append Vary Accept-Encoding
    </FilesMatch>
</IfModule>

DeflateBufferSize value

DeflateBufferSize 8096

DeflateCompressionLevel value

Zlib's default

DeflateFilterNote [type] notename

DeflateFilterNote ratio

LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate
CustomLog "logs/deflate_log" deflate

DeflateFilterNote Input instream
DeflateFilterNote Output outstream
DeflateFilterNote Ratio ratio

LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
CustomLog "logs/deflate_log" deflate

DeflateInflateLimitRequestBody value

None, but LimitRequestBody applies after deflation

DeflateInflateRatioBurst value

DeflateInflateRatioBurst 3

DeflateInflateRatioLimit value

DeflateInflateRatioLimit 200

DeflateMemLevel value

DeflateMemLevel 9

DeflateWindowSize value

DeflateWindowSize 15