🌐 تثبيت Blocky — حاجب إعلانات DNS سريع وخفيف

انشر Blocky على Ubuntu بـ Docker — وكيل DNS بملف تنفيذي واحد يحجب الإعلانات والمتتبعات على مستوى الشبكة بالكامل من ملف YAML بسيط، DNS على المنفذ 5354.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر Blocky كحاجب إعلانات DNS على مستوى الشبكة، DNS على المنفذ 5354 وواجهة API على 4002، كلها مضبوطة عبر config.yml واحد.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/networking/blocky/blocky-ubuntu.sh
chmod +x blocky-ubuntu.sh
sudo bash blocky-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/networking/blocky/blocky-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x blocky-ubuntu.sh

3 تشغيل المثبت

يثبّت السكريبت Docker إن لزم ويُشغّل Blocky مع DNS على المنفذ 5354 (TCP وUDP) وواجهة API على 4002، كلها مضبوطة عبر config.yml — الذي يأتي بمصادر عليا منطقية وقائمة حجب أولية.

sudo bash blocky-ubuntu.sh

4 وجّه جهازاً واختبر الحجب

اضبط DNS جهاز ما على عنوان سيرفرك (المنفذ 5354)، ثم تأكد أن نطاقاً عادياً يُحل وأن نطاق إعلانات معروف محجوب:

dig @<your-server-ip> -p 5354 doubleclick.net

المنافذ المستخدمة

المنفذالغرض
5354DNS (host → container 53, TCP + UDP) — point devices here
4002HTTP query API + Prometheus metrics (host → container 4000)
config.ymlThe single YAML file that configures blocklists and upstreams

نظرة عامة

Blocky وكيل DNS وحاجب إعلانات مجاني ومفتوح المصدر مكتوب بلغة Go يُصفّي كل استعلام DNS على شبكتك مقابل قوائم حجب قابلة للضبط. وجّه الراوتر أو الأجهزة الفردية إليه كخادم DNS، فيحل النطاقات العادية عبر خوادم الحل العليا التي تختارها بينما لا يُعيد شيئاً لنطاقات الإعلانات والمتتبعات والبرمجيات الخبيثة. خلافاً لخوادم DNS الأثقل لحجب الإعلانات، يأتي Blocky كملف تنفيذي واحد مُجمّع بملف إعداد YAML واحد — لا توجد قاعدة بيانات، ولا حزمة PHP، ولا لوحة إدارة ويب للصيانة.

لماذا تستخدمه

حجب الإعلانات والمتتبعات على مستوى DNS يحمي كل جهاز على شبكتك دفعة واحدة — الهواتف والتلفزيونات الذكية وأجهزة إنترنت الأشياء — دون تثبيت إضافة متصفح على كل واحد. يقدم Blocky ذلك بجزء بسيط من موارد أدوات مثل Pi-hole: ملف تنفيذي واحد بلغة Go يبدأ خلال أجزاء من الثانية، مضبوط بالكامل عبر ملف YAML واحد قابل للقراءة والتحكم بالإصدارات. لمن يريد حجباً على مستوى الشبكة كاملة دون عبء لوحة إدارة مدعومة بقاعدة بيانات، أو من يريد محلّلاً يعمل بارتياح على راوتر صغير أو جهاز افتراضي أو Raspberry Pi، بُني Blocky لذلك بالضبط.

متى تحتاجه

  • تريد حجب الإعلانات والمتتبعات ونطاقات البرمجيات الخبيثة لكل جهاز على شبكتك من مكان مركزي واحد
  • تريد حجباً على مستوى DNS يعمل على التلفزيونات الذكية وأجهزة إنترنت الأشياء والهواتف التي لا تستطيع تشغيل إضافات حجب إعلانات في المتصفح
  • تريد محلّلاً خفيفاً يعمل بارتياح على جهاز افتراضي صغير أو راوتر أو Raspberry Pi دون قاعدة بيانات
  • تفضل ضبط البنية التحتية كملف YAML واحد قابل للقراءة والتحكم بالإصدارات بدلاً من النقر عبر واجهة ويب
  • تُشغّل بالفعل Prometheus وGrafana وتريد مقاييس استعلامات DNS متصلة مباشرة بمراقبتك الحالية
  • تحتاج وكيل DNS بتوجيه شرطي ونطاقات محلية مخصصة أو دعم DNS-over-TLS/HTTPS لخوادم الحل العليا

