Tüm Ürünler
Search
Belge Merkezi

CDN:Koşullu kaynak yapılandırma

Son Güncelleme:Oct 10, 2026

Koşullu kaynak özelliği, kurallar motorunu kullanarak kullanıcı isteklerini istek üstbilgileri, sorgu dizesi parametreleri, yollar veya istemci IP adresleri gibi belirtilen kriterlere göre filtreler. CDN, kriterlerle eşleşen istekleri belirli bir kaynak adresine yönlendirir. Farklı koşullara bağlı olarak istekleri farklı kaynaklara yönlendirmek için birden fazla yapılandırma ekleyebilirsiniz.

Ön koşullar

Koşullu kaynak yapılandırmadan önce, kurallar motorunda bir Kural Koşulu oluşturmanız gerekir.

Kullanım notları

  • Özellik çakışması: Koşullu kaynak ve gelişmiş kaynak özellikleri birbirini dışlar. Yalnızca birini etkinleştirebilirsiniz.

  • Joker karakter desteği: Kurallar motorunda URI eşleştirme değeri * (herhangi sayıda karakteri eşleştirir) ve ? (tek bir karakteri eşleştirir) joker karakterlerini destekler. Gelişmiş kaynak özelliğindeki yol eşleştirme yalnızca tam değerleri destekler, joker karakterleri desteklemez.

  • Kural önceliği ve eşleştirme sırası: Koşullu kaynaklar, koşullu kaynak yapılandırmalarının sırasına göre değil, kurallar motorundaki ilişkili Kural Koşulunun önceliğine göre değerlendirilir. Bir istek bir kural ile eşleştiğinde değerlendirme durur. Kurallar motorundaki kural önceliği oluşturma sırasına göre belirlenir: daha önce oluşturulan kuralların önceliği daha yüksektir. Eşleştirme önceliğini ayarlamak için kuralları istediğiniz sırayla silip yeniden oluşturmanız gerekir.

  • Çoklu yol yapılandırma ipucu: Bir yolu "dahil etme" veya "hariç tutma" amaçlı kurallar oluştururken, yapılandırmanızı basitleştirmek için tek bir kuralın eşleştirme değeri alanına birden fazla yol girebilirsiniz (birden fazla satırda veya birden fazla değer olarak).

  • Kural limiti: Bir koşullu kaynağın referans alabileceği Kural Koşulu sayısı, kurallar motorundaki genel bir limite tabidir. Tek bir etki alanı için, koşullu kaynak, gelişmiş kaynak ve Referer tabanlı hotlink koruması dahil tüm özelliklerdeki Kural Koşullarına yapılan toplam referans sayısı beşi aşamaz. Karmaşık çoklu kaynak senaryolarında bu limitin aşılması yapılandırmanın başarısız olmasına neden olur. Çok sayıda kaynağınız varsa kural kullanımınızı dikkatli planlamanızı veya hızlandırma için ayrı etki alanları kullanmanızı öneririz.

OSS kaynakları için dikkat edilmesi gerekenler

  • Kaynak bir OSS paketi ise adresini Domain Names > Basics > Origin Information altında eklemeniz ve kaynak türünü OSS Domain olarak ayarlamanız gerekir. Bu, CDN'nin OSS ile doğru şekilde kimlik doğrulaması yapmasını sağlar.

  • Çoklu OSS kaynak senaryoları: Birden fazla OSS kaynağı yapılandırdığınızda her biri için belirli bir kaynak Host'u yapılandırmanız gerekir. Host değeri ilgili OSS paket etki alanıyla tam olarak eşleşmelidir; örneğin dev-3mir.oss-cn-guangzhou.aliyuncs.com.

    Kaynak Host'u doğru yapılandırılmazsa veya varsayılan kaynak Host'una güvenilirse istekler yanlış pakete yönlendirilebilir. Bu durum 403 SignatureDoesNotMatch veya 404 Not Found hatalarına neden olabilir. Eşleştirme kuralları ve yedekleme kuralları dahil her koşullu kaynak kuralını karşılık gelen kaynağına ve kaynak Host'una açıkça bağlamanız gerekir. Birden fazla kaynak yapılandırırken temel kaynaklar için eşit ağırlıklar ayarlamanızı ve öngörülebilir yönlendirme sağlamak amacıyla her koşullu kaynak için ayrı Kural Koşulları oluşturmanızı öneririz.

