All Products
Search
Document Center

Edge Security Acceleration:Custom Cache Key

Last Updated:Feb 11, 2026

Anda dapat mengonfigurasi custom cache key dengan membuat aturan yang menghasilkan kunci cache berdasarkan bagian-bagian berbeda dari permintaan HTTP, seperti URI, parameter permintaan, header permintaan HTTP, atau variabel kustom. Fitur ini menyatukan permintaan untuk file yang sama ke dalam satu kunci cache, sehingga mencegah permintaan identik di-cache sebagai file terpisah. Akibatnya, tingkat hit cache meningkat, pengambilan asal (origin fetches) berkurang, serta waktu respons dan konsumsi bandwidth menurun.

Kasus Penggunaan

Penting

Fitur custom cache key hanya memodifikasi pengidentifikasi cache suatu permintaan dan tidak mengubah URL pengambilan asal (origin fetch). Konten permintaan pengambilan asal tetap sama dengan permintaan klien.

Kunci cache adalah pengidentifikasi unik untuk file yang di-cache pada titik kehadiran DCDN. Secara default, kunci cache menggunakan URL permintaan klien, termasuk parameter kueri.

Kasus Penggunaan 1

Klien mengirim permintaan dengan parameter kueri yang kompleks. Meskipun beberapa permintaan mengakses file yang sama, nilai parameter yang berbeda menyebabkan titik kehadiran DCDN memperlakukannya sebagai permintaan untuk file yang berbeda. Akibatnya, DCDN menyimpan beberapa salinan dan meningkatkan jumlah pengambilan asal.图一

Gunakan aturan custom cache key untuk menyatukan kunci cache dari permintaan serupa. Hal ini mengurangi pengambilan asal.图二

Kasus Penggunaan 2

Klien mengirim URL yang identik. DCDN memperlakukan permintaan tersebut sebagai permintaan untuk file yang sama. Namun, header HTTP mencakup bidang client yang membedakan sistem klien. Anda ingin DCDN memperlakukan permintaan ini sebagai file yang berbeda.场景一

Tambahkan nilai header client ke kunci cache. DCDN kemudian memperlakukan kedua permintaan tersebut sebagai memiliki kunci cache yang berbeda.场景二

Prosedur

  1. Masuk ke DCDN console.

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

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

  4. Di pohon navigasi sebelah kiri domain, klik Caching.

  5. Pada tab Custom Cache Key, konfigurasikan custom cache key.

    Catatan

    Anda dapat memodifikasi URI, parameter kueri, dan header HTTP. Anda juga dapat mendefinisikan variabel kustom untuk mengekstraksi bidang dari permintaan. Kunci cache akhir menggabungkan empat bagian: URI, operasi parameter, header HTTP, dan variabel kustom.

    自定义Cachekey

    Parameter Type

    Operation Description

    Rule Condition

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

    • Do not use: Jangan gunakan kondisi aturan.

    • Untuk menambah atau mengedit kondisi aturan, kelola di Rules Engine.

    URIs

    Jika URI permintaan klien sesuai dengan Source URI yang dikonfigurasi, DCDN mengganti URI asal dengan Final URI yang dikonfigurasi untuk menghasilkan kunci cache.

    Anda dapat mengonfigurasi beberapa aturan penggantian URI. DCDN menerapkannya secara berurutan dari atas ke bawah. Ketika menemukan kecocokan dengan Source URI, DCDN menggunakan Final URI yang sesuai dan berhenti memeriksa aturan selanjutnya.

    • Source URI: URI yang diawali garis miring (/). Tidak boleh mencakup awalan http:// atau nama domain. Mendukung ekspresi reguler PCRE.

    • Final URI: URI yang diawali garis miring (/) dan tidak mencakup awalan http:// atau nama domain.

    Parameter Actions

    Operasi ini diterapkan pada parameter kueri dalam URL permintaan asli klien. Anda dapat Add, Delete, Modify, atau Reserve parameter. Hasil operasi ini ditambahkan ke kunci cache. Anda dapat mengonfigurasi beberapa operasi. DCDN menerapkannya secara berurutan dari atas ke bawah.

    • Add: Menambahkan parameter kueri baru ke kunci cache. Misalnya, jika URL asli adalah http://image.example.com/cat.jpg dan Anda menambahkan type=jpg, kunci cache menjadi http://image.example.com/cat.jpg?type=jpg.

    • Delete: Menghapus parameter kueri tertentu dari URL asli saat menghasilkan kunci cache. Misalnya, jika URL asli adalah http://image.example.com/cat.jpg?type=jpg dan Anda menghapus parameter type, kunci cache menjadi http://image.example.com/cat.jpg.

    • Modify: Memodifikasi parameter tertentu dalam URL permintaan asli saat menghasilkan kunci cache. Misalnya, jika URL asli adalah http://image.example.com/cat.jpg?type=jpg dan Anda memodifikasi parameter menjadi type=png, kunci cache adalah.

    • Reserve: Hanya menyimpan parameter kueri tertentu dari URL asli saat menghasilkan kunci cache. Misalnya, jika URL asli adalah http://image.example.com/cat.jpg?type=jpg&path=image dan Anda hanya menyimpan parameter type, kunci cache menjadi http://image.example.com/cat.jpg?type=jpg.

    HTTP Headers

    Menambahkan nilai header HTTP tertentu dari permintaan asli klien ke kunci cache. Anda dapat menentukan beberapa nama header HTTP, dipisahkan dengan spasi. DCDN menambahkan nilainya ke kunci cache secara berurutan.

    Misalnya, jika URL asli adalah http://image.example.com/cat.jpg dan klien mengirim header HTTP path:image, serta Anda menetapkan path dalam konfigurasi HTTP Headers, kunci cache menjadi http://image.example.com/cat.jpgimage.

    Custom Variables

    Gunakan ekspresi reguler untuk mencocokkan nilai dari parameter permintaan, header HTTP, cookie, atau URI dalam permintaan asli klien. Jika ekspresi reguler cocok, tambahkan nilai yang cocok ke kunci cache. Untuk detailnya, lihat Contoh Konfigurasi.

  6. Klik OK untuk menyelesaikan konfigurasi.

