全部产品
Search
文档中心

CDN:Konfigurasikan header permintaan keluar

更新时间: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 menambah, menghapus, mengubah, atau mengganti header HTTP dalam permintaan keluar ke server asal.

Informasi latar belakang

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

Ketika point of presence (POP) mengambil sumber daya yang diminta dari server asal, server asal dapat memperoleh informasi yang termasuk dalam header permintaan. CDN memungkinkan Anda menulis ulang header HTTP dalam permintaan asal. Informasi dalam header permintaan diteruskan ke server asal untuk memenuhi persyaratan bisnis tertentu. Sebagai contoh, Anda dapat mengonfigurasi header X-Forwarded-For (XFF) untuk meneruskan alamat IP klien ke server asal Anda.

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 menulis ulang header HTTP dalam permintaan yang ditransmisikan antara server asal dan POP. Aturan tersebut tidak menulis ulang header HTTP dalam permintaan yang ditransmisikan antara POP dan klien.

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

  • Secara default, Alibaba Cloud CDN mendukung header permintaan keluar berikut, yang tidak perlu dikonfigurasi.

    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:contoh.com

    Via

    Nama semua POP yang dilewati permintaan tersebut.

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

  • Jika nilai header permintaan adalah variabel, nilai tertentu akan ditetapkan ke variabel ketika digunakan. Tabel berikut menjelaskan variabel yang tersedia.

    Parameter

    Header HTTP Asal

    Deskripsi

    Contoh

    Ali-Cdn-Real-Port

    $http_Ali_Cdn_Real_Port

    Menambahkan header yang meneruskan port klien ke server asal.

    Ali-Cdn-Real-Port:80

    Ali_Cdn_Real_Ip

    $http_Ali_Cdn_Real_Ip

    Menambahkan header yang meneruskan alamat IP klien ke server asal.

    Ali-Cdn-Real-Ip:192.168.0.1

    x_forwarded_for

    $proxy_add_x_forwarded_for

    Menambahkan header XFF ke permintaan asal. Header XFF meneruskan alamat IP klien dan alamat IP proksi ke server asal.

    X-Forwarded-For:192.168.0.1, 172.16.0.1

Prosedur

  1. Masuk ke Alibaba Cloud CDN.

  2. Di panel navigasi kiri, klik Domain Names.

  3. Pada halaman Domain Names, temukan nama domain yang ingin Anda kelola dan klik Manage di kolom Actions.

  4. Di pohon navigasi kiri nama domain, klik Origin Fetch.

  5. Klik tab Modify Outgoing Request Header.

  6. Klik Customize.

  7. Konfigurasikan parameter di kotak dialog yang muncul.

    Penting

    Ketika operasi berbeda dilakukan pada header permintaan yang sama secara bersamaan, operasi tersebut memiliki prioritas berbeda. Operasi diprioritaskan dalam urutan menurun berikut: Replace > Add > Change atau Delete. Sebagai contoh, jika Anda melakukan operasi Tambah dan Hapus pada header permintaan yang sama secara bersamaan, header permintaan ditambahkan lalu dihapus.

    Parameter operasi Tambah

    HTTP请求头信息

    Parameter

    Contoh

    Deskripsi

    Operation

    Tambah

    Menambahkan header permintaan ke permintaan HTTP asal.

    Request Header

    Header Permintaan Kustom Kembali ke Asal

    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 lalu menambahkan x-code:key2, maka x-code:key2 yang berlaku.

    Rule Condition

    Jangan gunakan kondisi

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

    • 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 Kustom Kembali ke Asal

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

    • 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 Kustom Kembali ke Asal

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

    • 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 Kustom Kembali ke Asal

    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 berubah 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 "key" pertama dalam x-code:key1,key2,key3 dengan abc, pasangan nilai kunci berubah 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 tersebut.

    • Jangan gunakan kondisi

    • Pilih kondisi aturan yang telah dikonfigurasi di Mesin Aturan.

  8. Klik OK.