利用可能な設定

圧縮ルールは、以下のセクションで説明される設定をサポートします。

ダッシュボード設定

ウェブサイトの訪問者がサポートするアルゴリズムに従って、レスポンスを圧縮します（該当する場合）。Cloudflareは、圧縮アルゴリズムの優先順位を定義し、将来的に変更される可能性があります。

一致するリクエストに対して圧縮を無効にします。また、Cloudflareのデフォルトの圧縮動作も無効にします。

圧縮アルゴリズムのカスタム順序を定義します。

許可される値は以下の通りです：

Gzip: ウェブサイトの訪問者がサポートする場合、Gzip圧縮アルゴリズムを使用します。
Brotli: ウェブサイトの訪問者がサポートする場合、Brotli圧縮アルゴリズムを使用します。
Auto: ウェブサイトの訪問者がサポートするアルゴリズムに従ってレスポンスを圧縮します（該当する場合）。Cloudflareは、圧縮アルゴリズムの優先順位を定義し、将来的に変更される可能性があります。圧縮を有効にするオプションと同じ動作をします。
Default: Cloudflareのデフォルトの圧縮動作を使用します。これはレスポンスのコンテンツタイプに依存します。

Gzipおよび/またはBrotliのみを指定し、アルゴリズムが一致しない場合、レスポンスは圧縮されません。フォールバック圧縮メカニズムを構成するには、リストにAutoを追加します。

compress_responseアクションでサポートされる設定オブジェクトは、以下の形式を持ちます：

"action_parameters": {
  "algorithms": [
    { "name": "<VALUE1>" },
    { "name": "<VALUE2>" },
    // ...
  ]
}

algorithmsリストには、少なくとも1つのアイテムが含まれている必要があります。

サポートされるアルゴリズムの値は以下の通りです：

gzip: ウェブサイトの訪問者がサポートする場合、Gzip圧縮アルゴリズムを使用します。
brotli: ウェブサイトの訪問者がサポートする場合、Brotli圧縮アルゴリズムを使用します。
none: いかなる圧縮アルゴリズムも使用しません。
auto: ウェブサイトの訪問者がサポートするアルゴリズムに従ってレスポンスを圧縮します（該当する場合）。Cloudflareは、圧縮アルゴリズムの優先順位を定義し、将来的に変更される可能性があります。
default: Cloudflareのデフォルトの圧縮動作を使用します。これはレスポンスのコンテンツタイプに依存します。

リストにnone、default、またはautoを含める場合、それはリストの最後の値でなければなりません。

gzipおよび/またはbrotliアルゴリズムのみを指定した場合、アルゴリズムが一致しないとレスポンスは圧縮されません。フォールバック圧縮メカニズムを構成するには、リストにautoを追加します。

以下のAPIの例は、Cloudflareダッシュボードのオプションと同じ動作を実装しています。

圧縮を有効にする

訪問者がサポートするアルゴリズムに従ってレスポンスを圧縮するには、algorithmsリストを単一のアルゴリズムに設定します："auto"。

"action_parameters": {
  "algorithms": [
    { "name": "auto" }
  ]
}

autoアルゴリズムは、ウェブサイトの訪問者が圧縮をサポートしている限り、常にレスポンスに圧縮を適用します。Cloudflareは、圧縮アルゴリズムの優先順位を定義し、将来的に変更される可能性があります。

圧縮を無効にする

一致するリクエストに対して圧縮を無効にするには、algorithmsリストを単一のアルゴリズムに設定します："none"。

"action_parameters": {
  "algorithms": [
    { "name": "none" }
  ]
}

圧縮アルゴリズムのカスタム順序を定義する

この例では、優先される圧縮アルゴリズムをBrotliに設定し、Gzipをフォールバックとして使用します。訪問者がこれらのアルゴリズムのいずれもサポートしていない場合、ウェブサイトの訪問者がサポートするアルゴリズムに従ってレスポンスを圧縮しようとします（該当する場合）。

"action_parameters": {
  "algorithms": [
    { "name": "brotli" },
    { "name": "gzip" },
    { "name": "auto" }
  ]
}