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

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

最終更新日:Jun 16, 2025

デフォルトでは、Dynamic Content Delivery Network (DCDN) は、クライアント IP アドレスなどのリクエストヘッダーをサポートしています。カスタムリクエストヘッダーを設定することもできます。Dynamic Content Delivery Network (DCDN) では、オリジンリクエストの HTTP ヘッダーを書き換えることができます。ビジネス要件に基づいて、オリジンリクエストの HTTP ヘッダーを追加、削除、変更、または置き換えることができます。

前提条件

カスタム HTTP リクエストヘッダーを設定するための権限を取得済みであること。デフォルトでは、これは外部ユーザーは利用できません。権限をリクエストするには、チケットを送信する

背景情報

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

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

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

image

使用上の注意

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

  • ワイルドカードドメイン名に対してカスタム HTTP リクエストヘッダーを指定することはできません。

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

    オリジン 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 リクエストヘッダーの値が変数の場合、変数が使用されるときに特定の値が変数に割り当てられます。次の表に、使用可能な変数を示します。

    パラメーター

    オリジン 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. DCDN コンソール にログインします。

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

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

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

  5. [送信リクエストヘッダーの変更] をクリックします。[送信リクエストヘッダーの変更] タブで、[追加] をクリックします。

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

    重要

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

    追加操作のパラメーター

    パラメーター

    説明

    操作

    追加

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

    リクエストヘッダー

    カスタムヘッダー

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

    リクエストヘッダー名

    x-code

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

    ヘッダー値

    key1

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

    key1, key2

    重複を許可

    はい

    • [はい]: 重複するリクエストヘッダーを追加できます。例: x-code:key1 および x-code:key2

    • [いいえ]: 最新のヘッダー値は、同じヘッダー名を使用する既存の値を上書きします。たとえば、x-code:key1 を追加してから x-code:key2 を追加すると、x-code:key2 のみが有効になります。

    削除操作のパラメーター

    パラメーター

    説明

    操作

    削除

    リクエストヘッダーとリクエストヘッダー名パラメーターの値に一致するすべてのリクエストヘッダーを削除します。重複するリクエストヘッダーも削除されます。

    リクエストヘッダー

    カスタムヘッダー

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

    リクエストヘッダー名

    x-code

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

    変更操作のパラメーター

    パラメーター

    説明

    操作

    変更

    重複するリクエストヘッダーが存在しない場合にのみ、変更操作を実行できます。

    リクエストヘッダー

    カスタムヘッダー

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

    リクエストヘッダー名

    x-code

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

    変更後

    key1, key3

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

    置換操作のパラメーター

    パラメーター

    説明

    操作

    置換

    重複するリクエストヘッダーが存在しない場合にのみ、置換操作を実行できます。

    リクエストヘッダー

    カスタムヘッダー

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

    リクエストヘッダー名

    x-code

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

    検索

    キー

    正規表現を使用して、置き換えたい値を検索できます。

    置換

    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 に変更されます。

  7. [OK] をクリックします。

関連 API 操作

BatchSetDcdnDomainConfigs