All Products
Search
Document Center

:Modifikasi header permintaan keluar

Last Updated:Apr 25, 2026

Secara default, DCDN Alibaba Cloud mendukung header permintaan yang membawa informasi seperti alamat IP klien. Anda juga dapat mengonfigurasi header khusus. Untuk menyesuaikan permintaan origin, gunakan fitur Modify Outgoing Request Header guna menambahkan, menghapus, mengubah, atau mengganti header permintaan HTTP.

Prasyarat

Fitur ini tidak diaktifkan secara default. Untuk menggunakannya pada suatu domain, Anda harus terlebih dahulu submit a ticket agar fitur tersebut diaktifkan.

Latar Belakang

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

Saat titik kehadiran (POP) meminta sumber daya dari server origin, server tersebut dapat membaca informasi dalam header permintaan origin. Fitur ini memungkinkan Anda menulis ulang header permintaan HTTP dalam permintaan origin guna mengirimkan parameter tertentu ke server origin.

Untuk memahami cara server origin membaca alamat IP klien dari header X-Forwarded-For, lihat Obtain the client IP address.

Catatan penggunaan

  • Permintaan keluar adalah pesan HTTP yang dikirim kembali ke server origin melalui DCDN. Konfigurasi modifikasi header permintaan keluar hanya berlaku pada pesan HTTP yang dikirim kembali ke server origin dan tidak memengaruhi pesan HTTP yang langsung disajikan kepada pengguna dari node.

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

  • Jika konfigurasi header permintaan keluar mereferensikan kondisi yang ditetapkan di mesin aturan, urutan eksekusinya mengikuti prioritas kondisi aturan terkait, bukan prioritas konfigurasi header itu sendiri.

  • DCDN Alibaba Cloud secara default menyertakan header permintaan HTTP berikut dalam permintaan origin tanpa memerlukan konfigurasi tambahan.

    Header HTTP origin

    Deskripsi

    Contoh

    Ali-Cdn-Real-Ip

    Alamat IP asli klien untuk koneksi ke POP.

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

    Alamat IP klien dan semua POP perantara.

    X-Forwarded-For:192.168.0.1, 172.16.0.1

    X-Client-Scheme

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

    X-Client-Scheme:http

    Host

    Nama domain dari server asal yang diakses dalam permintaan asal.

    Host:example.com

    Via

    Nama semua POP yang dilalui oleh permintaan klien.

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

  • Jika Anda menetapkan nilai header permintaan keluar ke variabel, variabel tersebut akan diselesaikan menjadi nilai aktualnya saat waktu proses. Variabel berikut tersedia.

    Parameter

    Header HTTP origin

    Deskripsi

    Contoh

    Ali-Cdn-Real-Port

    $http_Ali_Cdn_Real_Port

    Menambahkan port asli klien ke header permintaan origin.

    Ali-Cdn-Real-Port:80

    Ali-Cdn-Real-Ip

    $http_Ali_Cdn_Real_Ip

    Menambahkan alamat IP asli klien ke header permintaan origin.

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

    $proxy_add_x_forwarded_for

    Menambahkan header X-Forwarded-For ke permintaan origin untuk meneruskan alamat IP klien dan alamat IP proksi perantara ke server origin.

    X-Forwarded-For:192.168.0.1, 172.16.0.1

Prosedur

  1. Di panel navigasi domain, klik Origin Fetch.

  2. Klik tab Modify Outgoing Request Header.

  3. Di tab Modify Outgoing Request Header, klik Add.

  4. Konfigurasikan parameter untuk modifikasi header.

    Penting

    Jika beberapa operasi yang saling bertentangan menargetkan header permintaan origin yang sama, hanya operasi dengan prioritas tertinggi yang dieksekusi. Urutan prioritas dari tertinggi ke terendah adalah: Replace > Add > Change/Delete. Misalnya, jika Anda mengonfigurasi operasi Add dan Delete untuk header yang sama, hanya operasi Add yang dieksekusi.

    Tambahkan header permintaan

    Parameter

    Contoh

    Deskripsi

    Operation

    Add

    Menambahkan header yang ditentukan ke permintaan HTTP origin.

    Request header

    Custom header

    Pilih header permintaan preset atau pilih Custom header.

    Request header name

    x-code

    Nama header permintaan kustom. Dalam contoh ini, x-code.

    Header value

    key1

    Anda dapat menentukan satu atau beberapa nilai. Pisahkan beberapa nilai dengan koma (,).

    key1, key2

    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 dengan header yang sudah ada, nilai baru akan menimpa nilai lama. Misalnya, jika Anda pertama kali menambahkan x-code:key1 lalu menambahkan x-code:key2, header akhirnya adalah x-code:key2.

    Hapus header permintaan

    Parameter

    Contoh

    Deskripsi

    Operation

    Delete

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

    Request header

    Custom header

    Pilih header permintaan preset atau pilih Custom header.

    Request header name

    x-code

    Nama header permintaan kustom. Dalam contoh ini, x-code.

    Ubah header permintaan

    Parameter

    Contoh

    Deskripsi

    Operation

    Change

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

    Request header

    Custom header

    Pilih header permintaan preset atau pilih Custom header.

    Request header name

    x-code

    Nama header permintaan kustom. Dalam contoh ini, x-code.

    Change to

    key1, key3

    Anda dapat menentukan satu atau beberapa nilai. Pisahkan beberapa nilai dengan koma (,).

    Ganti header permintaan

    Parameter

    Contoh

    Deskripsi

    Operation

    Replace

    Mengganti sebagian nilai header menggunakan ekspresi reguler. Operasi ini tidak diizinkan jika terdapat beberapa header dengan nama yang sama.

    Request header

    Custom header

    Pilih header permintaan preset atau pilih Custom header.

    Request header name

    x-code

    Nama header permintaan kustom. Dalam contoh ini, x-code.

    Find

    key

    Ekspresi reguler untuk mencari nilai yang akan diganti.

    Replace with

    abc

    String untuk menggantikan teks yang cocok. Referensi balik ekspresi reguler didukung.

    Match

    Match All

    • Match All: Mengganti semua nilai yang cocok. Misalnya, jika Anda mengganti "key" dengan "abc" dalam x-code:key1,key2,key3, hasilnya adalah x-code:abc1,abc2,abc3.

    • Match the First Only: Hanya mengganti nilai pertama yang cocok. Misalnya, jika Anda mengganti "key" dengan "abc" dalam x-code:key1,key2,key3, hasilnya adalah x-code:abc1,key2,key3.

  5. Klik OK.

API Terkait

BatchSetDcdnDomainConfigs