オリジン HTTP リクエストヘッダーの設定 - - Alibaba Cloud ドキュメントセンター

デフォルトでは、Alibaba Cloud DCDN はクライアント IP アドレスなどの情報を含むリクエストヘッダーをサポートしています。カスタムヘッダーも設定可能です。オリジンリクエストをカスタマイズするには、「送信元リクエストヘッダーの変更」機能を使用して、HTTP リクエストヘッダーを追加、削除、変更、または置き換えます。

前提条件

この機能はデフォルトで有効になっていません。ドメインでこの機能を使用するには、まずチケットを送信して、この機能を有効にする必要があります。

背景情報

HTTP リクエストヘッダーは HTTP リクエストメッセージの一部であり、特定のパラメーターをサーバーに渡します。

エッジノードがオリジンサーバーからリソースをリクエストする際、サーバーはオリジンリクエストヘッダー内の情報を読み取ることができます。この機能により、オリジンサーバーに特定のパラメーターを送信するために、オリジンリクエスト内の HTTP リクエストヘッダーを書き換えることができます。

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

注意事項

送信元リクエストとは、 DCDN を通じてオリジンサーバーに送信される HTTP メッセージです。「送信元リクエストヘッダーの変更」の構成は、オリジンサーバーに送信される HTTP メッセージにのみ影響し、ノードから直接ユーザーに提供される HTTP メッセージには影響しません。
ワイルドカードドメイン名に対して送信元リクエストヘッダーを変更することはできません。
送信元リクエストヘッダーの構成がルールエンジンで設定された条件を参照する場合、実行順序はヘッダー構成本体の優先度ではなく、関連付けられたルール条件の優先度に従います。

Alibaba Cloud DCDN は、オリジンリクエストに以下の HTTP リクエストヘッダーをデフォルトで含めており、追加の構成は不要です。

オリジン HTTP ヘッダー	説明	例
Ali-Cdn-Real-Ip	POP への接続におけるクライアントの実際の IP アドレス。	Ali-Cdn-Real-Ip: 192.168.0.1
X-Forwarded-For	クライアントおよび中間エッジノードの 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	クライアントリクエストが通過するすべてのエッジノードの名前。	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	X-Forwarded-For ヘッダーをオリジンリクエストに追加し、クライアント IP アドレスおよび中間プロキシ IP アドレスをオリジンサーバーに渡します。	X-Forwarded-For: 192.168.0.1, 172.16.0.1

操作手順

ドメインのナビゲーションウィンドウで、Back-to-Origin 設定 をクリックします。
[送信元リクエストヘッダーの変更] タブをクリックします。
[送信元リクエストヘッダーの変更] タブで、[追加] をクリックします。

ヘッダー変更のパラメーターを設定します。

重要

同じオリジンリクエストヘッダーに対して複数の競合する操作が設定されている場合、最も優先度の高い操作のみが実行されます。優先度は高から低の順に、[置き換え] > [追加] > [変更/削除] となります。たとえば、同じヘッダーに対して [追加] 操作と [削除] 操作の両方を設定した場合、[追加] 操作のみが実行されます。

リクエストヘッダーの追加

パラメーター	例	説明
操作	追加	指定されたヘッダーをオリジン HTTP リクエストに追加します。
リクエストヘッダー	カスタムヘッダー	プリセットされたリクエストヘッダーを選択するか、[カスタムヘッダー] を選択します。
リクエストヘッダー名	x-code	カスタムリクエストヘッダーの名前。この例では、`x-code` です。
ヘッダー値	key1	1 つ以上の値を指定できます。複数の値を指定する場合は、カンマ (,) で区切ります。
ヘッダー値	key1, key2	1 つ以上の値を指定できます。複数の値を指定する場合は、カンマ (,) で区切ります。
重複を許可	はい	[はい]：重複するリクエストヘッダーの追加を許可します。たとえば、`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` です。
検索	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` になります。

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

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

前提条件

背景情報

注意事項

操作手順

関連 API