adguardteam/adguardhomeخادم DNS لحظر الإعلانات والمتتبعات على مستوى الشبكة
خادم DNS مجاني ومفتوح المصدر وقوي لحظر الإعلانات وأدوات التتبع على مستوى الشبكة.
AdGuard.com |
Wiki |
Reddit |
Twitter |
Telegram
AdGuard Home هو برنامج على مستوى الشبكة لحظر الإعلانات والتتبع. بعد إعداده، سيغطي جميع أجهزتك المنزلية، ولن تحتاج إلى أي برنامج على جهاز العميل للقيام بذلك.
يعمل كخادم DNS يعيد توجيه نطاقات التتبع إلى «ثقب أسود»، مما يمنع أجهزتك من الاتصال بتلك الخوادم. وهو مبني على البرنامج الذي نستخدمه لخوادم AdGuard DNS العامة لدينا، ويتشارك الاثنان في الكثير من الكود.
لتثبيت باستخدام curl، نفّذ الأمر التالي:```sh
curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v
للتثبيت باستخدام `wget`، نفّذ الأمر التالي:```sh
wget --no-verbose -O - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v
لتثبيت باستخدام fetch قم بتشغيل الأمر التالي:```sh
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` متنافيان.
### <a href="#alternative-methods" id="alternative-methods" name="alternative-methods">طرق بديلة</a>
#### <a href="#manual-installation" id="manual-installation" name="manual-installation">التثبيت اليدوي</a>
يُرجى قراءة مقال **[بدء الاستخدام][wiki-start]** على الويكي الخاص بنا لمعرفة كيفية تثبيت AdGuard Home يدويًا، وكيفية تكوين أجهزتك لاستخدامه.
#### <a href="#docker" id="docker" name="docker">Docker</a>
يمكنك استخدام صورة Docker الرسمية الخاصة بنا على [Docker Hub].
#### <a href="#snap-store" id="snap-store" name="snap-store">Snap Store</a>
إذا كنت تستخدم **Linux،** فهناك طريقة آمنة وسهلة لتثبيت AdGuard Home: احصل عليه من [Snap Store].
[Docker Hub]: https://hub.docker.com/r/adguard/adguardhome
[Snap Store]: https://snapcraft.io/adguard-home
[wiki-start]: https://adguard-dns.io/kb/adguard-home/getting-started/
### <a href="#guides" id="guides" name="guides">أدلة</a>
راجع [الويكي][wiki] الخاص بنا.
[wiki]: https://github.com/AdguardTeam/AdGuardHome/wiki
### <a href="#api" id="api" name="api">API</a>
إذا كنت ترغب في التكامل مع AdGuard Home، يمكنك استخدام [REST API][openapi] الخاص بنا. بدلاً من ذلك، يمكنك استخدام [عميل python][pyclient] هذا، والذي يمكن استخدامه لبناء [تكامل AdGuard Home Assistant][assistant-integration].
[assistant-integration]: https://www.home-assistant.io/integrations/adguard/
[openapi]: https://github.com/AdguardTeam/AdGuardHome/tree/master/openapi
[pyclient]: https://pypi.org/project/adguardhome/
## <a href="#comparison" id="comparison" name="comparison">مقارنة AdGuard Home مع الحلول الأخرى</a>
### <a href="#comparison-adguard-dns" id="comparison-adguard-dns" name="comparison-adguard-dns">ما الفرق بين هذا وبين خوادم AdGuard DNS العامة؟</a>
يتيح لك تشغيل خادم AdGuard Home الخاص بك إمكانية القيام بأكثر بكثير من مجرد استخدام خادم DNS عام. إنه مستوى مختلف تمامًا. اكتشف بنفسك:
- اختر بالضبط ما يحظره الخادم وما يسمح به.
- راقب نشاط شبكتك.
- أضف قواعد التصفية المخصصة الخاصة بك.
- **الأهم من ذلك، إنه خادمك الخاص، وأنت الوحيد الذي يتحكم فيه.**
### <a href="#comparison-pi-hole" id="comparison-pi-hole" name="comparison-pi-hole">كيف يُقارن AdGuard Home مع Pi-Hole؟</a>
عند هذه النقطة، لدى AdGuard Home الكثير من القواسم المشتركة مع Pi-Hole. كلاهما يحجب الإعلانات والمتتبعات باستخدام ما يسمى بطريقة “DNS sinkholing”، وكلاهما يسمح بتخصيص ما يتم حظره.
> [!NOTE]
> لن نتوقف هنا. إن DNS sinkholing ليس نقطة بداية سيئة، لكن هذه مجرد البداية.
يوفر AdGuard Home الكثير من الميزات بشكل جاهز دون الحاجة إلى تثبيت وتكوين برامج إضافية. نريده أن يكون بسيطًا لدرجة أن حتى المستخدمين العاديين يمكنهم إعداده بأقل جهد.
> [!NOTE]
> يمكن إضافة بعض الميزات المذكورة إلى Pi-Hole عن طريق تثبيت برامج إضافية أو باستخدام طرفية SSH يدويًا وإعادة تكوين إحدى الأدوات التي يتكون منها Pi-Hole. ومع ذلك، في رأينا، لا يمكن اعتبار هذا بشكل مشروع كميزة من ميزات Pi-Hole.
| الميزة | AdGuard Home | Pi-Hole |
|-------------------------------------------------------------------------|-------------------|-----------------------------------------------------------|
| حجب الإعلانات والمتتبعات | ✅ | ✅ |
| تخصيص قوائم الحظر | ✅ | ✅ |
| خادم DHCP مدمج | ✅ | ✅ |
| HTTPS لواجهة الإدارة | ✅ | نوعًا ما، لكنك ستحتاج إلى تكوين lighttpd يدويًا |
| خوادم DNS المشفرة (DNS-over-HTTPS، DNS-over-TLS، DNSCrypt) | ✅ | ❌ (يتطلب برامج إضافية) |
| متعدد المنصات | ✅ | ❌ (ليس بشكل أصلي، فقط عبر Docker) |
| يعمل كخادم DNS-over-HTTPS أو DNS-over-TLS | ✅ | ❌ (يتطلب برامج إضافية) |
| حجب نطاقات التصيد الاحتيالي والبرمجيات الخبيثة | ✅ | ❌ (يتطلب قوائم حظر غير افتراضية) |
| الرقابة الأبوية (حجب النطاقات الخاصة بالبالغين) | ✅ | ❌ (يتطلب قوائم حظر غير افتراضية) |
| فرض البحث الآمن على محركات البحث | ✅ | ❌ |
| تكوين لكل عميل (جهاز) | ✅ | ✅ |
| إعدادات الوصول (اختر من يمكنه استخدام AGH DNS) | ✅ | ❌ |
| التشغيل [بدون صلاحيات الجذر][wiki-noroot] | ✅ | ❌ |
[wiki-noroot]: https://adguard-dns.io/kb/adguard-home/getting-started/
### <a href="#comparison-adblock" id="comparison-adblock" name="comparison-adblock">كيف يُقارن AdGuard Home مع أدوات حجب الإعلانات التقليدية؟</a>
يعتمد الأمر.
إن DNS sinkholing قادر على حجب نسبة كبيرة من الإعلانات، لكنه يفتقر إلى مرونة وقوة أدوات حجب الإعلانات التقليدية. يمكنك الحصول على انطباع جيد حول الفرق بين هذه الطرق من خلال قراءة [هذه المقالة][blog-adaway]، التي تقارن AdGuard لنظام Android (أداة حجب إعلانات تقليدية) بأدوات الحجب على مستوى ملف hosts (وهي شبه متطابقة في قدراتها مع أدوات الحجب القائمة على DNS). هذا المستوى من الحماية كافٍ لبعض المستخدمين.
بالإضافة إلى ذلك، يمكن أن يساعد استخدام أداة حجب قائمة على DNS في حجب الإعلانات وطلبات التتبع والتحليلات على أنواع أخرى من الأجهزة، مثل أجهزة التلفاز الذكية (SmartTVs)، والسماعات الذكية، أو أنواع أخرى من أجهزة إنترنت الأشياء (IoT) (التي لا يمكنك تثبيت أدوات حجب الإعلانات التقليدية عليها).
### <a href="#comparison-limitations" id="comparison-limitations" name="comparison-limitations">القيود المعروفة</a>
فيما يلي بعض الأمثلة على ما لا يمكن حجبه بواسطة أداة حظر على مستوى DNS:
- إعلانات YouTube وTwitch؛
- المنشورات الممولة على Facebook وTwitter وInstagram.
بشكل أساسي، لا يمكن حجب أي إعلان يتشارك النطاق مع المحتوى بواسطة أداة حظر على مستوى DNS.
هل هناك فرصة للتعامل مع هذا في المستقبل؟ لن يكون DNS كافيًا أبدًا للقيام بذلك. خيارنا الوحيد هو استخدام وكيل لحجب المحتوى كما نفعل في تطبيقات AdGuard المستقلة. نحن [نعتزم إضافة][issue-1228] دعم هذه الميزة إلى AdGuard Home في المستقبل. لسوء الحظ، حتى في هذه الحالة، ستظل هناك حالات لا يكون فيها ذلك كافيًا أو يتطلب تكوينًا معقدًا إلى حد ما.
[blog-adaway]: https://adguard.com/blog/adguard-vs-adaway-dns66.html
[issue-1228]: https://github.com/AdguardTeam/AdGuardHome/issues/1228
## <a href="#how-to-build" id="how-to-build" name="how-to-build">كيفية البناء من المصدر</a>
### <a href="#prerequisites" id="prerequisites" name="prerequisites">المتطلبات الأساسية</a>
شغّل `make init` لتجهيز بيئة التطوير.
ستحتاج إلى ما يلي لبناء AdGuard Home:
- [Go](https://golang.org/dl/) v1.25 أو أحدث؛
- [Node.js](https://nodejs.org/en/download/) v24.10.0 أو أحدث؛
- [npm](https://www.npmjs.com/) v10.8 أو أحدث؛
### <a href="#building" id="building" name="building">البناء</a>
افتح الطرفية (الترمنال) ونفّذ هذه الأوامر:```sh
git clone https://github.com/AdguardTeam/AdGuardHome
cd AdGuardHome
make
[!WARNING] الخيار غير القياسي
-jغير مدعوم حاليًا، لذا فإن البناء باستخدامmake -j 4أو ضبطMAKEFLAGSبحيث يتضمن، على سبيل المثال،-j 4من المرجح أن يُفشل البناء. إذا كانMAKEFLAGSلديك مضبوطًا على ذلك ولا تريد تغييره، يمكنك تجاوزه بتشغيلmake -j 1.
راجع Makefile لمعرفة الأوامر الأخرى.
يمكنك بناء AdGuard Home لأي OS/ARCH يدعمه Go. للقيام بذلك، حدد متغيري البيئة GOOS وGOARCH كمعاملات ماكرو عند تشغيل make.
على سبيل المثال:```sh env GOOS='linux' GOARCH='arm64' make
أو:```sh
make GOOS='linux' GOARCH='arm64'
ستحتاج إلى snapcraft لتحضير بناء إصدار. بمجرد تثبيته، قم بتشغيل الأمر التالي:```sh
make build-release CHANNEL='...' VERSION='...'
انظر إلى [توثيق هدف `build-release`][targ-release].
#### <a href="#docker-image" id="docker-image" name="docker-image">صورة Docker</a>
شغّل `make build-docker` لبناء صورة Docker محليًا (الصورة التي ننشرها إلى DockerHub). يرجى ملاحظة أننا نستخدم [Docker Buildx][buildx] لبناء صورتنا الرسمية.
قد تحتاج إلى التحضير قبل استخدام هذه البناءات:
- (خاص بـ Linux فقط) ثبّت Qemu: ```sh
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes --credential yes
See the build-docker target documentation.
عندما تحتاج إلى تصحيح أخطاء الواجهة الأمامية دون إعادة ترجمة نسخة الإنتاج في كل مرة، على سبيل المثال للتحقق من شكل التسميات في نموذج، يمكنك تشغيل بناء الواجهة الأمامية في بيئة تطوير.
في محطة طرفية منفصلة، قم بتشغيل: ```sh ( cd ./client/ && env NODE_ENV='development' npm run watch )
شغّل ملف AdGuardHome الثنائي مع العلامة --local-frontend، والتي توجّه AdGuard Home لتجاهل ملفات الواجهة الأمامية المدمجة واستخدام تلك الموجودة في دليل ./build/.
الآن، أي تغييرات تجريها في دليل ./client/ يجب أن يُعاد تجميعها وتصبح متاحة في واجهة الويب. تأكد من تعطيل ذاكرة التخزين المؤقت للمتصفح لضمان حصولك على النسخة المعاد تجميعها فعليًا.
يستخدم AdGuard Home أداة Playwright لإجراء اختبارات E2E. توجد الاختبارات في tests/e2e.
تشغيل الاختبارات:
npm run test:e2e – تشغيل جميع الاختبارات (بدون واجهة رسومية).npm run test:e2e:interactive – تشغيل الاختبارات بشكل تفاعلي.npm run test:e2e:debug – تشغيل الاختبارات في وضع التصحيح.npm run test:e2e:codegen – إنشاء كود اختبار جديد.الإعداد:
npm install لتثبيت التبعيات.npx playwright install لإعداد المتصفحات المطلوبة.تحذير: سيقوم Playwright بتنزيل وتثبيت ملفات المتصفح الثنائية الخاصة به للاختبار، والتي قد تختلف عن المتصفحات المثبتة على نظامك.
يسعدنا أن تقوم بعمل fork لهذا المستودع، وإجراء تغييراتك وتقديم طلب سحب. ومع ذلك، يرجى التأكد من اتباع إرشادات الكود.
يرجى ملاحظة أننا لا نتوقع أن يساهم الأشخاص في جزأي الواجهة الأمامية (UI) والخلفية (backend) من البرنامج في الوقت نفسه. ومن الناحية المثالية، يتم تنفيذ الجزء الخلفي أولاً، أي الإعدادات وAPI والوظيفة نفسها. ويمكن تنفيذ جزء الواجهة الأمامية لاحقًا في طلب سحب مختلف بواسطة شخص مختلف.
توجد قناتان للتحديث يمكنك استخدامهما:
beta: إصدارات بيتا من AdGuard Home. إصدارات شبه مستقرة، وعادةً ما تُصدر كل أسبوعين أو أكثر.
edge: أحدث إصدار من AdGuard Home من فرع التطوير. يتم دفع تحديثات جديدة إلى هذه القناة يوميًا.
هناك ثلاثة خيارات لتثبيت إصدار غير مستقر:
[Snap Store]: ابحث عن قناتي beta وedge.
[Docker Hub]: ابحث عن وسمَي beta وedge.
البنيات المستقلة. استخدم سكربت التثبيت الآلي أو ابحث عن البنيات المتاحة [على الويكي][wiki-platf].
سكربت لتثبيت إصدار بيتا: ```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -c beta
سكربت لتثبيت إصدار تجريبي: ```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -c edge
[wiki-platf]: https://github.com/AdguardTeam/AdGuardHome/wiki/Platforms
### <a href="#reporting-issues" id="reporting-issues" name="reporting-issues">الإبلاغ عن المشكلات</a>
إذا واجهت أي مشكلة أو كان لديك اقتراح، فانتقل إلى [هذه الصفحة][iss] وانقر على الزر “New issue”. يرجى اتباع التعليمات في نموذج المشكلة بعناية ولا تنسَ أن تبدأ بالبحث عن المشكلات المكررة.
[iss]: https://github.com/AdguardTeam/AdGuardHome/issues
### <a href="#translate" id="translate" name="translate">المساعدة في الترجمات</a>
إذا كنت تريد المساعدة في ترجمات AdGuard Home، فيرجى معرفة المزيد حول ترجمة منتجات AdGuard [في قاعدة المعرفة الخاصة بنا][kb-trans]. يمكنك المساهمة في [مشروع AdGuardHome على CrowdIn][crowdin].
[crowdin]: https://crowdin.com/project/adguard-applications/en#/adguard-home
[kb-trans]: https://kb.adguard.com/en/general/adguard-translations
### <a href="#help-other" id="help-other" name="help-other">أخرى</a>
طريقة أخرى يمكنك المساهمة بها هي [البحث عن المشكلات][iss-help] الموسومة بـ `help wanted`، والسؤال عما إذا كانت المشكلة متاحة للتنفيذ، ثم إرسال PR لإصلاح الخلل أو تنفيذ الميزة.
[iss-help]: https://github.com/AdguardTeam/AdGuardHome/issues?q=is:issue+is:open+label:%22help+wanted%22
## <a href="#uses" id="uses" name="uses">المشاريع التي تستخدم AdGuard Home</a>
يرجى ملاحظة أن هذه المشاريع غير تابعة لـ AdGuard، بل أنشأها مطورون ومعجبون من جهات خارجية.
- [AdGuard Home Remote](https://apps.apple.com/app/apple-store/id1543143740): تطبيق iOS من [Joost](https://rocketscience-it.nl/).
- [مكتبة Python](https://github.com/frenck/python-adguardhome) من [@frenck](https://github.com/frenck).
- [إضافة Home Assistant](https://github.com/hassio-addons/addon-adguard-home) من [@frenck](https://github.com/frenck).
- [تطبيق OpenWrt LUCI](https://github.com/kongfl888/luci-app-adguardhome) من [@kongfl888](https://github.com/kongfl888) (في الأصل من [@rufengsuixing](https://github.com/rufengsuixing)).
- [مزامنة AdGuardHome](https://github.com/bakito/adguardhome-sync) من [@bakito](https://github.com/bakito).
- [مراقبة حركة المرور والإحصائيات في الوقت الفعلي عبر الطرفية لمثيل AdGuard Home الخاص بك](https://github.com/Lissy93/AdGuardian-Term) من [@Lissy93](https://github.com/Lissy93)
- [AdGuard Home على أجهزة توجيه GLInet](https://forum.gl-inet.com/t/adguardhome-on-gl-routers/10664) من [Gl-Inet](https://gl-inet.com/).
- [تطبيق Cloudron](https://git.cloudron.io/cloudron/adguard-home-app) من [@gramakri](https://github.com/gramakri).
- [Asuswrt-Merlin-AdGuardHome-Installer](https://github.com/jumpsmm7/Asuswrt-Merlin-AdGuardHome-Installer) من [@jumpsmm7](https://github.com/jumpsmm7) ويعرف أيضًا بـ [@SomeWhereOverTheRainBow](https://www.snbforums.com/members/somewhereovertherainbow.64179/).
- [مكتبة Node.js](https://github.com/Andrea055/AdguardHomeAPI) من [@Andrea055](https://github.com/Andrea055/).
- [إضافة المتصفح](https://github.com/satheshshiva/Adguard-Home-Browser-Ext) من [@satheshshiva](https://github.com/satheshshiva/).
- [قالب Zabbix لـ AdGuard Home](https://github.com/diasdmhub/AdGuard_Home_Zabbix_Template) من [@diasdmhub](https://github.com/diasdmhub).
- [حزمة Chocolatey](https://community.chocolatey.org/packages/adguardhome/) من [niks255](https://community.chocolatey.org/profiles/niks255).
- [قائمة متجر تطبيقات ZimaOS](https://www.zimaspace.com/zimaos/app-store/app/org.icewhale.adguardhome) من [فريق CasaOS](https://casaos.zimaspace.com/).
## <a href="#acknowledgments" id="acknowledgments" name="acknowledgments">شكر وتقدير</a>
لم يكن هذا البرنامج ممكنًا لولا:
- [Go](https://golang.org/dl/) ومكتباته:
- [gcache](https://github.com/bluele/gcache)
- [miekg's dns](https://github.com/miekg/dns)
- [go-yaml](https://github.com/go-yaml/yaml)
- [service](https://godoc.org/github.com/kardianos/service)
- [dnsproxy](https://github.com/AdguardTeam/dnsproxy)
- [urlfilter](https://github.com/AdguardTeam/urlfilter)
- [Node.js](https://nodejs.org/) ومكتباته:
- [React.js](https://reactjs.org)
- [Tabler](https://github.com/tabler/tabler)
- والعديد من حزم Node.js الأخرى.
- [بيانات whotracks.me](https://github.com/cliqz-oss/whotracks.me)
ربما لاحظت أن [CoreDNS] كان مذكورًا هنا سابقًا، لكننا توقفنا عن استخدامه في AdGuard Home.
للحصول على القائمة الكاملة لجميع حزم Node.js المستخدمة، يرجى إلقاء نظرة على ملف [`client/package.json`][src-packagejson].
[CoreDNS]: https://coredns.io
[src-packagejson]: https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/client/package.json
## <a href="#privacy" id="privacy" name="privacy">الخصوصية</a>
فكرتنا الأساسية هي أنك أنت من يجب أن يتحكم في بياناتك. لذلك من الطبيعي ألا يجمع AdGuard Home أي إحصائيات استخدام، ولا يستخدم أي خدمات ويب إلا إذا قمت بتهيئته للقيام بذلك. اطلع أيضًا على [سياسة الخصوصية الكاملة][privacy] حيث تتوفر كل معلومة *قد تُرسل نظريًا* بواسطة AdGuard Home.
[privacy]: https://adguard.com/en/privacy/home.html