Contoh Konfigurasi

URIs

Permintaan untuk http://aliyundoc.com/a/b/image.jpg dan http://aliyundoc.com/a/b/c/image.jpg merujuk ke file yang sama. Kunci cache-nya adalah http://aliyundoc.com/c/image.jpg.URI

Parameter Actions

Permintaan klien http://aliyundoc.com/a/b/image.jpg?delete_par=1&modify_par=1 menambahkan add_par=1, menghapus delete_par, dan memodifikasi modify_par menjadi 2. Kunci cache akhir adalah http://aliyundoc.com/a/b/image.jpg?modify_par=2&add_par=1.

Penting

Dalam operasi parameter, jika Anda menerapkan beberapa operasi pada variabel yang sama, urutan penerapannya adalah: add > delete > keep > modify.

参数操作

HTTP Headers

Nilai header HTTP User-Agent dan Accept-Language dari permintaan klien ditambahkan ke kunci cache. Misalnya, jika permintaan untuk http://aliyundoc.com/a/b/image.jpg berisi header User-Agent=Mozilla/5.0 (Linux; X11) dan Accept-Language=en, kunci cache untuk permintaan tersebut adalah http://aliyundoc.com/a/b/image.jpgMozilla/5.0(Linux;X11)en.HTTP Header

Custom Variables

Contoh 1

Nama variabel adalah language. Sumbernya adalah Request Header. Nama bidang sumber adalah Accept-Language. Pola pencocokan adalah ([%w]+),([%w]+). Ekspresi variabel adalah $1aa.自定义变量

Untuk permintaan klien http://aliyundoc.com/a/b/image.jpg dengan header HTTP Accept-Language=en,ch , pola mencocokkan en dan menetapkannya ke $1. Ekspresi variabel menambahkan aa, menghasilkan nilai variabel enaa. Variabel ini, dengan alias language, kemudian ditambahkan ke URL untuk membentuk kunci cache akhir: http://aliyundoc.com/a/b/image.jpgenaa.

Catatan

Dalam ekspresi variabel, $n merujuk pada konten yang dicocokkan oleh pasangan tanda kurung ke-n dalam aturan pencocokan. Misalnya, dalam Contoh 1, Accept-Language=en,ch, aturan pencocokannya adalah ([%w]+),([%w]+). Oleh karena itu, $1=en dan $2=ch.

Contoh 2

Nama variabel adalah expired. Sumbernya adalah Request Cookie. Nama bidang sumber adalah a. Aturan pencocokan adalah [%w]+:(.*). Ekspresi variabel adalah $1.Custom variable

Untuk permintaan klien http://aliyundoc.com/a/b/image.jpg dengan cookie Cookie a=expired_time:12635187, pola mencocokkan 12635187 dan menetapkannya ke $1. Variabel ini, dengan alias expired, kemudian ditambahkan ke URL untuk membentuk kunci cache akhir: http://aliyundoc.com/a/b/image.jpg12635187.

Contoh 3

Konfigurasikan aturan URI dan variabel kustom sekaligus.

  • URI:

    Cocokkan semua URI yang mengikuti pola /abc/.*/abc dan ganti dengan /abc.示例三

  • Variabel kustom:

    Nama variabel adalah testname. Sumbernya adalah Path. Pola pencocokan adalah /abc/xyz/(.*). Ekspresi variabel adalah $1.示例三

    Untuk URL permintaan klien http://aliyundoc.com/abc/xyz/abc/image.jpg, aturan URI memodifikasi kunci cache menjadi http://aliyundoc.com/abc/image.jpg. Aturan variabel kustom kemudian mencocokkan /abc/xyz/(.*). Dalam kasus ini, $1 sama dengan abc. DCDN menambahkan nilai ini ke kunci cache yang telah dimodifikasi untuk membentuk kunci cache akhir: http://aliyundoc.com/abc/image.jpgabc. Kombinasi aturan ini mendukung logika caching yang lebih kompleks.

    Jika tidak ada variabel kustom yang cocok, DCDN tidak menambahkan ekspresi variabel $1 ke kunci cache.