All Products
Search
Document Center

CDN:Abaikan parameter

Last Updated:Aug 15, 2026

Saat Anda mengaktifkan pengabaian parameter, node edge CDN akan menghapus parameter kueri (bagian setelah tanda ?) dari URL permintaan. Hal ini memungkinkan permintaan dengan parameter berbeda untuk mengakses salinan cache yang sama, sehingga meningkatkan rasio hit cache. Topik ini menjelaskan cara mengonfigurasi pengabaian parameter, membandingkannya dengan fitur alternatif, serta memberikan saran penggunaan.

Perbandingan fitur

  • Custom Cache Key bertentangan dengan pengabaian parameter. Jika Anda mengonfigurasi kedua fitur tersebut secara bersamaan, pengabaian parameter tidak berlaku.

  • Custom Cache Key dapat menggantikan pengabaian parameter dalam konfigurasi kunci cache dan menawarkan fungsionalitas yang lebih komprehensif. Kami merekomendasikan untuk menggunakannya terlebih dahulu. Perbandingan konfigurasi:

    Skenario

    Pengabaian parameter

    Custom Cache Key

    Abaikan semua parameter permintaan dalam kunci cache

    Atur Ignore Parameters ke Yes dan biarkan Retain Specified Parameters kosong.

    Tambahkan aturan penanganan parameter permintaan:

    • Action: Retain

    • Parameter name: Atur ke nama parameter yang tidak ada, misalnya example-argument.

    Hanya pertahankan parameter permintaan key1 dalam kunci cache

    Atur Ignore Parameters ke Yes dan atur Retain Specified Parameters ke key1.

    Tambahkan aturan penanganan parameter permintaan:

    • Action: Retain

    • Parameter name: key1

    Hapus hanya parameter permintaan key1 dari kunci cache

    Hapus pengaturan parameter untuk key1.

    Tambahkan aturan penanganan parameter permintaan:

    • Action: Delete

    • Parameter name: key1

  • Rewrite Origin Parameters dapat menggantikan pengabaian parameter dalam penulisan ulang permintaan asal dan menawarkan fungsionalitas yang lebih komprehensif. Kami merekomendasikan untuk menggunakannya terlebih dahulu.

Ikhtisar fitur

Abaikan parameter

Fungsi

Skenario

Menghapus parameter kueri (bagian setelah ?) dari URL permintaan sehingga permintaan dengan parameter berbeda mengakses file cache yang sama. Hal ini meningkatkan rasio hit cache dan mengurangi lalu lintas kembali ke asal.

Aktifkan pengabaian parameter ketika parameter URL tidak terkait dengan konten resource (misalnya UID pengguna, sumber referral, atau kode promo). Sebagai contoh, dua permintaan berikut mengakses resource yang sama tetapi membawa UID berbeda:

Pengguna A: http://example.com/1.jpg?uid=123***

Pengguna B: http://example.com/1.jpg?uid=654***

Tanpa pengabaian parameter, node edge CDN memperlakukan permintaan tersebut sebagai resource berbeda dan tidak dapat berbagi cache yang sama, sehingga memerlukan pengambilan asal untuk setiap permintaan. Dengan pengabaian parameter diaktifkan, node edge CDN menghapus parameter tersebut dan menggunakan http://example.com/1.jpg untuk mencocokkan cache.

Catatan

URL signing memiliki prioritas lebih tinggi daripada pengabaian parameter. Penandatanganan tipe A menyertakan parameter URL dalam signature-nya. CDN melakukan otentikasi terlebih dahulu dan hanya menyimpan replika cache setelah validasi berhasil.

Pertahankan parameter asal

Fungsi

Skenario

Mempertahankan semua parameter URL asli selama pengambilan asal untuk memastikan server asal menerima informasi pengguna yang penting.

Saat pengabaian parameter diaktifkan, node edge CDN secara default menggunakan URL tanpa parameter untuk pengambilan asal. Pada contoh di atas, baik Pengguna A maupun Pengguna B akan memicu permintaan asal ke http://example.com/1.jpg, sehingga kehilangan informasi penting seperti UID. Mengaktifkan Retain Origin Parameters memastikan CDN menggunakan URL asli untuk pengambilan asal, sehingga mempertahankan parameter seperti UID untuk server asal.

Prosedur

  1. Masuk ke CDN console.

  2. Di panel navigasi sebelah kiri, klik Domain Names.

  3. Pada daftar domain, klik nama domain target. Di panel navigasi sebelah kiri, klik Optimization untuk membuka halaman konfigurasi optimasi performa.

  4. Klik Modify pada bagian Ignore Parameters. Pilih mode dan lengkapi konfigurasi sesuai kebutuhan Anda.

  5. Setelah menyelesaikan konfigurasi, klik OK untuk menyimpan.

Penting
  • Mengganti mode akan menghapus konfigurasi yang ada sebelumnya.

  • Setelah mengubah konfigurasi pengabaian parameter, file cache pada node edge tidak diperbarui secara otomatis. Anda harus melakukan URL refresh atau directory refresh di Konsol untuk menerapkan konfigurasi baru dan purge cache lama. Jika tidak, pengguna mungkin masih mengakses konten yang di-cache berdasarkan kebijakan lama, sehingga menyebabkan masalah akses.

Mode: Pertahankan parameter tertentu

Parameter

Deskripsi

Contoh

Ignore Parameters

  • Yes: Aktifkan pengabaian parameter untuk menghapus semua parameter setelah ? dalam URL.

    Catatan

    Jika Anda mengaktifkan Ignore Parameters tetapi membiarkan Retain Specified Parameters kosong, semua parameter setelah ? akan dihapus.

  • No: Nonaktifkan pengabaian parameter untuk mempertahankan semua parameter URL.

