全部产品
Search
文档中心

ApsaraVideo VOD:Konfigurasikan header permintaan HTTP

更新时间:Feb 11, 2026

Secara default, Alibaba Cloud CDN mendukung header permintaan seperti alamat IP klien. Anda juga dapat mengonfigurasi header permintaan kustom. Alibaba Cloud CDN memungkinkan Anda menambahkan, menghapus, mengubah, atau mengganti Header HTTP dalam permintaan keluar ke origin.

Informasi latar belakang

Header permintaan HTTP merupakan komponen bagian header dalam permintaan yang dikirim melalui HTTP. Header permintaan keluar mencakup parameter spesifik yang dikirim ke server.

Saat Point of Presence (POPs) mengambil sumber daya yang diminta dari server origin, server origin dapat memperoleh informasi yang terdapat dalam header permintaan tersebut. CDN memungkinkan Anda menulis ulang Header HTTP dalam permintaan asal. Informasi dalam header permintaan diteruskan ke server origin untuk memenuhi kebutuhan bisnis tertentu. Sebagai contoh, Anda dapat mengonfigurasi header X-Forwarded-For (XFF) untuk meneruskan alamat IP klien ke server origin Anda.

Untuk informasi tentang cara server origin memperoleh alamat IP klien dari header XFF dalam permintaan asal, lihat Ambil alamat IP asal klien.

image

Catatan penggunaan

  • Permintaan asal adalah pesan HTTP yang dikirim oleh Alibaba Cloud CDN ke server origin dari nama domain yang dipercepat tertentu. Aturan penulisan ulang hanya berlaku pada Header HTTP dalam permintaan antara server origin dan POPs, bukan pada permintaan antara POPs dan klien.

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

  • Secara default, ApsaraVideo VOD mendukung Header HTTP permintaan asal berikut. Anda tidak perlu mengonfigurasinya.

    Header HTTP Origin

    Deskripsi

    Contoh

    Ali-Cdn-Real-Ip

    Alamat IP yang digunakan oleh klien untuk terhubung ke POP.

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

    Alamat IP klien dan alamat IP POP yang digunakan untuk terhubung ke server origin.

    X-Forwarded-For:192.168.0.1, 172.16.0.1

    X-Client-Scheme

    Protokol yang digunakan oleh klien untuk mengirim permintaan ke POP, seperti HTTP atau HTTPS.

    X-Client-Scheme:http

    Host

    Nama domain server origin tempat permintaan diarahkan.

    Host:example.com

    Via

    Nama semua POP yang dilewati oleh permintaan.

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