من يحتاجه

  • المستخدمون المنزليون الذين يريدون حجب إعلانات ومتتبعات على مستوى الشبكة دون عبء موارد حزمة كاملة بأسلوب Pi-hole
  • المستضيفون الذاتيون الذين يُشغّلون عشرات الخدمات الصغيرة ويريدون أن يكون محلّل DNS لديهم خفيفاً قدر الإمكان
  • عشاق المختبرات المنزلية وRaspberry Pi الذين يحتاجون حاجب إعلانات DNS خفيفاً بما يكفي للأجهزة المحدودة
  • المستخدمون المهتمون بالخصوصية الذين يريدون DNS-over-TLS أو DNS-over-HTTPS لخوادمهم العليا، مخفين الاستعلامات عن مزود الإنترنت
  • مسؤولو الأنظمة الذين يفضلون البنية التحتية كإعداد — ملف YAML واحد يمكن التحكم بإصداره ومراجعته
  • المستخدمون الذين يُشغّلون بالفعل Prometheus وGrafana ويريدون دمج مقاييس DNS في لوحاتهم الحالية بدلاً من لوحة إدارة منفصلة
  • المكاتب الصغيرة التي تريد حجباً مركزياً للإعلانات ونطاقات البرمجيات الخبيثة لكل جهاز دون برنامج على كل جهاز
  • أي شخص جرّب Pi-hole أو AdGuard Home وأراد نفس الحجب على مستوى الشبكة بعبء أصغر

حالات الاستخدام الشائعة

  • حجب الإعلانات والمتتبعات على مستوى الشبكة كاملة بتوجيه DNS الراوتر إلى Blocky
  • حجب نطاقات البرمجيات الخبيثة والتصيد المعروفة قبل أن يتمكن أي جهاز حتى من الاتصال بها
  • تجميع الأجهزة في مجموعات عملاء بقوائم حجب مختلفة — مثلاً حجب أكثر صرامة لأجهزة الأطفال
  • توجيه نطاقات داخلية محددة شرطياً لخادم DNS مختلف، مثل Active Directory محلي أو NAS
  • تشفير استعلامات DNS لخوادم الحل العليا باستخدام DNS-over-TLS أو DNS-over-HTTPS لمنع تجسس مزود الإنترنت
  • تصدير مقاييس استعلامات DNS إلى Prometheus وتصور نشاط الحجب في لوحة Grafana موجودة
  • تعريف إدخالات DNS محلية مخصصة بحيث تُحل أسماء المضيفين الداخلية دون الحاجة لمنطقة DNS منفصلة

الميزات الرئيسية

  • ملف تنفيذي واحد مُجمّع بلغة Go دون قاعدة بيانات أو بيئة تشغيل PHP أو تطبيق ويب إداري للتثبيت أو الصيانة
  • إعداد بالكامل عبر ملف YAML واحد يغطي الخوادم العليا وقوائم الحجب ومجموعات العملاء والإدخالات المخصصة
  • حجب حسب مجموعات العملاء، يتيح لأجهزة أو شبكات فرعية مختلفة استخدام قوائم حجب وقواعد مختلفة
  • تخزين مؤقت مدمج لتقليل الاستعلامات العليا وتسريع الاستعلامات المتكررة
  • دعم DNS-over-TLS وDNS-over-HTTPS لاستعلامات مشفرة لخوادم الحل العليا
  • نقطة نهاية Prometheus أصلية لحجم الاستعلامات ومعدل الحجب ووقت الاستجابة دون مصدّرات إضافية
  • توجيه شرطي لنطاقات محددة إلى خوادم حل عليا مختلفة، مفيد لمناطق الشبكة المحلية
  • قواعد حجب بالتعابير النمطية والحروف البديلة إضافة إلى قوائم الحجب بأسلوب ملف hosts القياسي

كيفية الاستخدام بعد التثبيت

  • عدّل config.yml لمراجعة أو استبدال خوادم الحل العليا الافتراضية (1.1.1.1 و8.8.8.8) بمزودك المفضل
  • أضف أو عدّل روابط قوائم الحجب تحت قسم blocking — يأتي المثبت بقائمة أولية من StevenBlack/hosts
  • أعد تشغيل الحاوية بعد أي تعديل على config.yml، لأن Blocky يقرأ إعداده فقط عند بدء التشغيل
  • وجّه DNS جهاز اختبار إلى سيرفرك على المنفذ 5354 وتأكد أن نطاق إعلانات معروف يفشل في الحل
  • اضبط إعدادات DHCP في راوترك لتوزيع سيرفر Blocky كمحلّل DNS للشبكة بأكملها
  • أعدّ مجموعات العملاء في config.yml إذا أردت قواعد حجب مختلفة لأجهزة أو شبكات فرعية مختلفة
  • فعّل نقطة نهاية مقاييس Prometheus إذا أردت رسم حجم الاستعلامات ومعدل الحجب عبر الزمن
  • أضف أي أسماء مضيفين داخلية تحتاج حلها محلياً تحت قسم تعيين DNS المخصص في config.yml

