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

CDN:送信リクエストヘッダーの変更

最終更新日:Jun 22, 2026

デフォルトでは、Alibaba Cloud CDN および は、クライアント IP アドレスを含むリクエストヘッダーなどの転送をサポートしています。カスタムヘッダーも設定できます。オリジンリクエストの HTTP ヘッダーを書き換えるには、送信リクエストヘッダーを変更します。この機能を使用すると、ビジネス要件に合わせてオリジンリクエストの HTTP ヘッダーを追加、削除、変更、または置換できます。

背景情報

HTTP リクエストヘッダーは HTTP リクエストメッセージの一部で、特定のパラメーター情報をサーバーに渡すために使用されます。

CDN または の POP (ポイントオブプレゼンス) がオリジンサーバーにリクエストを送信してリソースを取得するとき、オリジンサーバーはオリジンリクエストのヘッダーの情報にアクセスできます。この機能を使用して、オリジンリクエストの HTTP ヘッダー情報を書き換え、特定のパラメーターをオリジンサーバーに送信できます。

オリジンサーバーがオリジンリクエストの X-Forwarded-For ヘッダーからクライアントのリアル IP アドレスを取得する方法については、「クライアントのリアル IP アドレスの取得」をご参照ください。

image

注意事項

  • 送信リクエストは、CDN および からオリジンサーバーに送信される HTTP メッセージです。送信リクエストヘッダーの設定変更は、CDN または からオリジンサーバーに送信される HTTP メッセージにのみ影響します。この設定は、CDN または の POP からユーザーに直接配信される HTTP メッセージには影響しません。

  • ワイルドカードドメイン名の送信リクエストヘッダーは変更できません。

  • この機能がルールエンジンの条件で設定されている場合、実行順序は機能の設定順序ではなく、ルール条件の優先度によって決まります。

  • デフォルトでは、Alibaba Cloud CDN および は、次の HTTP リクエストヘッダーをオリジンリクエストに含めます。追加の設定は不要です。

    オリジン HTTP ヘッダー

    説明

    Ali-Cdn-Real-Ip

    CDN または の POP に接続しているクライアントのリアル IP アドレス。

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

    クライアントの IP アドレスと、オリジンリクエストのパスにあるすべての中間 CDN または の POP の IP アドレス。

    X-Forwarded-For:192.168.0.1, 172.16.0.1

    X-Client-Scheme

    クライアントが CDN または の POP にリクエストを送信するために使用する、HTTP や HTTPS などのアプリケーション層プロトコル。

    X-Client-Scheme:http

    Host

    オリジンリクエストがアクセスするオリジンウェブサイトのドメイン名。

    Host:example.com

    Via

    クライアントリクエストが通過するすべての CDN または の POP の名前。

    Via:cn2546-10.l1, cache1.cn2546-10, l2cn2547-7.l2, cache1.l2cn2547-7

  • 送信リクエストヘッダーの値をいずれかの変数に設定した場合、実行時にその変数が実際の値に展開されます。利用可能な変数は次のとおりです。

    パラメーター

    オリジン HTTP ヘッダー

    説明

    Ali-Cdn-Real-Port

    $http_Ali_Cdn_Real_Port

    クライアントのリアルポートをオリジンリクエストヘッダーに追加して、ポート情報をオリジンサーバーに渡します。

    Ali-Cdn-Real-Port:80

    Ali-Cdn-Real-Ip

    $http_Ali_Cdn_Real_Ip

    クライアントのリアル IP アドレスをオリジンリクエストヘッダーに追加して、クライアント IP アドレス情報をオリジンサーバーに渡します。

    Ali-Cdn-Real-Ip:192.168.0.1

    x_forwarded_for

    $proxy_add_x_forwarded_for

    クライアント IP アドレスと中間プロキシサーバーの IP アドレスを X-Forwarded-For ヘッダーに追加して、オリジンサーバーに渡します。

    X-Forwarded-For:192.168.0.1, 172.16.0.1

よくある質問

必須 HTTP ヘッダーフィールドの欠落

中間プロキシとして、CDN はセキュリティ脆弱性を修正するために、Cache-Control などの不足している HTTP レスポンスヘッダーをレスポンスに直接挿入することはできません。CDN はオリジンリクエストのヘッダーのみを変更できます。

CDN コンソールでカスタムオリジンリクエストヘッダーを設定して、CLB インスタンスなどのオリジンサーバーに必要なパラメーターを渡すことを推奨します。オリジンサーバーがこれをサポートしていない場合や変更できない場合、CDN はレスポンスヘッダーを直接追加する別の方法を提供しません。

説明

CDN がクライアントに送信するレスポンスに HTTP ヘッダーを追加する方法については、「送信レスポンスヘッダーの変更」をご参照ください。

カスタム HTTP ヘッダーとアクセス速度

いいえ。CDN でカスタムオリジンリクエストヘッダーを設定しても、アクセス速度には影響しません。

