إعلانات ومتتبعات مجانية ومفتوحة المصدر ، تمنع خادم DNS.
adguard.com | ويكي | رديت | تويتر | برقية
AdGuard Home هو برنامج على مستوى الشبكة لحظر الإعلانات والتتبع. بعد إعداده ، ستغطي جميع أجهزة منزلك ، ولا تحتاج إلى أي برنامج من جانب العميل لذلك.
إنه يعمل كخادم DNS يعيد تتبع المجالات إلى "ثقب أسود" ، وبالتالي منع أجهزتك من الاتصال بهذه الخوادم. إنه يعتمد على البرامج التي نستخدمها لخوادم DNS العامة الخاصة بنا ، وكلاهما يشترك في الكثير من التعليمات البرمجية.
ابدء
التثبيت الآلي (Linux/UNIX/MACOS/FREEBSD/OPERBSD)
طرق بديلة
أدلة
API
مقارنة Adguard Home بحلول أخرى
كيف يختلف هذا عن خوادم DNS العامة؟
كيف يقارن Adguard Home بـ Pi-Hole
كيف يقارن منزل Adguard مع حاصرات الإعلانات التقليدية
القيود المعروفة
كيفية البناء من المصدر
المتطلبات الأساسية
مبنى
المساهمة
اختبار إصدارات غير مستقرة
الإبلاغ عن القضايا
مساعدة في الترجمات
آخر
المشاريع التي تستخدم Adguard Home
شكر وتقدير
خصوصية
للتثبيت مع curl
Run the Tewse:
Curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
للتثبيت مع wget
Run الأمر التالي:
wget - -no -verbose -o -https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
للتثبيت مع fetch
تشغيل الأمر التالي:
Fetch -o - https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
كما يقبل البرنامج النصي بعض الخيارات:
-c <channel>
لاستخدام قناة محددة ؛
-r
لإعادة تثبيت Adguard Home ؛
-u
لإلغاء تثبيت Adguard Home ؛
-v
للإخراج المطول.
لاحظ أن الخيارات -r
و -u
حصرية بشكل متبادل.
يرجى قراءة مقالة STAINT SELECT على wiki لدينا لمعرفة كيفية تثبيت AdGuard Home يدويًا ، وكيفية تكوين أجهزتك لاستخدامها.
يمكنك استخدام صورة Docker الرسمية على Docker Hub.
إذا كنت تقوم بتشغيل Linux ، فهناك طريقة آمنة وسهلة لتثبيت Adguard Home: احصل عليها من متجر Snap.
انظر ويكي لدينا.
إذا كنت ترغب في الاندماج مع AdGuard Home ، فيمكنك استخدام API REST. بدلاً من ذلك ، يمكنك استخدام عميل Python هذا ، والذي يستخدم لبناء Adguard Home Hass.io الإضافية.
يتيح لك تشغيل خادم AdGuard Home الخاص بك القيام بأكثر من استخدام خادم DNS عام. إنه مستوى مختلف تمامًا. انظر بنفسك:
اختر بالضبط كتل الخادم والتصاريح.
مراقبة نشاط الشبكة الخاص بك.
أضف قواعد التصفية المخصصة الخاصة بك.
الأهم من ذلك ، إنه الخادم الخاص بك ، وأنت الوحيد الذي يتحكم.
في هذه المرحلة ، يشترك Adguard Home في الكثير من العوامل المشتركة مع Pi-Hole. كل من إعلانات حظر وأجهزة التتبع باستخدام ما يسمى طريقة "DNS Sinkholing" ويسمح كلاهما بتخصيص ما تم حظره.
ملحوظة
لن نتوقف هنا. DNS Sinkholing ليس نقطة انطلاق سيئة ، ولكن هذه مجرد بداية.
يوفر AdGuard Home الكثير من الميزات خارج الصندوق دون حاجة لتثبيت وتكوين برامج إضافية. نريد أن يكون الأمر بسيطًا إلى هذه النقطة التي يمكن للمستخدمين العاديين حتى إعدادها بأقل جهد.
ملحوظة
يمكن إضافة بعض الميزات المدرجة إلى PI-Hole عن طريق تثبيت برامج إضافية أو عن طريق استخدام TSH Terminal وإعادة تكوين أحد الأدوات المساعدة PI. ومع ذلك ، في رأينا ، لا يمكن حساب هذا بشكل شرعي كميزة PI-Boly.
ميزة | منزل Adguard | بي ثقب |
---|---|---|
حظر الإعلانات والتعقب | ✅ | ✅ |
تخصيص قوائم الأحكام | ✅ | ✅ |
خادم DHCP مدمج | ✅ | ✅ |
HTTPS لواجهة المسؤول | ✅ | نوع من ، ولكن ستحتاج إلى تكوين LightTPD يدويًا |
خوادم DNS المنبع المشفرة (DNS-Over-HTTPS ، DNS-Over-TLS ، DNScrypt) | ✅ | (يتطلب برامج إضافية) |
منصة العرض | ✅ | (ليس أصليًا ، فقط عبر Docker) |
تشغيل كخادم DNS-Over-HTTPS أو DNS-Over-TLS | ✅ | (يتطلب برامج إضافية) |
حظر نطاقات التصيد والبرامج الضارة | ✅ | (يتطلب سائلات الأحكام غير الوافدة) |
التحكم الوالدي (حظر المجالات البالغة) | ✅ | (يتطلب سائلات الأحكام غير الوافدة) |
قوة البحث الآمن على محركات البحث | ✅ | |
لكل عميل (جهاز) التكوين | ✅ | ✅ |
إعدادات الوصول (اختر من يمكنه استخدام AGH DNS) | ✅ | |
التشغيل بدون امتيازات الجذر | ✅ |
ذلك يعتمد.
DNS Sinkholing قادر على منع نسبة كبيرة من الإعلانات ، ولكنه يفتقر إلى المرونة وقوة حاصرات الإعلانات التقليدية. يمكنك الحصول على انطباع جيد حول الفرق بين هذه الأساليب من خلال قراءة هذه المقالة ، والتي تقارن Adguard for Android (مانع الإعلانات التقليدي) إلى حاصرات الإعلانات على مستوى المضيفين (والتي تشبه تقريبًا الحدود المستندة إلى DNS في قدراتها). هذا المستوى من الحماية يكفي لبعض المستخدمين.
بالإضافة إلى ذلك ، يمكن أن يساعد استخدام مانع قائم على DNS في منع إعلانات التتبع والتحليلات على أنواع أخرى من الأجهزة ، مثل SmartTVs أو مكبرات صوت ذكية أو أنواع أخرى من أجهزة إنترنت الأشياء (التي لا يمكنك تثبيت حاصرات الإعلانات التقليدية).
فيما يلي بعض الأمثلة على ما لا يمكن حظره بواسطة مانع على مستوى DNS:
يوتيوب ، نشل الإعلانات ؛
Facebook و Twitter و Instagram المشاركات التي ترعاها.
في الأساس ، لا يمكن حظر أي إعلان يشترك في مجال مع المحتوى بواسطة مانع على مستوى DNS.
هل هناك فرصة للتعامل مع هذا في المستقبل؟ لن تكون DNS كافية للقيام بذلك. خيارنا الوحيد هو استخدام وكيل حظر المحتوى مثل ما نقوم به في تطبيقات adguard المستقلة. سنقدم دعم هذه الميزة إلى Adguard Home في المستقبل. لسوء الحظ ، حتى في هذه الحالة ، لا يزال هناك حالات لا يكون فيها هذا كافيًا أو سيتطلب تكوينًا معقدًا تمامًا.
تشغيل make init
لإعداد بيئة التنمية.
ستحتاج إلى هذا لبناء منزل adguard:
اذهب v1.23 أو أحدث ؛
node.js v18.18 أو الأحدث ؛
NPM V8 أو لاحقًا ؛
افتح المحطة الخاصة بك وتنفيذ هذه الأوامر:
git clone https://github.com/adguardteam/adguardhomecd adguardhome يصنع
تحذير
لا يتم دعم علامة -j
غير القياسية حاليًا ، لذا فإن البناء باستخدام make -j 4
أو وضع MAKEFLAGS
لتضمين ، على سبيل المثال ، من المحتمل أن يكسر -j 4
. إذا تم تعيين MAKEFLAGS
الخاص بك على ذلك ، ولا تريد تغييره ، فيمكنك تجاوزه عن طريق تشغيل make -j 1
.
تحقق من Makefile
للتعرف على الأوامر الأخرى.
يمكنك بناء Adguard Home لأي نظام تشغيل/قوس يدعم. من أجل القيام بذلك ، حدد متغيرات بيئة GOOS
و GOARCH
كآلات make
الماكرو عند التشغيل.
على سبيل المثال:
Env Goos = 'Linux' Goarch = 'Arm64' Make
أو:
جعل goos = 'linux' goarch = 'arm64'
ستحتاج إلى snapcraft
لإعداد بناء إصدار. بمجرد التثبيت ، قم بتشغيل الأمر التالي:
اجعل قناة Build-Release = '...' الإصدار = '...'
انظر الوثائق المستهدفة build-release
.
Run make build-docker
لإنشاء صورة Docker محليًا (الصورة التي ننشرها إلى DockerHub). يرجى ملاحظة أننا نستخدم Docker BuildX لبناء صورتنا الرسمية.
قد تحتاج إلى التحضير قبل استخدام هذه التصميمات:
(Linux-only) تثبيت QEMU:
Docker Run-RM-Multiarch/QEMU-User-Static-Reset -P Yes-Adcediential Yes
قم بإعداد المنشئ:
Docker BuildX Create-Name BuildX-Builder-Drofriver Docker-Container-Use
انظر الوثائق المستهدفة build-docker
.
عندما تحتاج إلى تصحيح الواجهة الأمامية دون إعادة تجميع إصدار الإنتاج في كل مرة ، على سبيل المثال ، للتحقق من كيفية ظهور الملصقات الخاصة بك ، يمكنك تشغيل الواجهة الأمامية لإنشاء بيئة تطوير.
في محطة منفصلة ، قم بتشغيل:
(CD ./client/ && env node_env = 'development' npm Run Watch)
قم بتشغيل AdGuardHome
binary مع العلم --local-frontend
، والذي يرشد Adguard إلى تجاهل ملفات الواجهة الأمامية المدمجة واستخدام تلك من دليل ./build/
.
الآن ، يجب إعادة ترجمة أي تغييرات تقوم بها في دليل ./client/
وتصبح متاحة على واجهة المستخدم على الويب. تأكد من تعطيل ذاكرة التخزين المؤقت للمتصفح للتأكد من حصولك على الإصدار المعاد ترجمة.
اهلا وسهلا بكم في شوكة هذا المستودع ، وقم بإجراء تغييراتك وتقديم طلب سحب. يرجى التأكد من اتباع إرشادات الكود لدينا رغم ذلك.
يرجى ملاحظة أننا لا نتوقع من الناس المساهمة في كل من واجهة المستخدم والأجزاء الخلفية من البرنامج في وقت واحد. من الناحية المثالية ، يتم تطبيق الجزء الخلفي أولاً ، أي تكوين ، واجهة برمجة التطبيقات ، والوظائف نفسها. يمكن تنفيذ جزء واجهة المستخدم لاحقًا في طلب سحب مختلف من قبل شخص مختلف.
هناك قناتان تحديثان يمكنك استخدامهما:
beta
: إصدارات بيتا من Adguard Home. إصدارات أكثر أو أقل استقرارًا ، عادة ما يتم إصدارها كل أسبوعين أو أكثر.
edge
: أحدث إصدار من Adguard Home من فرع التطوير. يتم دفع تحديثات جديدة إلى هذه القناة يوميًا.
هناك ثلاثة خيارات كيف يمكنك تثبيت إصدار غير مستقر:
Snap Store: ابحث عن قنوات beta
edge
.
Docker Hub: ابحث عن علامات beta
edge
.
بنيات مستقلة. استخدم البرنامج النصي التلقائي للتثبيت أو ابحث عن التصميمات المتاحة على الويكي.
البرنامج النصي لتثبيت نسخة تجريبية:
Curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --c beta
البرنامج النصي لتثبيت نسخة حافة:
Curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --c edge
إذا واجهت أي مشكلة أو لديك اقتراح ، توجه إلى هذه الصفحة وانقر على زر "المشكلة الجديدة". يرجى اتباع الإرشادات الموجودة في نموذج المشكلة بعناية ولا تنس البدء بالبحث عن التكرارات.
إذا كنت ترغب في المساعدة في ترجمات AdGuard Home ، فيرجى معرفة المزيد حول ترجمة منتجات AdGuard في قاعدة معرفتنا. يمكنك المساهمة في مشروع Adguardhome على Crowdin.
هناك طريقة أخرى يمكنك المساهمة من خلال البحث عن مشكلات محددة كمساعدة help wanted
، والسؤال عما إذا كانت المشكلة ترتفع للاستيلاء ، وإرسال العلاقات العامة التي تعمل على إصلاح الخلل أو تنفيذ الميزة.
يرجى ملاحظة أن هذه المشاريع لا تنتمي إلى AdGuard ، ولكن يتم صنعها من قبل مطوري الجهات الخارجية والمشجعين.
Adguard Home Remote: iOS App by Joost.
مكتبة Python بواسطة @Frenck.
مساعد المنزل الإضافية من قبل @فرنك.
تطبيق OpenWrt Luci بواسطة @kongfl888 (في الأصل بواسطة RufengSuixing).
Adguardhome Sync بواسطة bakito.
مراقبة حركة المرور في الوقت الفعلي في الوقت الفعلي والإحصائيات لمثيل adguard الخاص بك بواسطة @lissy93
Adguard Home على أجهزة توجيه Glinet بواسطة Glinet.
تطبيق Cloudron بواسطة gramakri.
ASUSWRT-MERLIN-ADGUARDHOME-Installer بواسطة @JUMPSMM7 الملقب @somewhereovertherainbow.
مكتبة Node.js بواسطة @Andrea055.
امتداد المتصفح بواسطة satheshshiva.
قالب Zabbix لـ AdGuard Home بواسطة diasdmhub.
حزمة الشوكولاتة بواسطة NIKS255.
هذا البرنامج لم يكن ممكنا بدون:
اذهب ومكتباتها:
GCache
DNS Miekg
go-yaml
خدمة
Dnsproxy
urlfilter
node.js ومكتباتها:
React.JS
تابلر
والعديد من الحزم node.js.
whotracks.me البيانات
ربما رأيت أنه تم ذكر Coredns هنا من قبل ، لكننا توقفنا عن استخدامه في Adguard Home.
للحصول على القائمة الكاملة لجميع حزم Node.js المستخدمة ، يرجى إلقاء نظرة على ملف client/package.json
.
فكرتنا الرئيسية هي أنك الشخص الذي يجب أن يكون يتحكم في بياناتك. لذلك من الطبيعي أن لا يقوم AdGuard Home بجمع أي إحصائيات استخدام ، ولا يستخدم أي خدمات ويب إلا إذا قمت بتكوينها للقيام بذلك. انظر أيضًا أن سياسة الخصوصية الكاملة مع كل بتات يمكن إرسالها من قبل AdGuard Home متاحة.