مرجع متقدم · متقدم

صياغة فلاتر الشبكة

استخدم مجموعة قواعد الشبكة المتحقق منها وافهم الاستثناءات والنطاقات والأسطر المرفوضة.

نظرة عامة

يقبل Shield مجموعة محدودة من لغة الفلاتر المشتركة بين قوائم حظر كثيرة. ويتجاوز السطر الذي لا يستطيع تمثيله بأمانة. حذف خيار لا تعرفه لجعل السطر مقبولًا قد يغيّر معناه؛ اقرأ المعاينة بدلًا من ذلك.

تستخدم الأمثلة أدناه نطاقات محجوزة للأمثلة. وهي تصف سلوك القواعد، وليست قواعد يُنصح بتثبيتها لخدمة فعلية. ضع سطرًا واحدًا في كل مرة في القواعد الخاصة بك، وراجع نطاقه، ولا تطبّق إلا التغيير الذي تقصده.

الصياغة

أنماط العناوين

مرّر أفقيًا لقراءة الجدول كاملًا.

الغرض الصياغة والمثال الأثر المتوقع والحدود
مطابقة مضيف ||ads.example^ يطابق ذلك المضيف ونطاقاته الفرعية عند حد اسم المضيف؛ ولا يطابق notads.example. تستهدف القاعدة غير المحددة النوع الطلبات العادية، لا الانتقال إلى صفحة في المستوى الأعلى.
تثبيت حدود عنوان |https://cdn.example/ads.js| يشترط أن يبدأ العنوان وينتهي في هذين الموضعين. قد يوقف تغيّر البروتوكول أو المسار أو الاستعلام المطابقة.
مطابقة جزء من عنوان /ad/image/*$image يطابق عناوين طلبات الصور التي تتضمن المسار المحدد ويتبعه نص متغير. تميّزه علامة البدل الأخيرة عن تعبير نمطي محاط بشرطتين مائلتين.
استخدام علامة بدل ||cdn.example/ads/* تطابق * نصًا متغيرًا؛ وتطابق ^ فاصلًا أو نهاية العنوان. تخضع الأنماط متعددة علامات البدل لحدود القبول والعمل؛ ولا تُقبل أنماط كبيرة بلا حدود.

تستخدم الأنماط نص عناوين ASCII. لا تضمّن #fragment؛ فالمتصفح لا يرسل الأجزاء المرجعية من العنوان ضمن طلب الشبكة.

الأنواع والأطراف ونطاقات المواقع

مرّر أفقيًا لقراءة الجدول كاملًا.

الغرض المثال الأثر المتوقع والحدود
تقييد نوع الطلب ||ads.example^$script ينطبق على البرامج النصية. وتشمل الأنواع الأخرى image وstylesheet وfont وmedia وobject وxmlhttprequest وsubdocument وdocument وping وwebsocket وother. وتشمل الأسماء البديلة css وxhr وframe وdoc.
استبعاد نوع ||ads.example^$~image يستبعد الصور. وتظل القاعدة التي لا تتضمن إلا نفيًا مستبعدةً لمستندات المستوى الأعلى؛ ولا تصبح قاعدة حظر للصفحة.
تضمين كل الأنواع ||ads.example^$all يضمّن مستندات المستوى الأعلى صراحةً. وتضمّن $all,~script الأنواع الأخرى التي يمثلها النموذج. استخدمه بحذر.
تقييد الطرف ||ads.example^$third-party ينطبق عندما يكون الطلب لطرف ثالث بالنسبة إلى الموقع الذي بدأه. 3p اسم بديل؛ وتختار first-party و1p و~third-party و~3p الطرف الأول.
تقييد الموقع الذي يبدأ الطلب ||ads.example^$domain=news.example يقصر المطابقة على الطلبات التي يبدأها ذلك المضيف. ويمكن إضافة مضيفين مستبعدين كما في المثال أدناه. تُرفض علامات البدل للكيانات في نطاقات الشبكة $domain=.

يستخدم نطاق التضمين والاستبعاد | بين أسماء المضيفين و~ قبل المضيف المستبعد:

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

الاستثناءات والأولوية

تسمح @@||ads.example^$script,domain=shop.example بطلبات البرامج النصية المطابقة التي يبدأها الموقع المحدد. ولا توقف كل الحماية على ذلك الموقع.

يتغلب استثناء عادي مطابق على حظر عادي. ويتغلب حظر $important على استثناء عادي؛ ويتغلب استثناء يحمل $important على ذلك الحظر المهم. النص الذي يبدو أكثر تحديدًا ليس نظام أولوية عامًا.

لاستثناء صفحة كاملة، تعطّل @@||shop.example^$document الحماية لصفحة مطابقة في المستوى الأعلى وما تحمّله. لا يمكن أن تضيف هذه الصيغة شرط طرف أو نطاق المضيف الذي يبدأ الطلب أو أنواع موارد إضافية أو $all. أما $document دون استثناء فهو حظر لمستند في المستوى الأعلى، وليس إيقافًا مؤقتًا.

توقف @@||news.example^$generichide إخفاء العناصر العام على ذلك المضيف. وتترك قواعد الإخفاء الخاصة بالموقع وحظر الطلبات متاحين. لا يُقبل إلا استثناء مثبت على اسم المضيف فقط؛ ولا تنطبق المسارات أو شروط الأطراف أو نطاقات الأنواع الأخرى في هذه الصيغة المقصورة على المضيف.

تطابق ||popups.example^$popup وجهات انتقال النوافذ المنبثقة باستخدام معالج Shield للنوافذ المنبثقة. وتُعدّ @@||accounts.example^$popup,domain=shop.example استثناءً لنوافذ منبثقة ضمن نطاق محدد. هذه ليست قواعد لطلبات البرامج النصية، ولا تضبط حاجب النوافذ المنبثقة المضمّن في المتصفح.

لا تجمع $popup مع أنواع الطلبات أو $all أو $generichide أو إجراء إعادة توجيه؛ فلا يمكن لسطر واحد تمثيل النطاقين. لمشكلة في نافذة تسجيل دخول، ابدأ بدليل نوافذ تسجيل الدخول والدفع.

ملفات المضيفين والكتل الشرطية

تُحوّل إدخالات ملفات المضيفين القياسية التي تستخدم عناوين الإبطال 0.0.0.0 أو 127.0.0.1 أو ::1 أو :: أو 0 إلى قواعد تثبيت اسم المضيف. مثلًا، تصبح 0.0.0.0 ads.example مكافئةً لـ||ads.example^. وتُرفض الصيغ الشبكية الأخرى التي تفصل بينها مسافات.

قد تستخدم القوائم !#if و!#else و!#endif المتداخلة مع ! و&& و|| والأقواس. تُقيّم الشروط بحسب المنصة المستهدفة بحزمة Shield. وتشمل الشروط المشتركة المعروفة ذات القيمة الصحيحة true وenv_mv3 وcap_user_stylesheet؛ أما env_chromium وenv_firefox فيعتمدان على المنصة المستهدفة. تُقيّم الثوابت غير المعروفة كقيمة خاطئة. تختار هذه التوجيهات فروع القائمة، لا شروط الصفحة الحالية.

الاستبدالات الخاملة

تُقبل مجموعة موارد محصورة: يوفّر redirect=noopjs أو redirect=noop.js برنامجًا نصيًا فارغًا؛ ويوفّر redirect=nooptext أو redirect=noop.txt نصًا فارغًا؛ ويوفّر redirect=noopjson القيمة {}. مثلًا، تستبدل ||ads.example/tracker.js$script,redirect=noopjs البرنامج النصي بآخر خامل عندما تفوز القاعدة.

هذه بدائل مضمنة في الحزمة، وليست إعادة توجيه إلى عناوين عشوائية أو محاكاة كاملة لمكتبة خارجية. تُرفض أسماء الموارد غير المعروفة وإجراءات إعادة التوجيه في قواعد الاستثناء. وقد يتغلب حظر قطعي منافس له الأولوية نفسها على إعادة التوجيه.

الحدود

تُرفض فلاتر الشبكة التي تستخدم التعبيرات النمطية، وremoveparam وcsp وbadfilter وredirect-rule والمعدّلات غير المعروفة كسطور كاملة. لا يَعِد هذا المرجع بالتوافق مع كل ميزات EasyList أو uBlock Origin أو AdGuard. غياب صياغة من هنا لا يثبت أنها اختُبرت ورُفضت.

قد تتجاوز القواعد المقبولة سعة المتصفح، أو تتغلب عليها إعدادات الحماية والاستثناءات. راجع المعاينة وحالة الحماية؛ فإعداد القاعدة لا يثبت أثرًا على الصفحة.

أمثلة

قاعدة حظر محددة واستثناؤها:

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

تحظر الأولى البرامج النصية المطابقة التابعة لطرف ثالث. وتسمح الثانية بطلبات البرامج النصية المطابقة التي يبدأها checkout.example. اختبر مسار العمل الفعلي في الموقع بعد إعادة التحميل؛ فقد يسمح الطلب المسموح به أيضًا بالإعلانات أو التتبع.

هل ما زلت بحاجة إلى مساعدة؟ تواصل مع الدعم