Kaynak türü karşılaştırması

Hem koşullu kaynaklar hem de gelişmiş kaynaklar esnek kaynak yönlendirme ilkeleri oluşturmak için kurallar motorundan Kural Koşullarına referans verebilir. Bir istek bir Kural Koşuluyla eşleşirse CDN otomatik olarak bir kaynak seçer:


Kaynak türü


Tetikleme koşulu


koşullu kaynak


İstek koşullu kaynak tarafından referans alınan Kural Koşuluyla eşleşir.


gelişmiş kaynak


İstek gelişmiş kaynak tarafından referans alınan Kural Koşuluyla eşleşir.


temel kaynak


İstek hiçbir koşullu kaynak veya gelişmiş kaynak kuralıyla eşleşmez (varsayılan yedekleme).

Birincil/ikincil kaynak yük devretme: Bir istek gelişmiş veya koşullu kaynak kuralıyla eşleştikten sonra CDN doğrudan o kural tarafından belirtilen kaynaktan kaynak getirir. Temel kaynakların öncelik ve ağırlık ayarları artık geçerli değildir. Birincil/ikincil kaynak yük devretme için bir kaynağı hedef alan bir koşullu kaynak kuralı yerine temel kaynakların öncelik ve ağırlık ayarlarını yapılandırın.

Yordam

  1. CDN konsoluna giriş yapın.

  2. Sol gezinme bölmesinde Domain Names seçeneğine tıklayın.

  3. Domain Names sayfasında hedef etki alanını bulun ve Actions sütunundaki Manage seçeneğine tıklayın.

  4. Origin Information bölümünde Conditional Origin yanındaki Expand seçeneğine tıklayın.

  5. Add Conditional Origin seçeneğine tıklayın.

  6. Rule Condition değerini belirtin.

    • İlk kez bir yapılandırma ekliyorsanız veya mevcut bir Kural Koşulunu değiştirmeniz gerekiyorsa Rules Engine iletişim kutusunda Conditional Origin seçeneğine tıklayın. Bu işlem yapılandırma ekleyebileceğiniz veya değiştirebileceğiniz kurallar motorunu açar. Daha fazla bilgi için bkz. kurallar motoru.

    • Mevcut bir Kural Koşulunuz varsa bunu Rule Condition açılır listesinden seçin.

  7. Origin Address alanına kaynak adresini girin. Kaynak adresi bir IP adresi, etki alanı adı, OSS paketi veya Function Compute (FC) uç noktası olabilir.

  8. Yapılandırmayı tamamlamak için OK seçeneğine tıklayın.

