Apache 模块 mod_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 指令。以下是如何仅为 Apache 文档的 html 文件启用压缩的示例

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

处理代理服务器

mod_brotli 模块发送 Vary: Accept-Encoding HTTP 响应头以提醒代理，缓存的响应应仅发送给发送适当 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>