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>