Diese Seite ist eine Übersetzung. Bei Abweichungen gilt die englische Seite.

Referenz für Fortgeschrittene · Fortgeschritten

Syntax von Netzwerkfiltern

Nutze den geprüften Teil der Netzwerkregeln und versteh Ausnahmen, Geltungsbereiche und abgelehnte Zeilen.

Überblick

Shield akzeptiert einen begrenzten Teil der Filtersprache, die viele Blockierlisten gemeinsam nutzen. Eine Zeile, die es nicht originalgetreu abbilden kann, überspringt es. Wenn du eine unbekannte Option entfernst, damit eine Zeile akzeptiert wird, kann sich ihre Bedeutung ändern; lies stattdessen die Vorschau.

Die folgenden Beispiele verwenden reservierte Beispiel-Domains. Sie beschreiben das Verhalten von Regeln, keine Regeln, die du für einen echten Dienst installieren solltest. Füge in Deine Regeln jeweils eine Zeile ein, prüfe ihren Geltungsbereich und wende nur die Änderung an, die du beabsichtigst.

Syntax

URL-Muster

Scrolle seitwärts, um die ganze Tabelle zu lesen.

Zweck Syntax und Beispiel Erwartete Wirkung und Grenzen
Einen Host abgleichen ||ads.example^ Passt auf diesen Host und seine Subdomains an einer Hostnamen-Grenze; passt nicht auf notads.example. Eine Regel ohne Typ zielt auf normale Anfragen, nicht auf die Navigation zu einer Seite der obersten Ebene.
Eine URL verankern |https://cdn.example/ads.js| Die URL muss genau an diesen Stellen beginnen und enden. Ein geändertes Schema, ein geänderter Pfad oder eine geänderte Abfrage kann den Treffer verhindern.
Einen Teil einer URL abgleichen /ad/image/*$image Passt auf URLs von Bildanfragen, die den genannten Pfad gefolgt von variablem Text enthalten. Der Platzhalter am Ende unterscheidet die Regel von einem durch Schrägstriche begrenzten regulären Ausdruck.
Einen Platzhalter nutzen ||cdn.example/ads/* * passt auf variablen Text; ^ passt auf ein Trennzeichen oder das Ende der URL. Muster mit mehreren Platzhaltern haben Grenzen für Zulassung und Aufwand; beliebig große Muster werden nicht akzeptiert.

Muster verwenden URL-Text in ASCII. Füge kein #fragment ein: Der Browser sendet URL-Fragmente nicht als Teil einer Netzwerkanfrage.

Typen, Parteien und Website-Bereiche

Scrolle seitwärts, um die ganze Tabelle zu lesen.

Zweck Beispiel Erwartete Wirkung und Grenzen
Einen Anfragetyp einschränken ||ads.example^$script Gilt für Skripte. Weitere Typen sind image, stylesheet, font, media, object, xmlhttprequest, subdocument, document, ping, websocket und other. Aliase sind unter anderem css, xhr, frame und doc.
Einen Typ ausschließen ||ads.example^$~image Schließt Bilder aus. Eine Regel, die nur Typen ausschließt, schließt weiterhin Dokumente der obersten Ebene aus; sie wird nicht zu einer Regel, die Seiten blockiert.
Alle Typen einschließen ||ads.example^$all Schließt ausdrücklich Dokumente der obersten Ebene ein. $all,~script schließt die anderen abgebildeten Typen ein. Mit Vorsicht verwenden.
Partei einschränken ||ads.example^$third-party Gilt, wenn die Anfrage im Verhältnis zur auslösenden Website von einem Drittanbieter stammt. 3p ist ein Alias; first-party, 1p, ~third-party und ~3p wählen Anfragen vom selben Anbieter.
Die auslösende Website einschränken ||ads.example^$domain=news.example Beschränkt den Abgleich auf Anfragen, die dieser Host auslöst. Ausgeschlossene auslösende Hosts lassen sich wie unten gezeigt hinzufügen. Entity-Platzhalter in Netzwerk-Bereichen mit $domain= werden abgelehnt.

Ein Bereich mit Ein- und Ausschlüssen nutzt | zwischen Hostnamen und ~ vor einem ausgeschlossenen Host:

||ads.example^$domain=news.example|~pay.news.example

Ausnahmen und Priorität

@@||ads.example^$script,domain=shop.example erlaubt passende Skriptanfragen, die von der genannten Website ausgelöst werden. Damit wird nicht der gesamte Schutz auf dieser Website pausiert.

Eine normale passende Ausnahme schlägt eine normale Blockierung. Eine Blockierung mit $important schlägt eine normale Ausnahme; eine Ausnahme mit $important schlägt diese wichtige Blockierung. Text, der spezifischer aussieht, ist kein allgemeines Prioritätssystem.

Für eine Ausnahme für die ganze Seite schaltet @@||shop.example^$document den Schutz für eine passende Seite der obersten Ebene und alles, was sie lädt, aus. Diese Form kann keine Parteibedingung, keinen Bereich auslösender Domains, keine zusätzlichen Ressourcentypen und kein $all enthalten. Ein $document ohne Ausnahme blockiert ein Dokument der obersten Ebene; es ist keine Pause.

@@||news.example^$generichide verhindert allgemeines kosmetisches Ausblenden auf diesem Host. Website-spezifische kosmetische Regeln und das Blockieren von Anfragen bleiben verfügbar. Zugelassen wird nur eine Ausnahme auf einem reinen Host-Anker; Pfade, Parteibedingungen und andere Typ-Bereiche werden von dieser reinen Host-Form nicht übernommen.

||popups.example^$popup passt über die Pop-up-Verarbeitung von Shield auf Navigationsziele von Pop-ups. @@||accounts.example^$popup,domain=shop.example ist eine Pop-up-Ausnahme mit begrenztem Bereich. Das sind keine Regeln für Skriptanfragen, und sie steuern nicht den integrierten Pop-up-Blocker des Browsers.

Kombiniere $popup nicht mit Anfragetypen, $all, $generichide oder einer Weiterleitung: Eine Zeile kann nicht beide Bereiche abbilden. Bei einem Problem mit einem Anmeldefenster beginn mit Anmelde- und Zahlungsfenster.

Hosts-Dateien und bedingte Blöcke

Kanonische Hosts-Einträge mit den Sink-Adressen 0.0.0.0, 127.0.0.1, ::1, :: oder 0 werden in Host-Anker-Regeln übersetzt. 0.0.0.0 ads.example wird zum Beispiel zum Gegenstück von ||ads.example^. Andere durch Leerzeichen getrennte Netzwerkformen werden abgelehnt.

Listen können verschachtelte !#if, !#else und !#endif mit !, &&, || und Klammern nutzen. Bedingungen werden für das Zielpaket von Shield ausgewertet. Als wahr erkannte gemeinsame Bedingungen sind unter anderem true, env_mv3 und cap_user_stylesheet; env_chromium und env_firefox hängen vom Ziel ab. Unbekannte Konstanten ergeben falsch. Diese Direktiven wählen Zweige der Quelle aus, keine Bedingungen auf der laufenden Seite.

Wirkungslose Weiterleitungen

Akzeptiert wird eine geschlossene Menge an Ressourcen: redirect=noopjs oder redirect=noop.js liefert ein leeres Skript; redirect=nooptext oder redirect=noop.txt liefert leeren Text; redirect=noopjson liefert {}. ||ads.example/tracker.js$script,redirect=noopjs setzt zum Beispiel das wirkungslose Skript ein, wenn sich die Regel durchsetzt.

Das sind mitgelieferte Ersetzungen, keine beliebigen URL-Weiterleitungen und keine vollständigen Nachbildungen einer Bibliothek von Drittanbietern. Unbekannte Ressourcennamen und Weiterleitungen in Ausnahmeregeln werden abgelehnt. Eine konkurrierende harte Blockierung mit gleicher Priorität kann sich gegen eine Weiterleitung durchsetzen.

Grenzen

Netzwerkfilter mit regulären Ausdrücken, removeparam, csp, badfilter, redirect-rule und unbekannte Modifikatoren werden als ganze Zeilen abgelehnt. Diese Referenz verspricht keine Kompatibilität mit jeder Funktion von EasyList, uBlock Origin oder AdGuard. Dass eine Syntax hier fehlt, ist kein Beweis, dass sie getestet und abgelehnt wurde.

Akzeptierte Regeln können trotzdem die Kapazität des Browsers überschreiten oder von Schutzeinstellungen und Ausnahmen übersteuert werden. Prüfe die Vorschau und den Schutzstatus; eine eingerichtete Regel ist kein Beweis für eine Wirkung auf der Seite.

Beispiele

Ein eng gefasstes Paar aus Blockierung und Ausnahme:

||ads.example^$script,third-party
@@||ads.example^$script,domain=checkout.example

Die erste Zeile blockiert passende Skripte von Drittanbietern. Die zweite erlaubt passende Skriptanfragen, die von checkout.example ausgelöst werden. Teste nach dem Neuladen den tatsächlichen Ablauf auf der Website; eine erlaubte Anfrage kann auch Werbung oder Tracking erlauben.

Brauchst du noch Hilfe? Kontaktiere den Support