全部产品
Search
文档中心

ApsaraVideo VOD:Konfigurasi header permintaan HTTP

更新时间:Jul 06, 2025

Secara default, Alibaba Cloud CDN mendukung header permintaan seperti alamat IP klien. Anda juga dapat mengonfigurasi header permintaan kustom. Alibaba Cloud CDN memungkinkan Anda menulis ulang header HTTP dalam permintaan asal. Anda dapat menambah, menghapus, mengubah, atau mengganti header HTTP sesuai kebutuhan bisnis Anda.

Informasi latar belakang

Header permintaan HTTP adalah komponen dari bagian header dalam permintaan yang ditransmisikan melalui HTTP. Header ini mencakup parameter spesifik yang dikirimkan ke server.

Ketika titik kehadiran (POPs) mengambil sumber daya yang diminta dari server asal, server asal dapat memperoleh informasi dari header permintaan. Alibaba Cloud CDN memungkinkan Anda menulis ulang header HTTP pada permintaan asal. Informasi dalam header permintaan tersebut diteruskan ke server asal untuk memenuhi kebutuhan bisnis tertentu. Sebagai contoh, Anda dapat mengonfigurasi header X-Forwarded-For (XFF) guna meneruskan alamat IP klien ke server asal.

Untuk informasi tentang cara server asal memperoleh alamat IP klien dari header XFF dalam permintaan asal, lihat Mengambil Alamat IP Asal Klien.

Catatan penggunaan

  • Permintaan asal adalah pesan HTTP yang ditransmisikan oleh Alibaba Cloud CDN ke server asal dari nama domain akselerasi tertentu. Aturan penulisan ulang hanya memodifikasi header HTTP dalam permintaan yang ditransmisikan antara server asal dan POPs, tetapi tidak memodifikasi header HTTP dalam permintaan antara POPs dan klien.

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

  • Secara default, ApsaraVideo VOD mendukung header permintaan HTTP berikut. Tidak diperlukan konfigurasi tambahan untuk header tersebut.

    Header HTTP asal

    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 asal.

    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 asal ke mana permintaan dialihkan.

    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. Di bilah navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Domain Names.

  3. Di halaman Nama Domain, temukan nama domain yang ingin Anda kelola dan klik Configure di kolom Tindakan.

  4. Di bilah navigasi sebelah kiri nama domain tertentu, klik Back-to-Origin.

  5. Klik tab Origin HTTP Request Headers.

  6. Klik Add dan konfigurasikan parameter.

    Penting

    Ketika beberapa operasi dilakukan pada header permintaan yang sama secara bersamaan, prioritas operasi adalah sebagai berikut: Replace > Add > Change atau Delete. Sebagai contoh, jika Anda melakukan operasi Tambah dan Hapus pada header yang sama, header akan ditambahkan lalu dihapus.

    Parameter operasi Tambah

    HTTP请求头信息

    Parameter

    Contoh

    Deskripsi

    Operation

    Tambah

    Menambahkan header permintaan ke permintaan HTTP asal.

    Request Header

    Header Permintaan Kembali ke Asal Kustom

    Anda dapat memilih header preset, atau memilih Custom Back-to-origin Request Headers dari daftar drop-down Header Permintaan 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 header permintaan. Pisahkan nilai dengan koma (,).

    Allow Duplicates

    Ya

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

    • No: Nilai header terbaru menimpa nilai header yang ada dengan nama header yang sama. Sebagai contoh, jika Anda menambahkan x-code:key1 dan kemudian menambahkan x-code:key2, x-code:key2 akan berlaku.

    Rule Condition

    Jangan gunakan kondisi

    Kondisi aturan dapat mengidentifikasi parameter dalam permintaan untuk menentukan apakah konfigurasi berlaku untuk permintaan.

    • Jangan gunakan kondisi

    • Pilih kondisi aturan yang telah dikonfigurasi di Mesin Aturan.

    Parameter operasi Hapus

    删除

    Parameter

    Contoh

    Deskripsi

    Operation

    Hapus

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

    Request Header

    Header Permintaan Kembali ke Asal Kustom

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

    Header Name

    x-code

    Nama header permintaan kustom adalah x-code.

    Rule Condition

    Jangan gunakan kondisi

    Kondisi aturan dapat mengidentifikasi parameter dalam permintaan untuk menentukan apakah konfigurasi berlaku untuk permintaan.

    • Jangan gunakan kondisi

    • Pilih kondisi aturan yang telah dikonfigurasi di Mesin Aturan.

    Parameter operasi Ubah

    变更

    Parameter

    Contoh

    Deskripsi

    Operation

    Ubah

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

    Request Header

    Header Permintaan Kembali ke Asal Kustom

    Anda dapat memilih header preset, atau memilih Custom Back-to-origin Request Headers dari daftar drop-down Header Permintaan 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 header permintaan. Pisahkan nilai dengan koma (,).

    Rule Condition

    Jangan gunakan kondisi

    Kondisi aturan dapat mengidentifikasi parameter dalam permintaan untuk menentukan apakah konfigurasi berlaku untuk permintaan.

    • Jangan gunakan kondisi

    • Pilih kondisi aturan yang telah dikonfigurasi di Mesin Aturan.

    Parameter operasi Ganti

    替换

    Parameter

    Contoh

    Deskripsi

    Operation

    Ganti

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

    Request Header

    Header Permintaan Kembali ke Asal Kustom

    Anda dapat memilih header preset, atau memilih Custom Back-to-origin Request Headers dari daftar drop-down Header Permintaan 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 cocok menggunakan ekspresi reguler.

    Match

    Cocokkan Semua

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

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

    Rule Condition

    Jangan gunakan kondisi

    Kondisi aturan dapat mengidentifikasi parameter dalam permintaan untuk menentukan apakah konfigurasi berlaku untuk permintaan.

    • Jangan gunakan kondisi

    • Pilih kondisi aturan yang telah dikonfigurasi di Mesin Aturan.

  7. Klik OK.

Contoh Konfigurasi

Contoh 1

Secara default, header XFF dibawa dalam permintaan kembali ke asal. Jika Anda tidak perlu mengubah nama header XFF, tidak diperlukan konfigurasi tambahan.

    Contoh 2

    Secara default, header Ali_Cdn_Real_Ip dibawa dalam permintaan kembali ke asal, dengan nilai berupa alamat IP klien. Jika Anda tidak perlu mengubah nama header Ali_Cdn_Real_Ip, tidak diperlukan konfigurasi tambahan.

    Contoh 3

    Secara default, header Ali_Cdn_Real_Port dibawa dalam permintaan kembali ke asal, dengan nilai berupa port klien. Jika Anda tidak perlu mengubah nama header Ali_Cdn_Real_Port, tidak diperlukan konfigurasi tambahan.

    Referensi

    BatchSetVodDomainConfigs