All Products
Search
Document Center

ApsaraVideo VOD:Konfigurasikan header permintaan HTTP

Last Updated:Jun 19, 2026

Secara default, CDN dan Alibaba Cloud mendukung penerusan header permintaan, termasuk yang berisi alamat IP klien. Anda juga dapat mengonfigurasi header kustom. Untuk menulis ulang header HTTP dalam permintaan asal, Anda dapat memodifikasi header permintaan keluar. Fitur ini memungkinkan Anda menambahkan, menghapus, mengubah, atau mengganti header permintaan HTTP asal guna memenuhi kebutuhan bisnis Anda.

Informasi latar belakang

Header permintaan HTTP merupakan bagian dari pesan permintaan HTTP dan digunakan untuk mengirimkan informasi parameter tertentu ke server.

Saat titik kehadiran (POP) CDN atau mengirim permintaan ke server origin untuk mengambil sumber daya, server origin dapat mengakses informasi dalam header permintaan tersebut. Anda dapat menggunakan fitur ini untuk menulis ulang informasi header HTTP dalam permintaan asal dan mengirimkan parameter tertentu ke server origin Anda.

Untuk mempelajari cara server origin mengambil alamat IP klien sebenarnya dari header X-Forwarded-For dalam permintaan asal, lihat Dapatkan alamat IP sebenarnya dari klien.

Catatan

  • Permintaan keluar adalah pesan HTTP yang dikirim dari CDN ke server origin. Memodifikasi konfigurasi header permintaan keluar hanya memengaruhi pesan HTTP yang dikirim dari CDN ke server origin. Konfigurasi ini tidak memengaruhi pesan HTTP yang langsung disajikan dari POP CDN ke pengguna.

  • Anda tidak dapat memodifikasi header permintaan keluar untuk nama domain wildcard.

  • ApsaraVideo VOD meneruskan header permintaan HTTP back-to-origin berikut secara default. Tidak diperlukan konfigurasi tambahan.

    Origin HTTP header

    Deskripsi

    Contoh

    Ali-Cdn-Real-Ip

    Alamat IP sebenarnya dari client yang terhubung ke POP CDN atau .

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

    Alamat IP client dan semua POP CDN atau perantara dalam jalur permintaan asal.

    X-Forwarded-For:192.168.0.1, 172.16.0.1

    X-Client-Scheme

    Protokol lapisan aplikasi, seperti HTTP atau HTTPS, yang digunakan client untuk mengirim permintaan ke POP CDN atau .

    X-Client-Scheme:http

    Host

    Nama domain website origin yang diakses oleh permintaan asal.

    Host:example.com

    Via

    Nama semua POP CDN atau yang dilalui permintaan client.

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

