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-EncodingHTTP响应标头，以警告代理缓存的响应应仅发送给发送适当Accept-Encoding请求标头的客户端。这样可以防止将压缩的内容发送给无法理解的客户端。

如果您使用某些依赖于User-Agent标题的特殊排除，则必须手动配置Vary标题的附加项以向代理警告其他限制。例如，在典型的配置中，BROTLI_COMPRESS 过滤器的User-Agent添加取决于，您应该添加：

Header append Vary User-Agent

如果关于压缩的决定取决于请求标头（例如 HTTP版本）以外的其他信息，则必须将 Vary标头设置为value *。这样可以防止兼容代理完全缓存。

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>