Модуль Apache mod_brotli

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

Модуль mod_brotli предоставляет выходной фильтр BROTLI_COMPRESS, который позволяет сжимать вывод сервера в формате сжатия brotli перед отправкой клиенту по сети. Этот модуль использует библиотеку Brotli, доступную по адресу https://github.com/google/brotli.

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

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

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

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

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

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

SetOutputFilter BROTLI_COMPRESS
SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-brotli

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

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

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

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

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

Header append Vary User-Agent

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

Header set Vary *

Передача предварительно сжатого содержимого

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

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

    # Serve brotli compressed JS files if they exist
    # and the client accepts brotli.
    RewriteCond "%{HTTP:Accept-encoding}" "br"
    RewriteCond "%{REQUEST_FILENAME}\.br" "-s"
    RewriteRule "^(.*)\.js"               "$1\.js\.br" [QSA]


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


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

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

BrotliAlterETag AddSuffix|NoChange|Remove

BrotliAlterETag AddSuffix

BrotliCompressionMaxInputBlock value

BrotliCompressionQuality value

BrotliCompressionQuality 5

BrotliCompressionWindow value

BrotliCompressionWindow 18

BrotliFilterNote [type] notename

BrotliFilterNote ratio

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

BrotliFilterNote Input instream
BrotliFilterNote Output outstream
BrotliFilterNote Ratio ratio

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