すべてのプロダクト
Search
ドキュメントセンター

CDN:パラメータ無視

最終更新日:Aug 15, 2026

パラメータ無視を有効にすると、CDN エッジノードはリクエスト URL からクエリパラメータ (? 以降の部分) を削除します。これにより、異なるパラメータを持つリクエストが同じキャッシュにヒットし、キャッシュヒット率が向上します。本トピックでは、パラメータ無視の設定方法、代替機能との比較、および使用に関する推奨事項について説明します。

機能の比較

  • カスタムキャッシュキーはパラメータ無視と競合します。パラメータ無視とカスタムキャッシュキーの両方を同時に設定した場合、パラメータ無視は無効になります。

  • カスタムキャッシュキーは、キャッシュキーの設定においてパラメータ無視を置き換えることができ、より包括的な機能を提供します。最初にカスタムキャッシュキーを使用することを推奨します。設定の比較:

    シナリオ

    パラメータ無視

    カスタムキャッシュキー

    キャッシュキーからすべてのリクエストパラメータを無視

    [パラメータ無視][はい] に設定し、[指定パラメータの保持] を空のままにします。

    リクエストパラメータ処理ルールを追加します:

    • アクション:保持

    • パラメータ名:存在しない任意のパラメータ名 (example-argument など) を設定します。

    キャッシュキーにリクエストパラメータ key1 のみを保持

    [パラメータ無視][はい] に設定し、[指定パラメータの保持]key1 に設定します。

    リクエストパラメータ処理ルールを追加します:

    • アクション:保持

    • パラメータ名:key1

    キャッシュキーからリクエストパラメータ key1 のみを削除

    key1 のパラメータ設定を削除します。

    リクエストパラメータ処理ルールを追加します:

    • アクション:削除

    • パラメータ名:key1

  • オリジンパラメータの書き換えは、オリジンリクエストの書き換えにおいてパラメータ無視を置き換えることができ、より包括的な機能を提供します。最初に「オリジンパラメータの書き換え」を使用することを推奨します。

機能の概要

パラメータ無視

機能

シナリオ

リクエスト URL からクエリパラメーター (? 以降の部分) を削除し、パラメーターが異なるリクエストが同じキャッシュファイルにヒットするようにします。これにより、キャッシュヒット率が向上し、オリジンへのトラフィックが削減されます。

URL パラメータがリソースコンテンツと関連しない場合 (ユーザー UID、参照元、プロモーションコードなど) は、パラメータ無視を有効にします。たとえば、次の2つのリクエストは同じリソースにアクセスしますが、異なる UID を持っています:

ユーザー A: http://example.com/1.jpg?uid=123***

ユーザー B: http://example.com/1.jpg?uid=654***

パラメータ無視を設定しない場合、CDN エッジノードはこれらを異なるリソースとして扱い、同じキャッシュを共有できないため、各リクエストに対してオリジンフェッチが必要になります。パラメータ無視を有効にすると、CDN エッジノードはパラメータを削除し、http://example.com/1.jpg を使用してキャッシュを検索します。

説明

URL 署名はパラメータ無視よりも優先されます。タイプ A 署名は、署名に URL パラメータを含めます。CDN は最初に認証を実行し、検証が成功した後にのみキャッシュコピーとして保存します。

オリジンパラメータの保持

機能

シナリオ

オリジンフェッチ時にすべての元の URL パラメータを保持し、オリジンサーバーが重要なユーザー情報を受信できるようにします。

パラメータ無視が有効になっている場合、CDN エッジノードはデフォルトでパラメータを削除した URL を使用してオリジンフェッチを行います。上記の例では、ユーザー A とユーザー B の両方が http://example.com/1.jpg へのオリジンリクエストを発生させ、UID などの重要な情報が失われます。オリジンパラメータの保持を有効にすると、CDN はオリジンフェッチに元の URL を使用し、オリジンサーバーに UID などのパラメータを渡します。

操作手順

  1. CDN コンソールにログインします。

  2. 左側のナビゲーションペインで、ドメイン名 をクリックします。

  3. ドメインリストで対象のドメイン名をクリックし、左側のナビゲーションペインでパフォーマンスの最適化をクリックして、パフォーマンス最適化設定ページに移動します。

  4. 「パラメーターを無視」セクションで変更をクリックしてモードを選択し、必要に応じて設定を完了します。

  5. 設定が完了したら、OK をクリックして保存します。

重要
  • モードを切り替えると、既存の設定がクリアされます。

  • パラメータ無視の設定を変更した後、エッジノードにキャッシュされたファイルは自動的に更新されません。新しい設定を適用し、古いキャッシュを消去するには、コンソールで URL のリフレッシュまたは ディレクトリのリフレッシュを実行する必要があります。それ以外の場合、ユーザーは古いポリシーでキャッシュされたコンテンツにアクセスする可能性があり、アクセスの問題が発生する可能性があります。

モード:指定パラメータの保持

パラメータ

説明

[パラメーターを無視]

  • はい:パラメータ無視を有効にして、URL の ? 以降のすべてのパラメータを削除します。

    説明

    [パラメータを無視] を有効にし、[指定したパラメータを保持] を空のままにした場合、? 以降のすべてのパラメータが削除されます。

  • いいえ:パラメータ無視を無効にして、すべての URL パラメータを保持します。

