All Products
Search
Document Center

CDN:Konfigurasikan asal bersyarat

Last Updated:Aug 28, 2026

Fitur asal bersyarat menggunakan mesin aturan untuk menyaring permintaan pengguna berdasarkan kriteria tertentu, seperti header permintaan, parameter string kueri, path, atau alamat IP klien. CDN mengarahkan permintaan yang sesuai dengan kriteria tersebut ke alamat origin tertentu. Anda dapat menambahkan beberapa konfigurasi untuk mengarahkan permintaan ke origin berbeda berdasarkan kondisi yang berbeda.

Prasyarat

Sebelum mengonfigurasi asal bersyarat, Anda harus membuat Rule Condition di mesin aturan.

Catatan penggunaan

  • Konflik fitur: Fitur asal bersyarat dan fitur asal lanjutan saling eksklusif. Anda hanya dapat mengaktifkan salah satu.

  • Dukungan wildcard: Di mesin aturan, nilai pencocokan URI mendukung wildcard * (mencocokkan sejumlah karakter apa pun) dan ? (mencocokkan satu karakter apa pun). Pencocokan path di fitur asal lanjutan hanya mendukung nilai eksak, bukan wildcard.

  • Prioritas aturan dan urutan pencocokan: Asal bersyarat dievaluasi berdasarkan prioritas Rule Condition terkait di mesin aturan, bukan berdasarkan urutan konfigurasi asal bersyarat. Ketika suatu permintaan cocok dengan suatu aturan, evaluasi dihentikan. Prioritas aturan di mesin aturan ditentukan oleh urutan pembuatan: aturan yang dibuat lebih awal memiliki prioritas lebih tinggi. Untuk menyesuaikan prioritas pencocokan, Anda harus menghapus dan membuat ulang aturan dalam 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 satu aturan untuk menyederhanakan konfigurasi Anda.

  • Batas aturan: Jumlah Rule Condition yang dapat direferensikan oleh asal bersyarat tunduk pada batas global di mesin aturan. Untuk satu domain, jumlah total referensi ke Rule Condition di seluruh fitur—termasuk asal bersyarat, asal lanjutan, dan Perlindungan hotlink berbasis Referer—tidak boleh melebihi lima. Dalam skenario multi-origin yang kompleks, melebihi batas ini menyebabkan konfigurasi gagal. Kami menyarankan agar Anda merencanakan penggunaan aturan secara cermat atau menggunakan domain terpisah untuk akselerasi jika Anda memiliki banyak origin.

Pertimbangan untuk origin OSS

  • Jika suatu origin adalah bucket OSS, Anda harus menambahkan alamatnya di bawah Domain Names > Basics > Origin Information dan mengatur jenis origin ke OSS Domain. Hal ini memungkinkan CDN melakukan autentikasi dengan OSS secara benar.

  • Skenario multi-origin OSS: Saat mengonfigurasi beberapa origin OSS, Anda harus mengonfigurasi origin Host spesifik untuk masing-masing. Nilai Host harus persis sama dengan domain bucket OSS yang sesuai, seperti dev-3mir.oss-cn-guangzhou.aliyuncs.com.

    Jika origin Host tidak dikonfigurasi dengan benar atau Anda mengandalkan origin Host default, permintaan mungkin diarahkan ke bucket yang salah. Hal ini dapat menyebabkan error 403 SignatureDoesNotMatch atau 404 Not Found. Anda harus secara eksplisit mengikat setiap aturan asal bersyarat—termasuk aturan pencocokan dan aturan fallback—ke origin dan origin Host yang sesuai. Saat mengonfigurasi beberapa origin, kami menyarankan untuk mengatur bobot yang sama untuk origin dasar dan membuat Rule Condition terpisah untuk setiap asal bersyarat guna memastikan routing yang dapat diprediksi.

Perbandingan jenis origin

Baik asal bersyarat maupun asal lanjutan dapat mereferensikan Rule Condition dari mesin aturan untuk membuat kebijakan routing origin yang fleksibel. CDN secara otomatis memilih suatu origin jika permintaan sesuai dengan Rule Condition:

Tipe asal

Kondisi pemicu

asal bersyarat

Permintaan sesuai dengan Rule Condition yang direferensikan oleh asal bersyarat.

asal lanjutan