Prosedur

  1. Masuk ke Konsol ApsaraVideo VOD.

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

  3. Temukan nama domain yang ingin Anda kelola, lalu klik Configure di kolom Actions.

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

  5. Klik tab Origin HTTP Request Headers.

  6. Klik Add dan konfigurasikan header permintaan HTTP asal.

    Penting

    Saat operasi berbeda dilakukan secara bersamaan pada header permintaan yang sama, operasi tersebut memiliki prioritas berbeda. Urutan prioritas operasi dari yang tertinggi ke terendah adalah: Replace > Add > Change atau Delete. Misalnya, jika Anda melakukan operasi Add dan Delete secara bersamaan pada header permintaan yang sama, header tersebut akan ditambahkan lalu dihapus.

    Parameter operasi Add

    HTTP请求头信息

    Parameter

    Contoh

    Deskripsi

    Operation

    Add

    Menambahkan header permintaan ke permintaan HTTP asal.

    Request Header

    Custom Back-to-origin Request Headers

    Anda dapat memilih header preset, atau memilih Custom Back-to-origin Request Headers dari daftar drop-down Request Header untuk menentukan header permintaan.

    Header Name

    x-code

    Nama header permintaan kustom adalah x-code.

    Header Value

    key1, key2

    Anda dapat menentukan beberapa nilai untuk satu header permintaan. Pisahkan nilai-nilai tersebut dengan koma (,).

    Allow Duplicates

    Yes

    • Yes: Anda dapat menambahkan header permintaan duplikat. Contoh: x-code:key1 dan x-code:key2.

    • No: Nilai header terbaru akan menimpa nilai header yang sudah ada dengan nama header yang sama. Misalnya, jika Anda menambahkan x-code:key1 lalu menambahkan x-code:key2, maka x-code:key2 yang berlaku.

    Rule Condition

    Do not use conditions

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

    • Do not use: Jangan gunakan kondisi aturan.

    • Untuk menambah atau mengedit kondisi aturan, kelolanya di Rules Engine.

    Parameter operasi Delete

    删除

    Parameter

    Contoh

    Deskripsi

    Operation

    Delete

    Operasi ini menghapus semua header permintaan yang sesuai dengan nilai parameter Request Header dan Header Name. Header permintaan duplikat juga dihapus.

    Request Header

    Custom Back-to-origin Request Headers

    Anda dapat memilih header preset, atau memilih Custom Back-to-origin Request Headers dari daftar drop-down Request Header untuk menentukan header permintaan.

    Header Name

    x-code

    Nama header permintaan kustom adalah x-code.

    Rule Condition

    Do not use conditions

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

    • Do not use: Jangan gunakan kondisi aturan.

    • Untuk menambah atau mengedit kondisi aturan, kelolanya di Rules Engine.

    Parameter operasi Change

    变更

    Parameter

    Contoh

    Deskripsi

    Operation

    Change

    Anda hanya dapat melakukan operasi Change jika tidak ada header permintaan duplikat.

    Request Header

    Custom Back-to-origin Request Headers

    Anda dapat memilih header preset, atau memilih Custom Back-to-origin Request Headers dari daftar drop-down Request Header untuk menentukan header permintaan.

    Header Name

    x-code

    Nama header permintaan kustom adalah x-code.

    Change Value To

    key1, key3

    Anda dapat menentukan beberapa nilai untuk satu header permintaan. Pisahkan nilai-nilai tersebut dengan koma (,).

    Rule Condition

    Do not use conditions

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

    • Do not use: Jangan gunakan kondisi aturan.

    • Untuk menambah atau mengedit kondisi aturan, kelolanya di Rules Engine.

    Parameter operasi Replace

    替换

    Parameter

    Contoh

    Deskripsi

    Operation

    Replace

    Anda hanya dapat melakukan operasi Replace jika tidak ada header permintaan duplikat.

    Request Header

    Custom Back-to-origin Request Headers

    Anda dapat memilih header preset, atau memilih Custom Back-to-origin Request Headers dari daftar drop-down Request Header untuk menentukan header permintaan.

    Header Name

    x-code

    Nama header permintaan kustom adalah x-code.

    Find

    key

    Anda dapat mencari nilai yang ingin diganti menggunakan ekspresi reguler.

    Replace With

    abc

    Anda dapat mengganti nilai yang sesuai menggunakan ekspresi reguler.

    Match

    Match All

    • Match All: Semua nilai yang sesuai akan diganti. Misalnya, jika Anda menggunakan ekspresi reguler untuk mengganti semua string "key" dalam x-code:key1,key2,key3 dengan abc, pasangan kunci-nilai tersebut berubah menjadi x-code:abc1,abc2,abc3.

    • Match the First Only: Hanya nilai pertama yang sesuai yang diganti. Misalnya, jika Anda menggunakan ekspresi reguler untuk mengganti string "key" pertama dalam x-code:key1,key2,key3 dengan abc, pasangan kunci-nilai tersebut berubah menjadi x-code:abc1,key2,key3.

    Rule Condition

    Do not use conditions

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

    • Do not use: Jangan gunakan kondisi aturan.

    • Untuk menambah atau mengedit kondisi aturan, kelolanya di Rules Engine.

  7. Klik OK untuk menyelesaikan konfigurasi.

Contoh konfigurasi

Contoh 1

Skenario: Tambahkan informasi X-Forwarded-For ke header permintaan asal untuk mengirim alamat IP klien dan alamat IP server proxy ke server origin.

Secara default, header X-Forwarded-For sudah termasuk dalam permintaan kembali-ke-asal. Jika Anda tidak perlu mengubah nama header X-Forwarded-For, tidak diperlukan konfigurasi tambahan.

Metode konfigurasi:

  • Nama header permintaan kustom: X-Forwarded-For.

  • Nilai header: $proxy_add_x_forwarded_for.

配置

  • Nama header permintaan kustom: X-Forwarded-For.

  • Nilai header: $proxy_add_x_forwarded_for.

Contoh 2

Skenario: Tambahkan alamat IP asal klien ke header permintaan asal untuk mengirim alamat IP tersebut ke server origin.

Secara default, header Ali_Cdn_Real_Ip sudah termasuk dalam permintaan kembali-ke-asal, dan nilainya adalah alamat IP asal klien. Jika Anda tidak perlu mengubah nama header Ali_Cdn_Real_Ip, tidak diperlukan konfigurasi tambahan.

Metode konfigurasi:

  • Nama header permintaan kustom: X-Real-IP.

  • Parameter header: $http_Ali_Cdn_Real_Ip.

配置

Contoh 3

Skenario: Tambahkan port asal klien ke header permintaan asal untuk mengirim nomor port ke server origin.

Secara default, header Ali_Cdn_Real_Port sudah termasuk dalam permintaan kembali-ke-asal, dan nilainya adalah port asal klien. Jika Anda tidak perlu mengubah nama header Ali_Cdn_Real_Port, tidak diperlukan konfigurasi tambahan.

Metode konfigurasi:

  • Nama header permintaan kustom: X-Real-Port.

  • Parameter header: $http_Ali_Cdn_Real_Port.

配置

Referensi

Konfigurasi nama domain secara batch