أفضل ممارسات الأمان

  • قيّد منفذ DNS 5354 على شبكتك المحلية فقط — محلّل DNS متاح للعموم يمكن استغلاله في هجمات تضخيم DNS
  • قيّد منفذ HTTP API 4002 أيضاً، لأنه يكشف سجلات الاستعلامات والمقاييس التي تكشف نشاط التصفح على شبكتك
  • استخدم DNS-over-TLS أو DNS-over-HTTPS للاستعلامات العليا إذا أردت منع مزود الإنترنت من رؤية استعلامات DNS بنص عادي
  • حدّث صورة ghcr.io/0xerr0r/blocky بانتظام للحصول على إصلاحات الأمان ودعم صيغ قوائم حجب جديدة
  • راجع config.yml قبل نشره إذا نسخت أمثلة من مكان آخر — الخوادم العليا أو قواعد التوجيه المضبوطة خطأ يمكن أن تُسرّب أسماء نطاقات داخلية
  • إذا كشفت نقطة نهاية المقاييس أو API خارج شبكتك المحلية للمراقبة، ضعها خلف وكيل عكسي بمصادقة بدلاً من فتحها مباشرة

المنافذ وإعدادات جدار الحماية

يستخدم Blocky منفذين في هذا النشر: 5354 لـ DNS عبر TCP وUDP معاً (معيّن من منفذ 53 القياسي في الحاوية)، و4002 لواجهة API للاستعلامات ومقاييس Prometheus (معيّن من منفذ 4000 في الحاوية). لا يجب أن يكون أي من المنفذين متاحاً من الإنترنت العام — محلّلات DNS هدف شائع لإساءة استخدام التضخيم، ونقطة نهاية HTTP تكشف سجلات استعلامات تفصح عن نشاط التصفح. أبقِ كلا المنفذين مقيّدين بشبكتك المحلية أو VPN، وإذا احتجت رؤية المقاييس عن بُعد، ضع منفذ HTTP خلف وكيل عكسي بمصادقة بدلاً من فتحه في الجدار الناري.

النسخ الاحتياطي والصيانة

  • انسخ config.yml احتياطياً — هو المصدر الوحيد للحقيقة بالنسبة للخوادم العليا وقوائم الحجب ومجموعات العملاء وكل إعداد آخر
  • انسخ docker-compose.yml احتياطياً حتى يمكن إعادة إنشاء الحاوية بنفس تعيينات المنافذ والحجم
  • بما أن Blocky لا يحتفظ بقاعدة بيانات أو تاريخ استعلامات دائم افتراضياً، النسخ الاحتياطي الكامل هو فقط هذان الملفان
  • خزّن نسخة من config.yml في نظام تحكم بالإصدارات (حتى مستودع git خاص) حتى تُتبَّع التغييرات ويسهل التراجع عنها
  • اختبر إعادة إنشاء الحاوية من نسخة config.yml احتياطية على جهاز احتياطي للتأكد أن الإعداد كامل ومكتفٍ ذاتياً

الأخطاء الشائعة

  • تعديل config.yml ونسيان إعادة تشغيل الحاوية — يقرأ Blocky إعداده فقط عند بدء التشغيل، وليس حياً
  • كشف منفذ DNS 5354 أو منفذ API 4002 للإنترنت العام، ما يحوّل المحلّل إلى هدف لإساءة الاستخدام
  • الاعتماد على مصدر قائمة حجب واحد، يمكن أن يتعطل أو يتوقف عن التحديث دون تحذير — أضف أكثر من مصدر
  • عدم اختبار الحجب بعد الإعداد — رابط قائمة حجب مضبوط خطأ يفشل بصمت ولا يحجب شيئاً ببساطة
  • نسيان أن Blocky ليس له واجهة ويب إدارية وتوقع إدارته بنفس طريقة Pi-hole أو AdGuard Home
  • توجيه بعض الأجهزة فقط إلى Blocky وترك أخرى على DNS الافتراضي لمزود الإنترنت، ما يترك ثغرات في الحجب على مستوى الشبكة
  • عدم ضبط مجموعات عملاء عندما تحتاج أجهزة مختلفة فعلياً سياسات حجب مختلفة، وتطبيق مجموعة قواعد واحدة على كل شيء

استكشاف الأخطاء وإصلاحها

  • استعلامات DNS لا تُحل إطلاقاً — تأكد أن الحاوية تعمل وأن المنفذ 5354 قابل للوصول من جهاز الاختبار، وتحقق من اتصال خوادم الحل العليا
  • نطاقات الإعلانات لا تُحجب — تحقق أن روابط قوائم الحجب في config.yml قابلة للوصول وتم تحميلها بنجاح؛ راجع سجلات الحاوية بحثاً عن أخطاء جلب قائمة الحجب
  • تعديلات الإعداد ليس لها أثر — أعد تشغيل الحاوية بعد أي تعديل على config.yml، لأن Blocky لا يعيد التحميل حياً
  • استجابات DNS بطيئة — تحقق أن التخزين المؤقت مفعّل وأن خوادم الحل العليا مستجيبة؛ خادم علوي بطيء أو غير متاح يؤخر كل استعلام
  • نقطة نهاية مقاييس Prometheus غير متاحة — تأكد أن منفذ HTTP معيّن بشكل صحيح وأن prometheus مفعّل في config.yml
  • بعض الأجهزة تتجاوز الحجب تماماً — تحقق إن كانت هذه الأجهزة مضبوطة يدوياً على خادم DNS عام مثل 8.8.8.8 بدلاً من استخدام DNS المُعيَّن عبر DHCP من الراوتر

