Fitur conditional origin menggunakan rules engine untuk memfilter permintaan pengguna berdasarkan kriteria tertentu, seperti header permintaan, parameter query string, path, atau alamat IP klien. CDN merutekan permintaan yang memenuhi kriteria tersebut ke alamat origin tertentu. Anda dapat menambahkan beberapa konfigurasi untuk mengarahkan permintaan ke origin yang berbeda berdasarkan kondisi yang berbeda.
Prasyarat
Sebelum mengonfigurasi conditional origin, pastikan Anda telah membuat Rule Condition di rules engine.
Catatan penggunaan
Konflik fitur: Fitur conditional origin dan advanced origin bersifat saling eksklusif. Anda hanya dapat mengaktifkan salah satunya.
Dukungan wildcard: Di rules engine, nilai pencocokan URI mendukung wildcard
*(cocok dengan jumlah karakter berapa pun) dan?(cocok dengan satu karakter apa pun). Sebaliknya, pencocokan path pada fitur advanced origin hanya mendukung nilai eksak, bukan wildcard.Prioritas aturan dan urutan pencocokan: Conditional origin dievaluasi berdasarkan prioritas Rule Condition terkait di rules engine, bukan berdasarkan urutan konfigurasi conditional origin. Ketika sebuah permintaan cocok dengan suatu aturan, evaluasi akan berhenti. Prioritas aturan di rules engine ditentukan oleh urutan pembuatan; aturan yang dibuat lebih awal memiliki prioritas lebih tinggi. Untuk menyesuaikan prioritas pencocokan, Anda harus menghapus dan membuat ulang aturan sesuai urutan yang diinginkan.
Tips konfigurasi multi-path: Saat membuat aturan untuk "menyertakan" atau "mengecualikan" suatu path, Anda dapat memasukkan beberapa path (dalam beberapa baris atau sebagai beberapa nilai) di bidang nilai pencocokan dalam satu aturan untuk menyederhanakan konfigurasi.
Batas aturan: Jumlah Rule Condition yang dapat direferensikan oleh conditional origin tunduk pada batas global di rules engine. Untuk satu domain, jumlah total referensi ke Rule Condition di semua fitur, termasuk conditional origin, advanced origin, dan Perlindungan hotlink berbasis Referer, tidak boleh melebihi lima. Dalam skenario multi-origin yang kompleks, melampaui batas ini akan menyebabkan kegagalan konfigurasi. Sebaiknya rencanakan penggunaan aturan Anda dengan cermat atau gunakan domain terpisah untuk akselerasi jika Anda memiliki banyak origin.
Pertimbangan untuk origin OSS
Jika origin merupakan bucket OSS, Anda harus menambahkan alamatnya di bawah Domain Names > Basics > Origin Information, lalu mengatur jenis origin ke OSS Domain. Hal ini memungkinkan CDN untuk melakukan autentikasi ke OSS dengan benar.
Skenario multi-OSS origin: Saat mengonfigurasi beberapa OSS origin, Anda harus mengonfigurasi origin Host khusus untuk masing-masing origin. Nilai Host harus sama persis dengan domain bucket OSS yang sesuai, misalnya
dev-3mir.oss-cn-guangzhou.aliyuncs.com.Jika origin Host tidak dikonfigurasi dengan benar atau jika Anda mengandalkan origin Host default, permintaan mungkin dirutekan ke bucket yang salah. Hal ini dapat menyebabkan error 403 SignatureDoesNotMatch atau 404 Not Found. Anda harus secara eksplisit men-bind setiap aturan conditional origin, termasuk aturan pencocokan dan aturan fallback, ke origin dan origin Host yang sesuai. Saat mengonfigurasi beberapa origin, sebaiknya atur bobot yang sama untuk basic origin dan buat Rule Condition terpisah untuk setiap conditional origin guna memastikan perutean yang dapat diprediksi.
Perbandingan jenis origin
Baik conditional origin maupun advanced origin dapat mereferensikan Rule Condition dari rules engine untuk membuat kebijakan perutean origin yang fleksibel. CDN secara otomatis memilih origin jika permintaan cocok dengan Rule Condition:
Tipe Asal | Kondisi pemicu |
conditional origin | Permintaan cocok dengan Rule Condition yang direferensikan oleh conditional origin. |
advanced origin | Permintaan cocok dengan Rule Condition yang direferensikan oleh advanced origin. |
basic origin | Permintaan tidak cocok dengan aturan conditional origin atau advanced origin mana pun (fallback default). |
Failover origin primary/secondary: Setelah permintaan cocok dengan aturan advanced atau conditional origin, CDN melakukan pengambilan asal langsung dari origin yang ditentukan oleh aturan tersebut. Pengaturan prioritas dan bobot basic origin tidak lagi berlaku. Untuk failover origin primary/secondary, konfigurasikan pengaturan prioritas dan bobot basic origin, alih-alih menggunakan aturan conditional origin yang menargetkan satu origin.
Prosedur
-
Masuk ke Konsol CDN.
-
Di panel navigasi kiri, klik Domain Names.
-
Pada halaman Domain Names, temukan nama domain target dan klik Manage di kolom Actions.
Di bagian Origin Information, klik Expand di samping Conditional Origin.
Klik Add Conditional Origin.
Atur Rule Condition.
Jika ini pertama kalinya Anda menambahkan konfigurasi atau perlu memodifikasi Rule Condition yang ada, klik Conditional Origin di kotak dialog Rules Engine. Tindakan ini akan membuka rules engine tempat Anda dapat menambahkan atau memodifikasi konfigurasi. Untuk informasi selengkapnya, lihat rules engine.
Jika Anda sudah memiliki Rule Condition, pilih dari daftar drop-down Rule Condition.
Di bidang Origin Address, masukkan alamat origin. Alamat origin dapat berupa alamat IP, nama domain, bucket OSS, atau endpoint Function Compute (FC).
Klik OK untuk menyelesaikan konfigurasi.
Contoh: Merutekan permintaan /api/* ke FC
Fitur advanced origin hanya mendukung pencocokan nilai eksak dan tidak mendukung wildcard atau ekspresi reguler. Untuk menerapkan perutean origin berbasis path, gunakan conditional origin dengan rules engine. Dengan menggabungkan fitur conditional origin, rules engine, dan Penulisan ulang URL, Anda dapat merutekan permintaan untuk path /api/* ke origin Function Compute (FC), sementara semua permintaan lainnya secara default dirutekan ke origin OSS.
Membuat aturan di rules engine
Navigasi ke Domain Names, temukan domain target, lalu buka halaman Rules Engine.
Klik Add Rule dan konfigurasikan kondisi aturan seperti yang dijelaskan dalam tabel berikut:
Parameter
Nilai
Rule Name
Masukkan nama kustom untuk identifikasi mudah, misalnya
api-to-fc.Jenis pencocokan
URI
Operator pencocokan
Include Any
Nilai pencocokan
Klik Edit, masukkan
*/api/*, lalu tekan Enter untuk menambahkannya. Wildcard*dan?didukung. Satu aturan mendukung hingga 32 nilai pencocokan.Sensitif huruf besar/kecil
Case-insensitive (default)
PentingJangan tambahkan kondisi hostname. Kondisi hostname mencocokkan domain permintaan, bukan origin. Menambahkan kondisi hostname dapat mencegah aturan mencocokkan path setelah Penulisan ulang URL.
Klik Submit untuk menyimpan aturan.
Mengonfigurasi conditional origin
Di panel navigasi kiri, buka Domain Names > Basics. Di bagian Origin Information, klik ikon expand di samping Conditional Origin.
Klik Add Conditional Origin dan konfigurasikan parameter di kotak dialog seperti yang dijelaskan dalam tabel berikut:
Parameter
Nilai
Rule Condition
Dari daftar drop-down, pilih aturan yang Anda buat pada Langkah 1, misalnya
api-to-fc.Origin Address
Masukkan alamat origin Function Compute (FC) Anda.
Klik OK untuk menyimpan konfigurasi.
Mengonfigurasi origin Host
Konfigurasikan origin Host khusus untuk origin FC guna memastikan bahwa CDN mengirimkan permintaan pengambilan asal dengan Header Host yang benar.
Di panel navigasi kiri halaman Domain Names, buka tab Origin Fetch > Configurations.
Di bagian Specify Origin Host, klik Add.
Di kotak dialog, konfigurasikan parameter berikut dan klik OK.
Parameter
Deskripsi
Origin Type
Pilih Custom Origin. Alamat origin yang dikonfigurasi dalam conditional origin tidak muncul di daftar drop-down Basic origin address. Anda harus memilih Custom origin dan memasukkan alamat secara manual.
Origin Address
Masukkan alamat origin FC dari Langkah 2.
Origin Host Type
Pilih jenis nilai Host yang akan digunakan. Untuk origin FC, pilih Custom Origin Host dan masukkan nama domain secara manual.
Origin Host
Masukkan nama domain FC (misalnya,
your-fc-function.cn-hangzhou.fcapp.run).Untuk origin OSS, nilainya harus sama persis dengan domain bucket OSS (misalnya,
dev-3mir.oss-cn-guangzhou.aliyuncs.com).Rule Condition
Opsional. Pilih Rule Condition yang dibuat pada langkah 1 (misalnya,
api-to-fc) untuk membatasi cakupan origin Host ini hanya pada permintaan yang sesuai dengan aturan tersebut.
Anda tidak perlu menonaktifkan origin Host default. Jika origin Host default dan origin Host khusus dikonfigurasi untuk origin yang sama, maka origin Host khusus yang akan berlaku. Untuk origin yang tidak memiliki konfigurasi origin Host khusus, origin Host default tetap berlaku. Untuk informasi selengkapnya, lihat origin Host.
Mengonfigurasi Penulisan ulang URL (opsional)
Jika Anda perlu menulis ulang path /api/ menjadi path /print/api/ pada origin FC, Anda juga harus menggunakan fitur Penulisan ulang URL di CDN:
Di rules engine, konfigurasikan aturan Penulisan ulang URL untuk menulis ulang
/api/menjadi/print/api/.Pastikan kondisi pencocokan URI di rules engine dari Langkah 1 mencakup path yang telah ditulis ulang. Misalnya, gunakan
*/api/*atau cocokkan path spesifik/print/api/*.
Setelah konfigurasi ini selesai, CDN akan merutekan permintaan antarmuka depan ke /api/* ke layanan FC, sementara permintaan lainnya dirutekan ke origin OSS secara default.
Contoh: Perutean berbasis Referer
Contoh berikut menunjukkan cara merutekan permintaan ke origin yang berbeda berdasarkan Header Referer. Hal ini berguna untuk Perlindungan hotlink atau untuk mengontrol akses berdasarkan sumber permintaan.
Membuat kondisi aturan referer
Masuk ke Konsol CDN, pilih domain target, lalu navigasi ke Domain Names > Rules Engine.
Klik Add Rule dan konfigurasikan parameter seperti yang dijelaskan dalam tabel berikut. Rules engine tidak memiliki jenis pencocokan Referer khusus. Anda harus menggunakan jenis pencocokan Request Header untuk menerapkan pencocokan berbasis Referer:
Parameter
Nilai
Rule Name
Masukkan nama deskriptif, misalnya
referer-routing.Jenis pencocokan
Request Header
Nama parameter
RefererOperator pencocokan
Include Any
Nilai pencocokan
example.com. Nilai ini menentukan domain referer. Anda dapat menambahkan multiple domain.Sensitif huruf besar/kecil
Case-insensitive
Klik Submit untuk menyimpan aturan.
Mengonfigurasi conditional origin
Di panel navigasi kiri halaman manajemen domain, buka tab Basics. Di bagian Origin Information, klik ikon expand di samping Conditional Origin.
Klik Add Conditional Origin dan konfigurasikan parameter di kotak dialog seperti yang dijelaskan dalam tabel berikut:
Parameter
Nilai
Rule Condition
Dari daftar drop-down, pilih
referer-routing.Origin Address
Masukkan alamat origin untuk sumber Referer ini.
Klik OK untuk menyimpan konfigurasi.
Contoh: Merutekan pengguna dari Tiongkok daratan dan luar Tiongkok daratan ke origin yang berbeda
Contoh berikut menunjukkan cara menggunakan conditional origin dengan rules engine untuk merutekan pengguna dari Tiongkok daratan dan luar Tiongkok daratan ke server origin yang berbeda.
Masuk ke Konsol CDN. Pada halaman Domain Names, temukan domain target dan klik Manage di kolom Actions. Di panel navigasi kiri, klik Rules Engine, lalu klik Add Rule.
Mengonfigurasi aturan Tiongkok daratan: Di area konten aturan, klik ikon plus untuk menambahkan kondisi pencocokan. Atur Jenis pencocokan ke IP Location, Operator pencocokan ke Include Any, dan klik Modify untuk memilih Chinese mainland dari daftar drop-down sebagai nilai pencocokan. Kirim dan simpan aturan.
Mengonfigurasi aturan luar negeri (fallback): Buat aturan lain. Atur Jenis pencocokan ke IP Location, Operator pencocokan ke Exclude Any, dan atur nilai pencocokan ke Chinese mainland. Kirim dan simpan aturan.
Mengonfigurasi conditional origin: Di bagian Origin Information, asosiasikan setiap aturan dengan origin yang sesuai:
Asosiasikan aturan Tiongkok daratan dengan origin domestik (misalnya, bucket OSS domestik atau server domestik).
Asosiasikan aturan luar negeri dengan origin luar negeri (misalnya, bucket OSS luar negeri atau server luar negeri).
Mengonfigurasi origin Host: Konfigurasikan Origin Host khusus untuk setiap origin guna memastikan nilai Host cocok dengan domain origin yang sesuai.
Di panel navigasi kiri halaman manajemen domain, buka tab Origin Fetch > Configurations. Di bagian Specify Origin Host, klik Add.
Di kotak dialog Specify Origin Host, konfigurasikan parameter berikut. Tambahkan satu entri untuk setiap origin:
Parameter
Nilai
Origin Type
Custom origin. Alamat origin yang dikonfigurasi dalam conditional origin tidak muncul di daftar drop-down Basic origin address. Anda harus memilih Custom origin dan memasukkan alamat secara manual. Jika alamat origin sudah ditambahkan dalam konfigurasi basic origin (misalnya, sebagai origin OSS), Anda juga dapat memilih Basic origin address dan memilihnya dari daftar drop-down.
Origin Address
Masukkan alamat origin yang diasosiasikan dengan conditional origin (misalnya, domain bucket OSS domestik atau luar negeri).
Origin Host Type
Custom origin Host
Origin Host
Masukkan nilai Host yang cocok dengan domain origin (misalnya,
bucket.oss-cn-hangzhou.aliyuncs.com).Rule Condition
Pilih kondisi aturan yang sesuai dengan origin ini (misalnya, aturan Tiongkok daratan atau aturan untuk luar Tiongkok daratan).
Klik OK untuk menyelesaikan konfigurasi.
Anda tidak perlu menonaktifkan origin Host default. Jika origin Host default dan origin Host khusus dikonfigurasi untuk origin yang sama, maka origin Host khusus yang akan berlaku. Untuk origin yang tidak memiliki konfigurasi origin Host khusus, origin Host default tetap berlaku.
Rekomendasi
Untuk skenario di mana pengguna di luar Tiongkok daratan mengalami latensi tinggi atau koneksi tidak stabil saat mengakses origin Tiongkok daratan, sebaiknya gunakan akselerasi transfer OSS untuk mengoptimalkan tautan pengambilan asal. Konfigurasikan sebagai berikut:
Untuk conditional origin Tiongkok daratan, atur origin ke Titik akhir publik standar OSS (misalnya,
bucket.oss-cn-hangzhou.aliyuncs.com).Untuk conditional origin luar negeri, atur origin ke endpoint Akselerasi Transfer OSS (misalnya,
bucket.oss-accelerate.aliyuncs.com).
OSS menggunakan node akselerasi yang terdistribusi secara global untuk mengoptimalkan tautan transfer lintas batas dan dapat mengurangi latensi pengambilan asal secara signifikan. Untuk informasi selengkapnya, lihat Akselerasi Transfer OSS.