Модуль 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>

DeflateAlterETag AddSuffix|NoChange|Remove

DeflateAlterETag AddSuffix

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