元の URL が http://example.com/1.jpg?key1=1&key2=2&key3=3 であると仮定します。各設定の結果は次のとおりです:

  • すべてのパラメータを無視し、オリジンパラメータを保持しない

    • 設定:パラメーターを無視=はい指定パラメーターを保持は空、オリジンパラメーターを保持=いいえ

    • キャッシュキー:http://example.com/1.jpg

    • オリジン URL:http://example.com/1.jpg

  • 指定パラメータを保持し、オリジンパラメータを保持しない

    • 設定: パラメーターを無視=はい, 指定されたパラメーターを保持=key1, オリジンパラメーターを保持=いいえ

    • キャッシュキー:http://example.com/1.jpg?key1=1

    • オリジン URL:http://example.com/1.jpg?key1=1

  • すべてのパラメータを無視し、オリジンパラメータを保持する

    • 設定: パラメーターを無視=はい指定したパラメーターを保持は空白、オリジンパラメーターを保持=はい

    • キャッシュキー:http://example.com/1.jpg

    • オリジン URL:http://example.com/1.jpg?key1=1&key2=2&key3=3

  • 指定パラメータを保持し、オリジンパラメータを保持する

    • 設定: パラメーターを無視 = はい指定したパラメーターを保持 = key1オリジンパラメーターを保持 = はい

    • キャッシュキー:http://example.com/1.jpg?key1=1

    • オリジン URL:http://example.com/1.jpg?key1=1&key2=2&key3=3

[指定されたパラメーターを保持]

保持するパラメータ名を入力します。最大 10 個のパラメータをカンマ (,) で区切って指定できます。

[オリジンパラメーターの保持]

  • はい:オリジンフェッチ時にすべての元の URL パラメータを保持します。

  • いいえ:オリジンフェッチ時に、キャッシュハッシュキーと一致するパラメータ (つまり、保持されたパラメータ) のみを含めます。

[ルール条件]

ルール条件は、ユーザーリクエスト内のさまざまなパラメーター情報を識別します。これにより、そのリクエストに対して設定が有効になるかどうかが決まります。

重要

ルール条件を参照する場合、機能自体の設定順序ではなく、関連するルール条件の優先順位に基づいてマッチングされます。

  • 使用しない:ルール条件を使用しません。

  • ルール条件を追加または編集するには、ルールエンジンで管理してください。

モード:指定パラメータの削除

パラメータ

説明

[指定されたパラメーターの削除]

削除するパラメータ名を入力します。最大 10 個のパラメータをスペースで区切って指定できます。

元の URL が http://example.com/1.jpg?key1=1&key2=2&key3=3 であると仮定します。各設定の結果は次のとおりです:

  • 指定パラメータを削除し、オリジンパラメータを保持しない

    • 設定: 指定したパラメーターを削除=key1, 元のパラメーターを保持=いいえ

    • キャッシュキー:http://example.com/1.jpg?key2=2&key3=3

    • オリジン URL:http://example.com/1.jpg?key2=2&key3=3

  • 指定パラメータを削除し、オリジンパラメータを保持する

    • 設定: 指定パラメーターの削除=key1元のパラメーターを保持=はい

    • キャッシュキー:http://example.com/1.jpg?key2=2&key3=3

    • オリジン URL:http://example.com/1.jpg?key1=1&key2=2&key3=3

[オリジンパラメーターの保持]

  • はい:オリジンフェッチ時にすべての元の URL パラメータを保持します。

  • いいえ:オリジンフェッチ時に、キャッシュハッシュキーと一致するパラメータ (つまり、指定パラメータを削除した結果) のみを含めます。

[ルール条件]

ルール条件は、ユーザーリクエスト内のさまざまなパラメーター情報を識別します。これにより、そのリクエストに対して設定が有効になるかどうかが決まります。

重要

ルール条件を参照する場合、機能自体の設定順序ではなく、関連するルール条件の優先順位に基づいてマッチングされます。

  • 使用しない:ルール条件を使用しません。

  • ルール条件を追加または編集するには、ルールエンジンで管理してください。

使用シナリオの例

パラメータ無視を使用した URL パラメータによるキャッシュバイパス攻撃の軽減

攻撃者やクローラーが同じリソースをリクエストする際にランダムな無意味なパラメータ (?timestamp=xxx?random=xxx など) を追加すると、CDN は各パラメータ化されたリクエストを一意のリソースとして扱います。これにより、キャッシュヒット率が低下し、オリジントラフィックが急増します。

パラメータ無視を有効にする (またはすべてのパラメータを無視するように設定する) と、異なるランダムパラメータを持つリクエストが同じキャッシュにヒットし、オリジンの負荷を効果的に削減できます。たとえば、パラメータ無視を有効にすると、次のリクエストは同じキャッシュにヒットします:

  • http://example.com/page.html?t=123456

  • http://example.com/page.html?t=789012

  • http://example.com/page.html?random=abc

パラメータ無視を有効にすると、これらすべてのリクエストは http://example.com/page.html を使用してキャッシュを検索し、URL パラメータによるキャッシュバイパス攻撃を効果的に軽減します。