Gelişmiş başvuru · Gelişmiş
Ağ filtresi söz dizimi
Doğrulanmış ağ kuralı alt kümesini kullanın; istisnaları, kapsamları ve reddedilen satırları anlayın.
Genel bakış
Shield, birçok engelleme listesinin ortak kullandığı filtre dilinin sınırlı bir alt kümesini kabul eder. Doğru şekilde ifade edemediği bir satırı atlar. Bir satırın geçmesi için tanımadığınız bir seçeneği kaldırmak, satırın anlamını değiştirebilir; bunun yerine önizlemeyi okuyun.
Aşağıdaki örnekler ayrılmış örnek alan adlarını kullanır. Bunlar kural davranışını açıklar; gerçek bir hizmet için yüklemeniz gereken kurallar değildir. Kurallarınız bölümüne her seferinde bir satır ekleyin, kapsamını gözden geçirin ve yalnızca istediğiniz değişikliği uygulayın.
Söz dizimi
URL kalıpları
Tablonun tamamını okumak için yana kaydırın.
| Amaç | Söz dizimi ve örnek | Beklenen etki ve sınırlar |
|---|---|---|
| Bir ana bilgisayarla eşleştirme | ||ads.example^ |
O ana bilgisayarla ve alt alan adlarıyla ana bilgisayar adı sınırında eşleşir; notads.example ile eşleşmez. Türü belirtilmemiş bir kural, üst düzey sayfa gezintisini değil, sıradan istekleri hedefler. |
| URL'yi sabitleme | |https://cdn.example/ads.js| |
URL'nin tam bu konumlarda başlayıp bitmesini gerektirir. Şema, yol veya sorgu değişirse eşleşme durabilir. |
| URL'nin bir kısmıyla eşleştirme | /ad/image/*$image |
Belirtilen yolu ve ardından değişken metni içeren görsel isteği URL'leriyle eşleşir. Sondaki joker karakter, onu eğik çizgiyle sınırlanmış bir normal ifadeden ayırır. |
| Joker karakter kullanma | ||cdn.example/ads/* |
* değişken metinle; ^ bir ayırıcıyla veya URL sonuyla eşleşir. Birden çok joker karakterli kalıpların kabul ve işlem sınırları vardır; rastgele büyüklükteki kalıplar kabul edilmez. |
Kalıplarda ASCII URL metni kullanılır. #fragment eklemeyin: tarayıcı URL parçalarını ağ isteğinin bir parçası olarak göndermez.
Türler, taraflar ve web sitesi kapsamları
Tablonun tamamını okumak için yana kaydırın.
| Amaç | Örnek | Beklenen etki ve sınırlar |
|---|---|---|
| İstek türünü kısıtlama | ||ads.example^$script |
Komut dosyalarına uygulanır. Diğer türler arasında image, stylesheet, font, media, object, xmlhttprequest, subdocument, document, ping, websocket ve other bulunur. Takma adlar arasında css, xhr, frame ve doc vardır. |
| Bir türü hariç tutma | ||ads.example^$~image |
Görselleri hariç tutar. Yalnızca olumsuzlama içeren bir kural yine de üst düzey belgeleri hariç tutar; sayfa engelleyen bir kurala dönüşmez. |
| Tüm türleri dahil etme | ||ads.example^$all |
Üst düzey belgeleri açıkça dahil eder. $all,~script modellenen diğer türleri dahil eder. Dikkatli kullanın. |
| Tarafı kısıtlama | ||ads.example^$third-party |
İstek, onu başlatan siteye göre üçüncü taraf olduğunda uygulanır. 3p bir takma addır; first-party, 1p, ~third-party ve ~3p birinci tarafı seçer. |
| İsteği başlatan web sitesini kısıtlama | ||ads.example^$domain=news.example |
Eşleşmeyi o ana bilgisayarın başlattığı isteklerle sınırlar. Hariç tutulan başlatıcı ana bilgisayarlar aşağıda gösterildiği gibi eklenebilir. Ağ $domain= kapsamlarındaki varlık joker karakterleri reddedilir. |
Dahil etme/hariç tutma kapsamında ana bilgisayar adları arasında |, hariç tutulan ana bilgisayardan önce ~ kullanılır:
||ads.example^$domain=news.example|~pay.news.example
İstisnalar ve öncelik
@@||ads.example^$script,domain=shop.example, belirtilen web sitesinin başlattığı eşleşen komut dosyası isteklerine izin verir. O web sitesindeki tüm korumayı duraklatmaz.
Eşleşen sıradan bir istisna, sıradan bir engellemeden önce gelir. $important engellemesi sıradan bir istisnadan önce gelir; $important taşıyan bir istisna da bu önemli engellemeden önce gelir. Daha belirgin görünen metin genel bir öncelik sistemi değildir.
Tüm sayfa istisnası için @@||shop.example^$document, eşleşen üst düzey sayfa ve onun yüklemeleri için korumayı devre dışı bırakır. Bu biçime taraf koşulu, başlatıcı alan adı kapsamı, ek kaynak türleri veya $all eklenemez. İstisna olmayan $document bir duraklatma değil, üst düzey belge engellemesidir.
@@||news.example^$generichide, o ana bilgisayarda genel kozmetik gizlemeyi durdurur. Siteye özgü kozmetik kurallar ve istek engelleme kullanılabilir kalır. Yalnızca saf bir ana bilgisayar sabitine yazılan istisna kabul edilir; yollar, taraf koşulları ve diğer tür kapsamları bu yalnızca ana bilgisayar biçimine taşınmaz.
Açılır pencere hedefleri
||popups.example^$popup, Shield'ın açılır pencere işleyicisini kullanarak açılır pencere gezinme hedefleriyle eşleşir. @@||accounts.example^$popup,domain=shop.example, kapsamı sınırlı bir açılır pencere istisnasıdır. Bunlar komut dosyası isteği kuralları değildir ve tarayıcının yerleşik açılır pencere engelleyicisini yapılandırmaz.
$popup seçeneğini istek türleri, $all, $generichide veya bir yönlendirme eylemiyle birleştirmeyin: tek bir satır iki kapsamı birden ifade edemez. Oturum açma penceresiyle ilgili bir sorun için oturum açma ve ödeme pencereleri ile başlayın.
Hosts dosyaları ve koşullu bloklar
0.0.0.0, 127.0.0.1, ::1, :: veya 0 boşaltma adreslerini kullanan standart hosts girdileri, ana bilgisayar sabiti kurallarına dönüştürülür. Örneğin 0.0.0.0 ads.example, ||ads.example^ ile eşdeğer hâle gelir. Boşlukla ayrılmış diğer ağ biçimleri reddedilir.
Listeler iç içe !#if, !#else ve !#endif yönergelerini !, &&, || ve parantezlerle kullanabilir. Koşullar, Shield'ın paket hedefine göre değerlendirilir. Doğru kabul edilen ortak koşullar arasında true, env_mv3 ve cap_user_stylesheet bulunur; env_chromium ve env_firefox hedefe bağlıdır. Bilinmeyen sabitler yanlış olarak değerlendirilir. Bu yönergeler canlı sayfa koşullarını değil, liste dallarını seçer.
Etkisiz yönlendirmeler
Kapalı bir kaynak kümesi kabul edilir: redirect=noopjs veya redirect=noop.js boş bir komut dosyası sağlar; redirect=nooptext veya redirect=noop.txt boş metin sağlar; redirect=noopjson {} sağlar. Örneğin ||ads.example/tracker.js$script,redirect=noopjs, kural öncelik kazandığında komut dosyasının yerine etkisiz komut dosyasını koyar.
Bunlar pakete dahil ikamelerdir; rastgele URL yönlendirmeleri veya üçüncü taraf bir kitaplığın tam öykünmesi değildir. Bilinmeyen kaynak adları ve istisna kurallarındaki yönlendirme eylemleri reddedilir. Aynı öncelikte yarışan katı bir engelleme, yönlendirmenin önüne geçebilir.
Sınırlar
Normal ifadeli ağ filtreleri, removeparam, csp, badfilter, redirect-rule ve bilinmeyen değiştiriciler satırın tamamıyla reddedilir. Bu başvuru, EasyList, uBlock Origin veya AdGuard'ın her özelliğiyle uyumluluk vaat etmez. Bir söz diziminin burada yer almaması, test edilip reddedildiğinin kanıtı değildir.
Kabul edilen kurallar yine de tarayıcı kapasitesini aşabilir veya koruma ayarları ve istisnalar tarafından geçersiz kılınabilir. Önizlemeyi ve koruma durumunu kontrol edin; yapılandırılmış bir kural, sayfada bir etkisi olduğunun kanıtı değildir.
Örnekler
Dar kapsamlı bir engelleme ve istisna çifti:
||ads.example^$script,third-party
@@||ads.example^$script,domain=checkout.example
İlk satır eşleşen üçüncü taraf komut dosyalarını engeller. İkinci satır checkout.example tarafından başlatılan eşleşen komut dosyası isteklerine izin verir. Yeniden yükledikten sonra web sitesinin gerçek iş akışını test edin; izin verilen bir istek reklamlara veya izlemeye de izin verebilir.