操作手順

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

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

  3. [ドメイン名] ページで、管理対象のドメイン名を見つけ、[アクション] 列の [管理] をクリックします。

    ドメイン名

  4. ドメイン名の左側のナビゲーションウィンドウで、[Back-to-Origin 設定] をクリックします。

  5. 送信リクエストヘッダーの変更 タブをクリックします。

  6. 追加 をクリックします。

  7. 送信リクエストヘッダーを設定します。

    重要

    同じオリジンリクエストヘッダーに対して異なる操作を設定すると競合が発生し、最も優先度の高い操作が実行されます。優先順位は、書き換え > 追加 > 変更削除 です。

    ヘッダーの追加

    パラメーター

    説明

    [実行内容]

    追加

    指定したリクエストヘッダーをオリジンリクエストに追加します。

    [要求ヘッダー]

    カスタムオリジンリクエストヘッダー

    カスタム back-to-origin リクエストヘッダー またはプリセットのリクエストヘッダーを選択します。

    [カスタム要求ヘッダー名]

    x-code

    カスタムリクエストヘッダー名を x-code として指定します。

    [要求ヘッダー値]

    key1, key2

    リクエストヘッダーに複数の値を設定できます。複数の値はコンマ (,) で区切ります。

    [重複の許可]

    はい

    • [はい] 重複するリクエストヘッダーの追加を許可します。例: x-code:key1x-code:key2

    • [いいえ] 同じ名前のヘッダーを追加すると、新しい値が既存の値を上書きします。たとえば最初に x-code:key1 を追加し、次に x-code:key2 を追加した場合、最終的な値は x-code:key2 になります。

    [ルール条件]

    使用しない

    ルール条件は、ユーザーリクエスト内のさまざまなパラメーターを識別し、特定のリクエストに設定を適用するかどうかを決定します。

    重要

    ルール条件を使用する場合、照合は機能自体の設定順序ではなく、関連するルール条件の優先度に基づいて行われます。

    • 使用しない: ルール条件は使用されません。

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

    ヘッダーの削除

    パラメーター

    説明

    [実行内容]

    削除

    指定した名前に一致するすべてのヘッダーを、重複を含めて削除します。

    [要求ヘッダー]

    カスタムオリジンリクエストヘッダー

    カスタム back-to-origin リクエストヘッダー またはプリセットのリクエストヘッダーを選択します。

    [カスタム要求ヘッダー名]

    x-code

    カスタムリクエストヘッダー名を x-code として指定します。

    [ルール条件]

    使用しない

    ルール条件により、リクエストが特定の基準を満たす場合にのみルールを適用できます。

    • 使用しない:条件付きルールを無効にします。

    • 条件付きルールはルールエンジンで追加または編集できます。

    ヘッダーの変更

    パラメーター

    説明

    [実行内容]

    変更

    ヘッダーの値を変更します。同じ名前のヘッダーが重複して存在する場合、この操作は許可されません。

    [要求ヘッダー]

    カスタムオリジンリクエストヘッダー

    カスタム back-to-origin リクエストヘッダー またはプリセットのリクエストヘッダーを選択します。

    [カスタム要求ヘッダー名]

    x-code

    カスタムリクエストヘッダー名を x-code として指定します。

    [値の変更]

    key1, key3

    リクエストヘッダーに複数の値を設定できます。複数の値はコンマ (,) で区切ります。

    [ルール条件]

    使用しない

    ルール条件により、リクエストが特定の基準を満たす場合にのみルールを適用できます。

    • 使用しない:条件付きルールを無効にします。

    • 条件付きルールはルールエンジンで追加または編集できます。

    ヘッダーの置換

    パラメーター

    説明

    [実行内容]

    置換

    ヘッダーの値を置換します。同じ名前のヘッダーが重複して存在する場合、この操作は許可されません。

    [要求ヘッダー]

    カスタムオリジンリクエストヘッダー

    カスタム back-to-origin リクエストヘッダー またはプリセットのリクエストヘッダーを選択します。

    [カスタム要求ヘッダー名]

    x-code

    カスタムリクエストヘッダー名を x-code として指定します。

    [検索]

    key

    置換する値を検索するための正規表現。

    [書き換え後]

    abc

    置換後の値。

    [一致]

    すべて照合

    • [すべてマッチ] 一致したすべての値を置換します。たとえばヘッダー x-code:key1,key2,key3 の場合、正規表現を使用して「key」に一致させ、「abc」に置換すると、結果は x-code:abc1,abc2,abc3 になります。

    • [最初のみマッチ] 最初に一致した値のみを置換します。たとえばヘッダー x-code:key1,key2,key3 の場合、正規表現を使用して「key」に一致させ、「abc」に置換すると、結果は x-code:abc1,key2,key3 になります。

    [ルール条件]

    使用しない

    ルール条件により、リクエストが特定の基準を満たす場合にのみルールを適用できます。

    • 使用しない:条件付きルールを無効にします。

    • 条件付きルールはルールエンジンで追加または編集できます。

  8. OK をクリックします。