All Products
Search
Document Center

CDN:Mengonfigurasi conditional origin

Last Updated:Oct 16, 2026

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

  1. Masuk ke Konsol CDN.

  2. Di panel navigasi kiri, klik Domain Names.

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

  4. Di bagian Origin Information, klik Expand di samping Conditional Origin.

  5. Klik Add Conditional Origin.

  6. 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.

  7. Di bidang Origin Address, masukkan alamat origin. Alamat origin dapat berupa alamat IP, nama domain, bucket OSS, atau endpoint Function Compute (FC).

  8. 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

  1. Navigasi ke Domain Names, temukan domain target, lalu buka halaman Rules Engine.

  2. 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)

    Penting

    Jangan tambahkan kondisi hostname. Kondisi hostname mencocokkan domain permintaan, bukan origin. Menambahkan kondisi hostname dapat mencegah aturan mencocokkan path setelah Penulisan ulang URL.

  3. Klik Submit untuk menyimpan aturan.

Mengonfigurasi conditional origin

  1. Di panel navigasi kiri, buka Domain Names > Basics. Di bagian Origin Information, klik ikon expand di samping Conditional Origin.

  2. 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.

  3. 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.

  1. Di panel navigasi kiri halaman Domain Names, buka tab Origin Fetch > Configurations.

  2. Di bagian Specify Origin Host, klik Add.

  3. 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:

  1. Di rules engine, konfigurasikan aturan Penulisan ulang URL untuk menulis ulang /api/ menjadi /print/api/.

  2. 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

  1. Masuk ke Konsol CDN, pilih domain target, lalu navigasi ke Domain Names > Rules Engine.

  2. 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

    Referer

    Operator pencocokan

    Include Any

    Nilai pencocokan

    example.com. Nilai ini menentukan domain referer. Anda dapat menambahkan multiple domain.

    Sensitif huruf besar/kecil

    Case-insensitive

  3. Klik Submit untuk menyimpan aturan.

Mengonfigurasi conditional origin

  1. Di panel navigasi kiri halaman manajemen domain, buka tab Basics. Di bagian Origin Information, klik ikon expand di samping Conditional Origin.

  2. 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.

  3. 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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).

  5. 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.