Prosedur

  1. Masuk ke Konsol ApsaraVideo VOD.

  2. Pada panel navigasi kiri, pilih Configuration Management > CDN Configuration > Domain Names.

  3. Temukan nama domain yang diinginkan dan klik Configure pada kolom Actions.

  4. Pada panel navigasi kiri halaman detail domain, klik Back-to-Origin.

  5. Klik tab Back-to-origin HTTP Request Header.

  6. Klik Add dan konfigurasikan pengaturan header.

    Penting

    Jika Anda mengonfigurasi operasi berbeda untuk header permintaan asal yang sama, terjadi konflik, dan operasi dengan prioritas tertinggi yang akan dijalankan. Urutan prioritasnya adalah: Replace > Add > Change dan Delete.

    Add header

    Parameter

    Contoh

    Deskripsi

    Operation

    Add

    Menambahkan header permintaan yang ditentukan ke permintaan asal.

    Request Header

    Custom Origin Request Header

    Pilih Custom Back-to-origin Request Headers atau header permintaan preset.

    Header Name

    x-code

    Menetapkan nama header permintaan kustom sebagai x-code.

    Header Value

    key1, key2

    Anda dapat mengonfigurasi beberapa nilai untuk satu header permintaan. Pisahkan beberapa nilai dengan koma (,).

    Allow Duplicates

    Yes

    • Yes: Mengizinkan penambahan header permintaan duplikat. Misalnya, x-code:key1 dan x-code:key2.

    • No: Jika Anda menambahkan header dengan nama yang sama, nilai baru akan menimpa nilai yang sudah ada. Misalnya, jika Anda pertama kali menambahkan x-code:key1 lalu menambahkan x-code:key2, nilai akhirnya adalah x-code:key2.

    Rule Condition

    Do not use

    Kondisi aturan mengidentifikasi berbagai parameter dalam permintaan pengguna untuk menentukan apakah suatu konfigurasi berlaku untuk permintaan tertentu.

    Penting

    Saat Anda menggunakan kondisi aturan, pencocokan didasarkan pada prioritas kondisi aturan terkait, bukan urutan konfigurasi fitur itu sendiri.

    • Do not use: Tidak menggunakan kondisi aturan.

    • Untuk menambah atau mengedit kondisi aturan, buka rules engine.

    Delete header

    Parameter

    Contoh

    Deskripsi

    Operation

    Delete

    Menghapus semua header yang sesuai dengan nama yang ditentukan, termasuk duplikatnya.

    Request Header

    Custom Origin Request Header

    Pilih Custom Back-to-origin Request Headers atau header permintaan preset.

    Header Name

    x-code

    Menetapkan nama header permintaan kustom sebagai x-code.

    Rule Condition

    Do not use

    Kondisi aturan memungkinkan aturan diterapkan hanya ketika permintaan memenuhi kriteria tertentu.

    • Do not use: Menonaktifkan aturan kondisional.

    • Anda dapat menambah atau mengedit aturan kondisional di Rules engine.

    Change header

    Parameter

    Contoh

    Deskripsi

    Operation

    Change

    Mengubah nilai header. Operasi ini tidak diizinkan jika terdapat header duplikat dengan nama yang sama.

    Request Header

    Custom Origin Request Header

    Pilih Custom Back-to-origin Request Headers atau header permintaan preset.

    Header Name

    x-code

    Menetapkan nama header permintaan kustom sebagai x-code.

    Change Value To

    key1, key3

    Anda dapat mengonfigurasi beberapa nilai untuk header permintaan. Pisahkan beberapa nilai dengan koma (,).

    Rule Condition

    Do not use

    Kondisi aturan memungkinkan aturan diterapkan hanya ketika permintaan memenuhi kriteria tertentu.

    • Do not use: Menonaktifkan aturan kondisional.

    • Anda dapat menambah atau mengedit aturan kondisional di Rules engine.

    Replace header

    Parameter

    Contoh

    Deskripsi

    Operation

    Replace

    Mengganti nilai header. Operasi ini tidak diizinkan jika terdapat header duplikat dengan nama yang sama.

    Request Header

    Custom Origin Request Header

    Pilih Custom Back-to-origin Request Headers atau header permintaan preset.

    Header Name

    x-code

    Menetapkan nama header permintaan kustom sebagai x-code.

    Find

    key

    Ekspresi reguler untuk menemukan nilai yang akan diganti.

    Replace With

    abc

    Nilai pengganti.

    Match

    Match All

    • Match All: Mengganti semua nilai yang cocok. Misalnya, untuk header x-code:key1,key2,key3, jika Anda menggunakan ekspresi reguler untuk mencocokkan "key" dan menggantinya dengan "abc", hasilnya adalah x-code:abc1,abc2,abc3.

    • Match the First Only: Hanya mengganti nilai pertama yang cocok. Misalnya, untuk header x-code:key1,key2,key3, jika Anda menggunakan ekspresi reguler untuk mencocokkan "key" dan menggantinya dengan "abc", hasilnya adalah x-code:abc1,key2,key3.

    Rule Condition

    Do not use

    Kondisi aturan memungkinkan aturan diterapkan hanya ketika permintaan memenuhi kriteria tertentu.

    • Do not use: Menonaktifkan aturan kondisional.

    • Anda dapat menambah atau mengedit aturan kondisional di Rules engine.

  7. Klik OK untuk menyelesaikan konfigurasi.

Contoh

Contoh 1

Skenario: Tambahkan header X-Forwarded-For ke permintaan back-to-origin untuk meneruskan IP klien dan IP server proxy perantara ke server origin.

ApsaraVideo VOD menyertakan header X-Forwarded-For dalam permintaan back-to-origin secara default. Tidak diperlukan konfigurasi kecuali jika Anda ingin mengubah nama headernya.

Konfigurasi:

  • Custom Header Name: X-Forwarded-For

  • Header Value: $proxy_add_x_forwarded_for

Pada kotak dialog Back-to-origin HTTP Request Header, atur Header Operation ke Add, Custom Request Header Parameter ke Custom back-to-origin request header, dan Allow Duplicates ke Do not allow. Lalu, klik OK.

  • Custom request header name: X-Forwarded-For.

  • Request header value: $proxy_add_x_forwarded_for.

Contoh 2

Skenario: Tambahkan header ke permintaan back-to-origin untuk meneruskan alamat IP klien sebenarnya ke server origin.

ApsaraVideo VOD menyertakan header Ali-Cdn-Real-Ip dalam permintaan back-to-origin secara default. Header ini berisi alamat IP klien sebenarnya. Tidak diperlukan konfigurasi kecuali jika Anda ingin mengubah nama headernya.

Konfigurasi:

  • Custom Header Name: X-Real-IP

  • Header Value: $http_Ali_Cdn_Real_Ip

Atur Header Operation ke Add, Custom Request Header Parameter ke Custom back-to-origin request header, dan Allow Duplicates ke Do not allow. Lalu, klik OK.

Contoh 3

Skenario: Tambahkan header ke permintaan back-to-origin untuk meneruskan port klien sebenarnya ke server origin.

ApsaraVideo VOD menyertakan header Ali-Cdn-Real-Port dalam permintaan back-to-origin secara default. Header ini berisi port klien sebenarnya. Tidak diperlukan konfigurasi kecuali jika Anda ingin mengubah nama headernya.

Konfigurasi:

  • Custom Header Name: X-Real-Port

  • Header Value: $http_Ali_Cdn_Real_Port

Atur Header Operation ke Add, Custom Request Header Parameter ke Custom back-to-origin request header, dan Allow Duplicates ke Do not allow. Lalu, klik OK.

Dokumen terkait

Konfigurasikan nama domain secara batch