All Products
Search
Document Center

CDN:Modify outgoing request headers

Last Updated:Jun 22, 2026

Secara default, Alibaba Cloud CDN dan mendukung penerusan header permintaan, seperti yang berisi alamat IP klien. Anda juga dapat mengonfigurasi header kustom. Untuk menulis ulang header HTTP dalam permintaan asal (origin requests), Anda dapat memodifikasi outgoing request header. Fitur ini memungkinkan Anda menambahkan, menghapus, mengubah, atau mengganti header permintaan HTTP asal sesuai kebutuhan bisnis Anda.

Informasi latar belakang

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

Ketika 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 header HTTP dalam permintaan asal dan mengirimkan parameter tertentu ke server origin Anda.

Untuk memahami cara server origin mengambil alamat IP klien yang sebenarnya dari header X-Forwarded-For dalam permintaan asal, lihat Obtain the real IP address of a client.

Catatan penggunaan

  • Outgoing request adalah pesan HTTP yang dikirim dari CDN ke server origin. Mengubah konfigurasi outgoing request header hanya memengaruhi pesan HTTP yang dikirim dari CDN ke server origin, bukan pesan HTTP yang langsung dikirim dari POP CDN ke pengguna.

  • Anda tidak dapat memodifikasi outgoing request header untuk nama domain wildcard.

  • Jika fitur ini dikonfigurasi dengan kondisi dari rules engine, urutan eksekusi ditentukan oleh prioritas kondisi aturan, bukan urutan konfigurasi fitur tersebut.

  • Secara default, Alibaba Cloud CDN dan menyertakan header permintaan HTTP berikut dalam permintaan asal tanpa memerlukan konfigurasi tambahan.

    Origin HTTP header

    Description

    Example

    Ali-Cdn-Real-Ip

    Alamat IP asli 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 dilewati permintaan client.

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

  • Jika Anda mengatur nilai outgoing request header ke variabel, variabel tersebut akan diresolusi ke nilai aktualnya pada waktu proses. Variabel berikut tersedia.

    Parameter

    Origin HTTP header

    Description

    Example

    Ali-Cdn-Real-Port

    $http_Ali_Cdn_Real_Port

    Menambahkan port asli client ke header permintaan asal untuk meneruskan informasi port ke server origin.

    Ali-Cdn-Real-Port:80

    Ali-Cdn-Real-Ip

    $http_Ali_Cdn_Real_Ip

    Menambahkan alamat IP asli client ke header permintaan asal untuk meneruskan informasi alamat IP client ke server origin.

    Ali-Cdn-Real-Ip:192.168.0.1

    x_forwarded_for

    $proxy_add_x_forwarded_for

    Menambahkan alamat IP client dan alamat IP server proxy perantara ke header X-Forwarded-For untuk diteruskan ke server origin.

    X-Forwarded-For:192.168.0.1, 172.16.0.1

FAQ

Field header HTTP respons yang diperlukan tidak tersedia

Sebagai proxy perantara, CDN tidak dapat secara langsung menyisipkan header respons HTTP yang hilang, seperti Cache-Control, ke dalam respons untuk memperbaiki kerentanan keamanan. CDN hanya dapat memodifikasi origin request header.

Kami menyarankan Anda mengonfigurasi custom origin request header di Konsol CDN untuk meneruskan parameter yang diperlukan ke server origin Anda, seperti instans CLB. Jika server origin Anda tidak mendukung hal ini atau tidak dapat dimodifikasi, CDN tidak menyediakan cara lain untuk langsung menambahkan header respons.

Catatan

Untuk menambahkan header HTTP ke respons yang dikirim CDN ke klien, lihat Modify outgoing response headers.

Header HTTP kustom dan kecepatan akses

Tidak. Mengonfigurasi custom origin request header di CDN tidak memengaruhi kecepatan akses.

Prosedur

  1. Masuk ke CDN console.

  2. Di panel navigasi kiri, klik Domain Names.

  3. Pada halaman Domain Names, temukan nama domain target lalu klik Manage di kolom Actions.

  4. Di panel navigasi domain, klik Origin Fetch.

  5. Klik tab Modify Outgoing Request Header.

  6. Klik Customize.

  7. Konfigurasikan outgoing request header.

    Penting

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

    Add header

    Parameter

    Example

    Description

    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

    Menentukan 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: Memungkinkan 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 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

    Example

    Description

    Operation

    Delete

    Menghapus semua header yang cocok 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

    Menentukan 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

    Example

    Description

    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

    Menentukan nama header permintaan kustom sebagai x-code.

    Change Value To

    key1, key3

    Anda dapat mengonfigurasi beberapa nilai untuk satu 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

    Example

    Description

    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

    Menentukan nama header permintaan kustom sebagai x-code.

    Find

    key

    Ekspresi reguler untuk mencari 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.

  8. Klik OK.