Permintaan sesuai dengan Rule Condition yang direferensikan oleh asal lanjutan.

asal dasar

Permintaan tidak sesuai dengan aturan asal bersyarat atau asal lanjutan mana pun (fallback default).

Prosedur

  1. Masuk ke CDN console.

  2. Di panel navigasi kiri, klik Domain Names.

  3. Di halaman Domain Names, temukan nama domain target lalu 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 kali Anda menambahkan konfigurasi atau perlu memodifikasi Rule Condition yang ada, klik Conditional Origin di kotak dialog Rules Engine. Hal ini membuka mesin aturan tempat Anda dapat menambahkan atau memodifikasi konfigurasi. Untuk informasi selengkapnya, lihat mesin aturan.

    • Jika Anda memiliki Rule Condition yang sudah ada, 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 titik akhir Function Compute (FC).

  8. Klik OK untuk menyelesaikan konfigurasi.

Contoh: Mengarahkan permintaan /api/* ke FC

Fitur asal lanjutan hanya mendukung pencocokan nilai eksak dan tidak mendukung wildcard atau ekspresi reguler. Untuk menerapkan routing origin berbasis path, gunakan asal bersyarat dengan mesin aturan. Dengan menggabungkan fitur asal bersyarat, mesin aturan, dan Penulisan ulang URL, Anda dapat mengarahkan permintaan untuk path /api/* ke origin Function Compute (FC), sedangkan semua permintaan lainnya diarahkan secara default ke origin OSS.

Buat aturan di mesin aturan

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

  2. Klik Add Rule dan konfigurasikan kondisi aturan seperti pada tabel berikut:

    Parameter

    Nilai

    Rule Name

    Masukkan nama kustom untuk memudahkan identifikasi, misalnya api-to-fc.

    Match type

    URI

    Match operator

    Include Any

    Match value

    Klik Edit, masukkan */api/*, lalu tekan Enter untuk menambahkannya. Wildcard * dan ? didukung. Satu aturan mendukung hingga 32 nilai pencocokan.

    Case sensitive

    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.

Konfigurasikan asal bersyarat

  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 pada tabel berikut:

    Parameter

    Nilai

    Rule Condition

    Dari daftar drop-down, pilih aturan yang Anda buat di Langkah 1, misalnya api-to-fc.

    Origin Address

    Masukkan alamat origin Function Compute (FC) Anda.

  3. Klik OK untuk menyimpan konfigurasi.

Konfigurasikan origin Host

Konfigurasikan origin Host spesifik untuk origin FC guna memastikan CDN mengirim 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 lalu klik OK.

    Parameter

    Deskripsi

    Origin Type

    Pilih Custom Origin. Alamat origin yang dikonfigurasi di asal bersyarat 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 persis sama dengan domain bucket OSS (misalnya, dev-3mir.oss-cn-guangzhou.aliyuncs.com).

    Rule Condition

    Opsional. Pilih Rule Condition yang dibuat di langkah 1 (misalnya, api-to-fc) untuk membatasi origin Host ini hanya pada permintaan yang sesuai dengan aturan tersebut.

Anda tidak perlu menonaktifkan origin Host default. Saat origin Host default dan origin Host untuk origin tertentu dikonfigurasi untuk origin yang sama, origin Host untuk origin tertentu yang berlaku. Untuk origin yang tidak memiliki origin Host spesifik yang dikonfigurasi, origin Host default tetap berlaku. Untuk informasi selengkapnya, lihat origin Host.

Konfigurasikan Penulisan ulang URL (opsional)

Jika Anda perlu menulis ulang path /api/ menjadi path /print/api/ di origin FC Anda, Anda juga harus menggunakan fitur Penulisan ulang URL di CDN:

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

  2. Pastikan kondisi pencocokan URI di mesin aturan dari Langkah 1 mencakup path yang telah ditulis ulang. Misalnya, gunakan */api/* atau cocokkan path spesifik /print/api/*.

Setelah menyelesaikan konfigurasi ini, CDN mengarahkan permintaan antarmuka depan ke /api/* ke layanan FC, sedangkan permintaan lainnya diarahkan ke origin OSS secara default.

Contoh: Routing berbasis Referer

Contoh berikut menunjukkan cara mengarahkan permintaan ke origin berbeda berdasarkan header Referer. Ini berguna untuk Perlindungan hotlink atau mengontrol akses berdasarkan sumber permintaan.

Buat kondisi aturan referer

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

  2. Klik Add Rule dan konfigurasikan parameter seperti pada tabel berikut. Mesin aturan tidak memiliki tipe pencocokan Referer khusus. Anda harus menggunakan tipe pencocokan Request Header untuk menerapkan pencocokan berbasis Referer:

    Parameter

    Nilai

    Rule Name

    Masukkan nama deskriptif, misalnya referer-routing.

    Match type

    Request Header

    Parameter name

    Referer

    Match operator

    Include Any

    Match value

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

    Case sensitive

    Case-insensitive

  3. Klik Submit untuk menyimpan aturan.

Konfigurasikan asal bersyarat

  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 pada 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: Mengarahkan pengguna dari Tiongkok daratan dan luar Tiongkok daratan ke origin berbeda

Contoh berikut menunjukkan cara menggunakan asal bersyarat dengan mesin aturan untuk mengarahkan pengguna dari Tiongkok daratan dan luar Tiongkok daratan ke server origin berbeda.

  1. Masuk ke CDN console. Di halaman Domain Names, temukan domain target lalu klik Manage di kolom Actions. Di panel navigasi kiri, klik Rules Engine, lalu klik Add Rule.

  2. Konfigurasikan aturan Tiongkok daratan: Di area konten aturan, klik ikon plus untuk menambahkan kondisi pencocokan. Atur Match type ke IP Location, Match operator ke Include Any lalu klik Modify untuk memilih Tiongkok daratan dari daftar drop-down sebagai nilai pencocokan. Kirim dan simpan aturan tersebut.

  3. Konfigurasikan aturan luar negeri (fallback): Buat aturan lain. Atur Match type ke IP Location, Match operator ke Exclude Any, lalu atur nilai pencocokan ke Tiongkok daratan. Kirim dan simpan aturan tersebut.

  4. Konfigurasikan asal bersyarat: Di bagian Origin Information, kaitkan setiap aturan dengan origin yang sesuai:

    • Kaitkan aturan Tiongkok daratan dengan origin domestik (misalnya, bucket OSS domestik atau server domestik).

    • Kaitkan aturan luar negeri dengan origin luar negeri (misalnya, bucket OSS luar negeri atau server luar negeri).

  5. Konfigurasikan origin Host: Konfigurasikan Origin Host khusus untuk setiap origin guna memastikan nilai Host sesuai 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 di asal bersyarat tidak muncul di daftar drop-down Basic origin address. Anda harus memilih Custom origin dan memasukkan alamat secara manual. Jika alamat origin sudah ditambahkan di konfigurasi origin dasar (misalnya, sebagai origin OSS), Anda juga dapat memilih Basic origin address dan memilihnya dari daftar drop-down.

    Origin Address

    Masukkan alamat origin yang dikaitkan dengan asal bersyarat (misalnya, domain bucket OSS domestik atau luar negeri).

    Origin Host Type

    Custom origin Host

    Origin Host

    Masukkan nilai Host yang sesuai 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. Saat origin Host default dan origin Host untuk origin tertentu dikonfigurasi untuk origin yang sama, origin Host untuk origin tertentu yang berlaku. Untuk origin yang tidak memiliki origin Host spesifik yang dikonfigurasi, origin Host default tetap berlaku.

Rekomendasi

Untuk skenario di mana pengguna luar Tiongkok daratan mengalami latensi tinggi atau koneksi tidak stabil saat mengakses origin Tiongkok daratan, kami menyarankan menggunakan akselerasi transfer OSS untuk mengoptimalkan tautan pengambilan asal. Konfigurasikan sebagai berikut:

  • Untuk asal bersyarat Tiongkok daratan, atur origin ke titik akhir publik standar OSS (misalnya, bucket.oss-cn-hangzhou.aliyuncs.com).

  • Untuk asal bersyarat luar negeri, atur origin ke titik akhir Akselerasi Transfer OSS (misalnya, bucket.oss-accelerate.aliyuncs.com).

OSS menggunakan node akselerasi yang tersebar secara global untuk mengoptimalkan tautan transfer lintas batas dan dapat secara signifikan mengurangi latensi pengambilan asal. Untuk informasi selengkapnya, lihat Akselerasi Transfer OSS.