Asumsikan URL asli adalah http://example.com/1.jpg?key1=1&key2=2&key3=3. Hasil untuk setiap konfigurasi adalah sebagai berikut:

  • Contoh 1, abaikan semua parameter, jangan pertahankan parameter asal:

    • Konfigurasi: Ignore Parameters=Yes, Retain Specified Parameters kosong, Retain Origin Parameters=No.

    • Kunci cache: http://example.com/1.jpg

    • URL asal: http://example.com/1.jpg

  • Contoh 2, pertahankan parameter tertentu, jangan pertahankan parameter asal:

    • Konfigurasi: Ignore Parameters=Yes, Retain Specified Parameters=key1, Retain Origin Parameters=No.

    • Kunci cache: http://example.com/1.jpg?key1=1

    • URL asal: http://example.com/1.jpg?key1=1

  • Contoh 3, abaikan semua parameter, pertahankan parameter asal:

    • Konfigurasi: Ignore Parameters=Yes, Retain Specified Parameters kosong, Retain Origin Parameters=Yes.

    • Kunci cache: http://example.com/1.jpg

    • URL asal: http://example.com/1.jpg?key1=1&key2=2&key3=3

  • Contoh 4, pertahankan parameter tertentu, pertahankan parameter asal:

    • Konfigurasi: Ignore Parameters=Yes, Retain Specified Parameters=key1, Retain Origin Parameters=Yes.

    • Kunci cache: http://example.com/1.jpg?key1=1

    • URL asal: http://example.com/1.jpg?key1=1&key2=2&key3=3

Retain Specified Parameters

Masukkan nama parameter yang ingin dipertahankan. Anda dapat menentukan hingga 10 parameter, dipisahkan dengan koma (,).

Retain Origin Parameters

  • Yes: Pertahankan semua parameter URL asli selama pengambilan asal.

  • No: Selama pengambilan asal, sertakan hanya parameter yang konsisten dengan kunci hash cache (yaitu, parameter yang dipertahankan).

Rule Condition

Rule condition mengidentifikasi berbagai informasi parameter dalam permintaan pengguna. Hal ini menentukan apakah konfigurasi berlaku untuk permintaan tersebut.

Penting

Saat Anda mereferensikan rule condition, pencocokan dilakukan berdasarkan prioritas rule condition terkait, bukan urutan konfigurasi fitur itu sendiri.

  • Do not use: Tidak menggunakan kondisi aturan.

  • Untuk menambah atau mengedit rule condition, kelola melalui Rules Engine.

Mode: Hapus parameter tertentu

Parameter

Deskripsi

Contoh

Remove Specified Parameters

Masukkan nama parameter yang ingin dihapus. Anda dapat menentukan hingga 10 parameter, dipisahkan dengan spasi.

Asumsikan URL asli adalah http://example.com/1.jpg?key1=1&key2=2&key3=3. Hasil untuk setiap konfigurasi adalah sebagai berikut:

  • Contoh 1, hapus parameter tertentu, jangan pertahankan parameter asal:

    • Konfigurasi: Delete Specified Parameters=key1, Retain Origin Parameters=No.

    • Kunci cache: http://example.com/1.jpg?key2=2&key3=3

    • URL asal: http://example.com/1.jpg?key2=2&key3=3

  • Contoh 2, hapus parameter tertentu, pertahankan parameter asal:

    • Konfigurasi: Delete Specified Parameters=key1, Retain Origin Parameters=Yes.

    • Kunci cache: http://example.com/1.jpg?key2=2&key3=3

    • URL asal: http://example.com/1.jpg?key1=1&key2=2&key3=3

Retain Origin Parameters

  • Yes: Pertahankan semua parameter URL asli selama pengambilan asal.

  • No: Selama pengambilan asal, sertakan hanya parameter yang konsisten dengan kunci hash cache (yaitu, hasil setelah menghapus parameter tertentu).

Rule Condition

Rule condition mengidentifikasi berbagai informasi parameter dalam permintaan pengguna. Hal ini menentukan apakah konfigurasi berlaku untuk permintaan tersebut.

Penting

Saat Anda mereferensikan rule condition, pencocokan dilakukan berdasarkan prioritas rule condition terkait, bukan urutan konfigurasi fitur itu sendiri.

  • Do not use: Tidak menggunakan rule condition.

  • Untuk menambah atau mengedit rule condition, kelola melalui Rules Engine.

Contoh skenario penggunaan

Menggunakan pengabaian parameter untuk mengurangi serangan cache-bypass melalui parameter URL

Saat penyerang atau crawler menambahkan parameter acak yang tidak berarti (seperti ?timestamp=xxx atau ?random=xxx) untuk meminta resource yang sama, CDN memperlakukan setiap permintaan berparameter sebagai resource unik. Hal ini mengurangi rasio hit cache dan meningkatkan lalu lintas kembali ke asal secara signifikan.

Aktifkan pengabaian parameter (atau konfigurasikan agar mengabaikan semua parameter) sehingga permintaan dengan parameter acak berbeda mengakses cache yang sama, sehingga secara efektif mengurangi beban pada origin. Misalnya, setelah mengaktifkan pengabaian parameter, permintaan berikut mengakses cache yang sama:

  • http://example.com/page.html?t=123456

  • http://example.com/page.html?t=789012

  • http://example.com/page.html?random=abc

Dengan pengabaian parameter diaktifkan, semua permintaan tersebut menggunakan http://example.com/page.html untuk mencocokkan cache, sehingga secara efektif mengurangi serangan cache-bypass melalui parameter URL.