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