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

ApsaraVideo VOD:HTTP リクエストヘッダーの設定

最終更新日:Mar 01, 2026

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

背景情報

HTTP リクエストヘッダーは、HTTP 経由で送信されるリクエストのヘッダー部に含まれる要素です。送信リクエストヘッダーには、サーバーに送信される特定のパラメーターが含まれます。

ポイント・オブ・プレゼンス(POP)がオリジンサーバーから要求されたリソースを取得する際、オリジンサーバーはリクエストヘッダーに含まれる情報を取得できます。CDN を使用すると、オリジンリクエストにおける HTTP ヘッダーを再書き込みできます。リクエストヘッダーに含まれる情報は、特定のビジネス要件を満たすためにオリジンサーバーに渡されます。たとえば、X-Forwarded-For(XFF)ヘッダーを設定することで、クライアントの IP アドレスをオリジンサーバーに転送できます。

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

image

注意事項

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

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

  • デフォルトでは、ApsaraVideo VOD はオリジンリクエストに対して以下の 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

操作手順

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

  2. 左側のナビゲーションウィンドウで、構成管理 > CDN 構成 > ドメイン を選択します。

  3. 管理対象のドメイン名を検索し、[操作] 列の 設定 をクリックします。

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

  5. オリジン HTTP リクエストヘッダー タブをクリックします。

  6. 追加 をクリックし、オリジン HTTP リクエストヘッダーを設定します。

    重要

    同一のリクエストヘッダーに対して同時に複数の操作を実行する場合、操作には優先順位があります。優先順位は、以下の順に高いものから低いものへと並びます:置き換え > 追加 > 変更 または 削除。たとえば、同一のリクエストヘッダーに対して「追加」と「削除」を同時に実行した場合、まずヘッダーが追加され、その後削除されます。

    追加操作のパラメーター

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

    ルール条件

    条件を使用しない

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

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

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

  7. OK をクリックして設定を完了します。

設定例

例 1

シナリオ:X-Forwarded-For 情報をオリジンリクエストヘッダーに追加し、クライアントの IP アドレスおよびプロキシサーバーの IP アドレスをオリジンサーバーに送信します。

デフォルトでは、X-Forwarded-For ヘッダーがオリジンサーバーへのアクセスリクエストに含まれています。X-Forwarded-For ヘッダーの名前を変更する必要がない場合は、追加の設定は不要です。

設定方法

  • カスタムリクエストヘッダー名:X-Forwarded-For。

  • ヘッダー値:$proxy_add_x_forwarded_for。

配置

  • カスタムリクエストヘッダー名:X-Forwarded-For。

  • ヘッダー値:$proxy_add_x_forwarded_for。

例 2

シナリオ:クライアントの送信元 IP アドレスをオリジンリクエストヘッダーに追加し、IP アドレスをオリジンサーバーに送信します。

デフォルトでは、Ali_Cdn_Real_Ip ヘッダーがオリジンサーバーへのアクセスリクエストに含まれており、その値はクライアントの送信元 IP アドレスです。Ali_Cdn_Real_Ip ヘッダーの名前を変更する必要がない場合は、追加の設定は不要です。

設定方法

  • カスタムリクエストヘッダー名:X-Real-IP。

  • ヘッダー値:$http_Ali_Cdn_Real_Ip。

配置

例 3

シナリオ:クライアントの送信元ポートをオリジンリクエストヘッダーに追加し、ポート番号をオリジンサーバーに送信します。

デフォルトでは、Ali_Cdn_Real_Port ヘッダーがオリジンサーバーへのアクセスリクエストに含まれており、その値はクライアントの送信元ポートです。Ali_Cdn_Real_Port ヘッダーの名前を変更する必要がない場合は、追加の設定は不要です。

設定方法

  • カスタムリクエストヘッダー名:X-Real-Port。

  • ヘッダー値:$http_Ali_Cdn_Real_Port。

配置

参照

ドメイン名の一括構成