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

CDN:送信リクエストヘッダーの設定

最終更新日:Jul 01, 2025

デフォルトでは、Alibaba Cloud CDN は、クライアント IP アドレスなどのリクエストヘッダーをサポートしています。カスタムリクエストヘッダーを設定することもできます。Alibaba Cloud CDN では、オリジンへの送信リクエストで HTTP ヘッダーを追加、削除、変更、または置き換えることができます。

背景情報

HTTP リクエストヘッダーは、HTTP を介して送信されるリクエストのヘッダーセクションのコンポーネントです。送信リクエストヘッダーには、サーバーに送信される特定のパラメーターが含まれています。

配信拠点 (POP) がオリジンサーバーからリクエストされたリソースを取得すると、オリジンサーバーはリクエストヘッダーに含まれる情報を取得できます。CDN では、オリジンリクエストの HTTP ヘッダーを書き換えることができます。リクエストヘッダーに含まれる情報は、特定のビジネス要件を満たすためにオリジンサーバーに渡されます。たとえば、X-Forwarded-For (XFF) ヘッダーを設定して、クライアント IP アドレスをオリジンサーバーに渡すことができます。

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

使用上の注意

  • オリジンリクエストは、Alibaba Cloud CDN によって特定の CDN ドメイン名のオリジンサーバーに送信される HTTP メッセージです。書き換えルールは、オリジンサーバーと POP 間で送信されるリクエストの HTTP ヘッダーのみを書き換えます。書き換えルールは、POP とクライアント間で送信されるリクエストの HTTP ヘッダーを書き換えません。

  • ワイルドカードドメイン名には、カスタムの送信リクエストヘッダーを指定できません。

  • デフォルトでは、Alibaba Cloud CDN は、以下の送信リクエストヘッダーをサポートしており、設定する必要はありません。

    オリジン HTTP ヘッダー

    説明

    Ali-Cdn-Real-Ip

    クライアントが POP に接続するために使用する IP アドレス。

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

    クライアントの IP アドレスと、オリジンサーバーへの接続に使用する POP の IP アドレス。

    X-Forwarded-For:192.168.0.1, 172.16.0.1

    X-Client-Scheme

    クライアントが POP にリクエストを送信するために使用するプロトコル (HTTP または HTTPS など)。

    X-Client-Scheme:http

    Host

    リクエストのリダイレクト先となるオリジンサーバーのドメイン名。

    Host:example.com

    Via

    リクエストが通過するすべての 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 アドレスをオリジンサーバーに渡すヘッダーを追加します。

    Ali-Cdn-Real-Ip:192.168.0.1

    x_forwarded_for

    $proxy_add_x_forwarded_for

    オリジンリクエストに XFF ヘッダーを追加します。XFF ヘッダーは、クライアント IP アドレスとプロキシ IP アドレスをオリジンサーバーに渡します。

    X-Forwarded-For:192.168.0.1, 172.16.0.1

手順

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

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

  3. ドメイン名 ページで、管理するドメイン名を探し、管理 列の アクション をクリックします。

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

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

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

  7. 表示されるダイアログボックスでパラメーターを設定します。

    重要

    同じリクエストヘッダーに対して同時に異なる操作を実行する場合、操作には異なる優先順位があります。操作の優先順位は、[置換] > [追加] > [変更] または [削除] の順に降順で優先されます。たとえば、同じリクエストヘッダーに対して同時に追加操作と削除操作を実行すると、リクエストヘッダーが追加されてから削除されます。

    追加操作のパラメーター

    HTTP请求头信息

    パラメーター

    説明

    実行内容

    追加

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

    要求ヘッダー

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

    プリセットヘッダーを選択するか、[リクエストヘッダー] ドロップダウンリストから カスタム back-to-origin リクエストヘッダー を選択して、リクエストヘッダーを指定できます。

    カスタム要求ヘッダー名

    x-code

    カスタムリクエストヘッダーの名前は x-code です。

    要求ヘッダー値

    key1, key2

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

    重複の許可

    はい

    • はい: 重複するリクエストヘッダーを追加できます。例: x-code:key1 および x-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 をクリックします。