全部产品
Search
文档中心

:Modifikasi header permintaan keluar

更新时间:Nov 09, 2025

Secara default, Dynamic Content Delivery Network (DCDN) mendukung header permintaan seperti alamat IP klien. Anda juga dapat mengonfigurasi header permintaan kustom. Dynamic Content Delivery Network (DCDN) memungkinkan Anda menulis ulang header HTTP dalam Permintaan asal sesuai kebutuhan bisnis Anda, termasuk menambah, menghapus, mengubah, atau mengganti header HTTP.

Prasyarat

Izin untuk mengonfigurasi header permintaan HTTP kustom harus diperoleh terlebih dahulu. Secara default, fitur ini tidak tersedia untuk pengguna eksternal. Untuk meminta izin, ajukan tiket.

Informasi latar belakang

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

Ketika titik kehadiran (POPs) mengambil sumber daya yang diminta dari server asal, server asal dapat memperoleh informasi yang terdapat dalam header permintaan. Dynamic Content Delivery Network (DCDN) 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 Anda.

Untuk informasi lebih lanjut tentang cara server asal memperoleh alamat IP klien dari header XFF dalam Permintaan asal, lihat Ambil alamat IP asal klien.

Catatan penggunaan

  • Permintaan asal adalah pesan HTTP yang ditransmisikan oleh DCDN 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, DCDN mendukung header permintaan HTTP 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 mengirimkan 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

  • Jika nilai header permintaan HTTP 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 DCDN console.

  2. Di bilah navigasi kiri, klik Domain Names.

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

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

  5. Klik Modify Outgoing Request Header.Pada tab Modify Outgoing Request Header, klik Add.

  6. Konfigurasikan parameter dalam kotak dialog yang muncul.

    Penting

    Jika operasi berbeda dilakukan pada header permintaan yang sama secara bersamaan, prioritas operasi adalah sebagai berikut: Replace > Add > Change/Delete. Sebagai contoh, jika Anda melakukan operasi Add dan Delete pada header permintaan yang sama secara bersamaan, header permintaan akan ditambahkan lalu dihapus.

    Parameter operasi Add

    Parameter

    Contoh

    Deskripsi

    Operasi

    Add

    Menambahkan header permintaan ke permintaan HTTP asal.

    Header Permintaan

    Header Kustom

    Anda dapat memilih header permintaan yang telah ditetapkan sebelumnya, atau memilih Custom Header dari daftar drop-down Header Permintaan untuk menentukan header permintaan.

    Nama Header Permintaan

    x-code

    Nama header permintaan kustom adalah x-code.

    Nilai Header

    key1

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

    key1, key2

    Mengizinkan Duplikat

    Ya

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

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

    Parameter operasi Delete

    Parameter

    Contoh

    Deskripsi

    Operasi

    Delete

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

    Header Permintaan

    Header Kustom

    Anda dapat memilih header permintaan yang telah ditetapkan sebelumnya, atau memilih Custom Header dari daftar drop-down Header Permintaan untuk menentukan header permintaan.

    Nama Header Permintaan

    x-code

    Nama header permintaan kustom adalah x-code.

    Parameter operasi Change

    Parameter

    Contoh

    Deskripsi

    Operasi

    Change

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

    Header Permintaan

    Header Kustom

    Anda dapat memilih header permintaan yang telah ditetapkan sebelumnya, atau memilih Custom Header dari daftar drop-down Header Permintaan untuk menentukan header permintaan.

    Nama Header Permintaan

    x-code

    Nama header permintaan kustom adalah x-code.

    Ubah Menjadi

    key1, key3

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

    Parameter operasi Replace

    Parameter

    Contoh

    Deskripsi

    Operasi

    Replace

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

    Header Permintaan

    Header Kustom

    Anda dapat memilih header permintaan yang telah ditetapkan sebelumnya, atau memilih Custom Header dari daftar drop-down Header Permintaan untuk menentukan header permintaan.

    Nama Header Permintaan

    x-code

    Nama header permintaan kustom adalah x-code.

    Cari

    key

    Anda dapat mencari nilai yang ingin Anda ganti menggunakan ekspresi reguler.

    Ganti Dengan

    abc

    Anda dapat mengganti nilai yang cocok menggunakan ekspresi reguler.

    Cocokkan

    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 diganti. Sebagai contoh, jika Anda menggunakan ekspresi reguler untuk mengganti nilai "key" pertama dalam x-code:key1,key2,key3 dengan "abc", pasangan nilai kunci berubah menjadi x-code:abc1,key2,key3.

  7. Klik OK.

Operasi API Terkait

BatchSetDcdnDomainConfigs