Örnek: /api/* isteklerini FC'ye yönlendirme

Gelişmiş kaynak özelliği yalnızca tam değer eşleştirmeyi destekler ve joker karakterleri veya düzenli ifadeleri desteklemez. Yol tabanlı kaynak yönlendirmesi uygulamak için kurallar motoruyla birlikte koşullu kaynakları kullanın. Koşullu kaynak özelliğini kurallar motoru ve URL yeniden yazma ile birleştirerek /api/* yoluna yönelik istekleri Function Compute (FC) kaynağına yönlendirebilir diğer tüm istekleri varsayılan olarak OSS kaynağına yönlendirebilirsiniz.

Kurallar motorunda bir kural oluşturun

  1. Domain Names bölümüne gidin hedef etki alanını bulun ve Rules Engine sayfasına gidin.

  2. Add Rule seçeneğine tıklayın ve aşağıdaki tabloda açıklandığı gibi kural koşulunu yapılandırın:


    Parametre


    Değer


    Rule Name


    Kolay tanımlama için özel bir ad girin; örneğin api-to-fc.


    Eşleştirme türü


    URI


    Eşleştirme işleci


    Include Any


    Eşleştirme değeri


    Edit seçeneğine tıklayın */api/* girin ve eklemek için Enter tuşuna basın. * ve ? joker karakterleri desteklenir. Tek bir kural en fazla 32 eşleştirme değerini destekler.


    Büyük/küçük harfe duyarlı


    Case-insensitive (varsayılan)

    Önemli

    Bir ana makine adı koşulu eklemeyin. Ana makine adı koşulu istek etki alanını eşleştirir kaynağı değil. Bir ana makine adı koşulu eklemek URL yeniden yazma sonrasında kuralın yolu eşleştirmesini engelleyebilir.

  3. Kuralı kaydetmek için Submit seçeneğine tıklayın.

Koşullu kaynağı yapılandırın

  1. Soldaki gezinme bölmesinde Domain Names > Basics bölümüne gidin. Origin Information bölümünde Conditional Origin yanındaki genişlet simgesine tıklayın.

  2. Add Conditional Origin seçeneğine tıklayın ve iletişim kutusundaki parametreleri aşağıdaki tabloda açıklandığı gibi yapılandırın:


    Parametre


    Değer


    Rule Condition


    Açılır listeden 1. Adımda oluşturduğunuz kuralı seçin; örneğin api-to-fc.


    Origin Address


    Function Compute (FC) kaynağınızın adresini girin.

  3. Yapılandırmayı kaydetmek için OK seçeneğine tıklayın.

Kaynak Host'unu yapılandırın

CDN'nin kaynak getirme isteklerini doğru Host üstbilgisiyle göndermesini sağlamak için FC kaynağına özel bir kaynak Host'u yapılandırın.

  1. Domain Names sayfasının sol gezinme bölmesinde Origin Fetch > Configurations sekmesine gidin.

  2. Specify Origin Host bölümünde Add seçeneğine tıklayın.

  3. İletişim kutusunda aşağıdaki parametreleri yapılandırın ve OK seçeneğine tıklayın.


    Parametre


    Açıklama


    Origin Type


    Custom Origin seçeneğini belirleyin. Koşullu kaynaklarda yapılandırılan kaynak adresleri Basic origin address açılır listesinde görünmez. Custom origin seçeneğini belirleyip adresi manuel olarak girmeniz gerekir.


    Origin Address


    2. Adımdaki FC kaynak adresini girin.


    Origin Host Type


    Kullanılacak Host değeri türünü seçin. FC kaynakları için Custom Origin Host seçeneğini belirleyin ve etki alanı adını manuel olarak girin.


    Origin Host

    FC etki alanı adını girin (örneğin your-fc-function.cn-hangzhou.fcapp.run).

    OSS kaynakları için değer OSS paket etki alanıyla tam olarak eşleşmelidir (örneğin dev-3mir.oss-cn-guangzhou.aliyuncs.com).


    Rule Condition


    İsteğe bağlı. Bu kaynak Host'unu kural ile eşleşen isteklerle sınırlamak için 1. adımda oluşturulan Kural Koşulunu seçin (örneğin api-to-fc).

Varsayılan kaynak Host'unu devre dışı bırakmanız gerekmez. Aynı kaynak için hem varsayılan kaynak Host'u hem de belirli bir kaynağa ait kaynak Host'u yapılandırıldığında belirli kaynağa ait kaynak Host'u geçerli olur. Belirli bir kaynak Host'u yapılandırılmamış kaynaklar için varsayılan kaynak Host'u yürürlükte kalır. Daha fazla bilgi için bkz. kaynak Host'u.

URL yeniden yazmayı yapılandırın (isteğe bağlı)

/api/ yolunu FC kaynağınızda /print/api/ yoluna yeniden yazmanız gerekiyorsa CDN'deki URL yeniden yazma özelliğini de kullanmanız gerekir:

  1. Kurallar motorunda /api/ yolunu /print/api/ yoluna yeniden yazan bir URL yeniden yazma kuralı yapılandırın.

  2. Adımdaki kurallar motorundaki URI eşleştirme koşulunun yeniden yazılan yolu kapsadığından emin olun. Örneğin */api/* kullanın veya /print/api/* gibi belirli yolu eşleştirin.

Bu yapılandırmaları tamamladıktan sonra CDN ön uç isteklerini /api/* için FC hizmetine yönlendirir diğer istekleri ise varsayılan olarak OSS kaynağına yönlendirir.

Örnek: Referer tabanlı yönlendirme

Aşağıdaki örnek Referer üstbilgisine göre isteklerin farklı kaynaklara nasıl yönlendirileceğini gösterir. Bu yöntem hotlink koruması veya isteğin kaynağına göre erişimi kontrol etmek için kullanışlıdır.

Referer kural koşulu oluşturun

  1. CDN konsoluna giriş yapın hedef etki alanını seçin ve Domain Names > Rules Engine bölümüne gidin.

  2. Add Rule seçeneğine tıklayın ve aşağıdaki tabloda açıklandığı gibi parametreleri yapılandırın. Kurallar motorunda özel bir Referer eşleştirme türü yoktur. Referer tabanlı eşleştirmeyi uygulamak için Request Header eşleştirme türünü kullanmanız gerekir:


    Parametre


    Değer


    Rule Name


    Açıklayıcı bir ad girin; örneğin referer-routing.


    Eşleştirme türü


    Request Header


    Parametre adı


    Referer


    Eşleştirme işleci


    Include Any


    Eşleştirme değeri


    example.com. Bu değer referer etki alanını belirtir. Birden fazla etki alanı ekleyebilirsiniz.


    Büyük/küçük harfe duyarlı


    Case-insensitive

  3. Kuralı kaydetmek için Submit seçeneğine tıklayın.

Koşullu kaynağı yapılandırın

  1. Etki alanı yönetimi sayfasının solundaki gezinme bölmesinde Basics sekmesine gidin. Origin Information bölümünde Conditional Origin yanındaki genişlet simgesine tıklayın.

  2. Add Conditional Origin seçeneğine tıklayın ve iletişim kutusundaki parametreleri aşağıdaki tabloda açıklandığı gibi yapılandırın:


    Parametre


    Değer


    Rule Condition


    Açılır listeden referer-routing seçeneğini belirleyin.


    Origin Address


    Bu Referer kaynağı için kaynak adresini girin.

  3. Yapılandırmayı kaydetmek için OK seçeneğine tıklayın.

Örnek: Çin anakarasındaki ve Çin anakarası dışındaki kullanıcıları farklı kaynaklara yönlendirme

Aşağıdaki örnek Çin anakarasındaki ve Çin anakarası dışındaki kullanıcıları farklı kaynak sunucularına yönlendirmek için kurallar motoruyla birlikte koşullu kaynakların nasıl kullanılacağını gösterir.

  1. CDN konsoluna giriş yapın. Domain Names sayfasında hedef etki alanını bulun ve Actions sütunundaki Manage seçeneğine tıklayın. Sol gezinme bölmesinde Rules Engine seçeneğine tıklayın ve ardından Add Rule seçeneğine tıklayın.

  2. Çin anakarası kuralını yapılandırın: Kural içeriği alanında artı simgesine tıklayarak bir eşleştirme koşulu ekleyin. Match type değerini IP Location, Match operator değerini Include Any olarak ayarlayın ve eşleştirme değeri olarak açılır listeden Chinese mainland seçeneğini belirlemek için Modify seçeneğine tıklayın. Kuralı gönderin ve kaydedin.

  3. Denizaşırı kuralını yapılandırın (yedekleme): Başka bir kural oluşturun. Match type değerini IP Location, Match operator değerini Exclude Any olarak ayarlayın ve eşleştirme değerini Chinese mainland olarak belirleyin. Kuralı gönderin ve kaydedin.

  4. Koşullu kaynağı yapılandırın: Origin Information bölümünde her kuralı karşılık gelen kaynakla ilişkilendirin:

    • Çin anakarası kuralını yerel bir kaynakla (örneğin yerel bir OSS paketi veya yerel bir sunucu) ilişkilendirin.

    • Denizaşırı kuralını denizaşırı bir kaynakla (örneğin denizaşırı bir OSS paketi veya denizaşırı bir sunucu) ilişkilendirin.

  5. Kaynak Host'unu yapılandırın: Host değerinin karşılık gelen kaynak etki alanıyla eşleşmesini sağlamak için her kaynak için özel bir Origin Host yapılandırın.

    • Etki alanı yönetimi sayfasının sol gezinme bölmesinde Origin Fetch > Configurations sekmesine gidin. Specify Origin Host bölümünde Add seçeneğine tıklayın.

    • Specify Origin Host iletişim kutusunda aşağıdaki parametreleri yapılandırın. Her kaynak için bir giriş ekleyin:


    Parametre


    Değer


    Origin Type


    Custom origin. Koşullu kaynaklarda yapılandırılan kaynak adresleri Basic origin address açılır listesinde görünmez. Custom origin seçeneğini belirleyip adresi manuel olarak girmeniz gerekir. Kaynak adresi temel kaynak yapılandırmasında zaten eklenmişse (örneğin bir OSS kaynağı olarak) Basic origin address seçeneğini belirleyip açılır listeden seçebilirsiniz.


    Origin Address


    Koşullu kaynakla ilişkili kaynak adresini girin (örneğin yerel veya denizaşırı OSS paketinin etki alanı).


    Origin Host Type


    Custom origin Host


    Origin Host


    Kaynak etki alanıyla eşleşen Host değerini girin (örneğin bucket.oss-cn-hangzhou.aliyuncs.com).


    Rule Condition


    Bu kaynağa karşılık gelen kural koşulunu seçin (örneğin Çin anakarası kuralı veya Çin anakarası dışı kuralı).

    Yapılandırmayı tamamlamak için OK seçeneğine tıklayın.

Varsayılan kaynak Host'unu devre dışı bırakmanız gerekmez. Aynı kaynak için hem varsayılan kaynak Host'u hem de belirli bir kaynağa ait kaynak Host'u yapılandırıldığında belirli kaynağa ait kaynak Host'u geçerli olur. Belirli bir kaynak Host'u yapılandırılmamış kaynaklar için varsayılan kaynak Host'u yürürlükte kalır.

Öneriler

Çin anakarası dışındaki kullanıcıların Çin anakarası kaynaklarına erişirken yüksek gecikme süresi veya kararsız bağlantılar yaşadığı senaryolar için kaynak getirme bağlantısını optimize etmek üzere OSS transfer hızlandırma kullanmanızı öneririz. Aşağıdaki gibi yapılandırın:

  • Çin anakarası koşullu kaynağı için kaynağı OSS standart genel uç noktaya ayarlayın (örneğin bucket.oss-cn-hangzhou.aliyuncs.com).

  • Denizaşırı koşullu kaynak için kaynağı OSS Transfer Acceleration uç noktasına ayarlayın (örneğin bucket.oss-accelerate.aliyuncs.com).

OSS küresel olarak dağıtılmış hızlandırma düğümleri kullanarak sınır ötesi aktarım bağlantılarını optimize eder ve kaynak getirme gecikme süresini önemli ölçüde azaltabilir. Daha fazla bilgi için bkz. OSS Transfer Acceleration.