البدائل

Pi-hole هو حاجب الإعلانات الأشهر على مستوى الشبكة، بلوحة ويب متطورة ومتصفح سجل استعلامات ومجتمع كبير — لكنه يُشغّل حزمة أثقل بقاعدة بيانات وتطبيق إداري PHP خلفها. يقدم AdGuard Home واجهة إدارية كاملة مشابهة وتصفية DNS مع رقابة أبوية مدمجة، وهو أيضاً أثقل من ملف تنفيذي واحد. يستطيع dnsmasq حجب إعلانات أساسياً عبر ملف hosts كبير، لكنه يفتقر لمجموعات عملاء Blocky ومقاييس Prometheus ودعم DNS-over-TLS/HTTPS. يقدم NextDNS تصفية مشابهة كخدمة سحابية دون حاجة للاستضافة الذاتية، مقابل إرسال استعلامات DNS لديك لطرف ثالث. لمن يريد حجباً على مستوى الشبكة بأسلوب Pi-hole بجزء بسيط من عبء الموارد ودون قاعدة بيانات إدارية، Blocky هو الخيار الأكثر اختصاراً.

متى لا تستخدمه

ليس لدى Blocky لوحة ويب، فإذا أردت تصفح سجل استعلامات بصري، أو رؤية إحصائيات لكل جهاز في واجهة، أو إدارة قوائم الحجب بالنقر بدلاً من تعديل YAML، فإن Pi-hole أو AdGuard Home سيناسبانك أكثر من الصندوق مباشرة. كما أنه مجرد محلّل DNS، وليس جهاز أمان شبكة كاملاً — لن يفحص حركة المرور أبعد من استعلامات DNS ولن يحجب إعلانات مضمّنة في حركة HTTPS لا تعتمد على نطاق محجوب. إذا أردت ملفات رقابة أبوية مدمجة أو معالج إعداد رسومي لأفراد الأسرة غير التقنيين لإدارته بأنفسهم، فأداة بواجهة إدارية مخصصة خيار أفضل.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هو Blocky؟

Blocky وكيل DNS وحاجب إعلانات سريع وخفيف مكتوب بلغة Go. وجّه أجهزتك أو راوترك إليه كخادم DNS، فيُصفّي كل استعلام مقابل قوائم الحجب لديك — لا يُعيد شيئاً لنطاقات الإعلانات والمتتبعات والبرمجيات الخبيثة بينما يُحوّل كل شيء آخر لخوادم الحل العليا لديك.

كيف يختلف Blocky عن Pi-hole؟

يمنحك Pi-hole لوحة ويب إدارية كاملة ومتصفح سجل استعلامات ومجتمعاً كبيراً، لكنه يُشغّل حزمة أثقل بقاعدة بيانات وتطبيق PHP خلفها. يقدم Blocky نفس الحجب على مستوى الشبكة بجزء بسيط من الموارد — ملف تنفيذي واحد بلغة Go وملف إعداد YAML واحد، دون لوحة إدارة ويب.

ما المنافذ التي يستخدمها Blocky؟

يعمل DNS على المنفذ المضيف 5354 عبر TCP وUDP معاً، وتعمل نقطة نهاية HTTP لواجهة الاستعلامات ومقاييس Prometheus على المنفذ 4002. المنفذ غير القياسي 5354 يتيح لـ Blocky التعايش مع خدمات DNS أخرى تعمل بالفعل على نفس المضيف.

هل لدى Blocky واجهة ويب؟

ليست لوحة إدارة، لا. يُضبط Blocky بالكامل عبر config.yml، وهذا هو الهدف — الإعداد بأكمله ملف واحد قابل للقراءة والتحكم بالإصدارات. منفذ HTTP يخدم واجهة استعلامات ومقاييس Prometheus بدلاً من واجهة إدارية.

كيف أضيف أو أغيّر قوائم الحجب؟

عدّل config.yml — يسرد قسم blocking روابط قوائم الحجب ومجموعات العملاء التي تنطبق عليها. أضف أو استبدل الروابط هناك، احفظ الملف، وأعد تشغيل الحاوية ليصبح التغيير سارياً.