Docker-Compose on FahdLABs | مختّبر فهد

شرح AdGuard Home: مانع إعلانات لكل أجهزة البيت عبر DNS (Docker + Raspberry Pi)

Wed, 11 Feb 2026 10:00:00 +0300

هذا الدليل هو نسخة مكتوبة وموسعة من الفيديو:

إذا تبغى تحجب الإعلانات والتتبع من كل أجهزة البيت (جوال، كمبيوتر، تلفزيون)، الحل العملي هو DNS مركزي داخل الشبكة.

فكرة AdGuard Home باختصار

بدل ما كل جهاز يستخدم DNS عام مباشرة، نخلي طلبات DNS تمر عبر AdGuard Home داخل الشبكة المنزلية. وقتها:

دومينات الإعلانات تُحجب قبل التحميل.
يقل التتبع.
تقدر تحجب مواقع محددة على مستوى البيت كامل.

بمعنى أبسط: بدل ما كل جهاز يحاول يحجب الإعلانات بنفسه، تخلي الشبكة كلها تمر من فلتر واحد.

المتطلبات

جهاز يشغل Docker (Raspberry Pi أو جهاز قديم).
عنوان IP ثابت لهذا الجهاز.
وصول لإعدادات الراوتر.

الطريقة 1 (مثل الفيديو): التشغيل عبر Dockge

إذا عندك Dockge، أنشئ Stack جديد لـ AdGuard Home وشغّله.

متى تختار هذه الطريقة؟ إذا أنت أصلًا تدير خدماتك من Dockge وتبغى كل شيء في مكان واحد.

الطريقة 2: Docker Compose مباشر (بدون Dockge)

1) إنشاء المجلدات

1
2


mkdir -p ~/adguard/{work,conf}
cd ~/adguard

2) إنشاء ملف `docker-compose.yml`

1

nano docker-compose.yml

3) ألصق الإعداد التالي

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


services:
 adguardhome:
 image: adguard/adguardhome:latest
 container_name: adguardhome
 restart: unless-stopped
 environment:
 - TZ=Asia/Riyadh
 volumes:
 - ./work:/opt/adguardhome/work
 - ./conf:/opt/adguardhome/conf
 ports:
 - "3000:3000" # صفحة الإعداد أول مرة
 - "80:80" # لوحة التحكم بعد الإعداد
 - "53:53/tcp" # DNS TCP
 - "53:53/udp" # DNS UDP

4) تشغيل الخدمة

1

docker compose up -d

5) التأكد من التشغيل

1
2


docker ps
docker logs -f adguardhome

1) الإعداد الأول (Wizard)

افتح:

1

http://RASPBERRY_PI_IP:3000

ثم:

اختر اللغة.
أنشئ حساب الإدارة.
أكمل خطوات الإعداد الافتراضية.

بعد الانتهاء، لوحة التحكم تكون غالبًا على:

1

http://RASPBERRY_PI_IP

2) إعدادات DNS (المهم فعليًا)

من لوحة التحكم: الإعدادات → إعدادات DNS

a) خوادم DNS العليا (Upstream DNS)

القيم التي استخدمتها:

tls://dns.quad9.net
tls://unfiltered.joindns4.eu

ليش هذا مهم؟

هذه هي الخوادم التي يسألها AdGuard لما ما يلقى جواب محلي.
استخدام tls:// يعني DNS مشفّر (DoT)، فيحسن الخصوصية.

بعدها:

فعّل Parallel requests عشان أسرع استجابة.
أضف خوادم DNS احتياطية:
9.9.9.10
86.54.11.100
اضغط اختبار ثم تطبيق.

b) إعداد خادم DNS

معدل الطلبات (Rate limit): 100
تفعيل Enable DNSSEC

ليش؟

Rate limit يساعد ضد الإغراق أو الطلبات الغير طبيعية من جهاز خربان بالشبكة.
DNSSEC يتحقق من صحة ردود DNS (أمان أعلى).

c) الكاش (DNS Cache)

القيم المستخدمة:

Cache size = 10000000
Override minimum TTL = 3600
Override maximum TTL = 86400
تفعيل Optimistic caching

معنى هذه الخيارات باختصار:

Cache size: حجم الذاكرة المخصصة لتخزين ردود DNS، وكل ما كان مناسب يقل وقت الاستجابة.
Minimum TTL: أقل مدة يحتفظ فيها AdGuard بالرد داخل الكاش.
Maximum TTL: أعلى مدة مسموح بها للاحتفاظ بالرد داخل الكاش.
Optimistic caching: يرجع نتيجة سريعة من الكاش ويحدّثها بالخلفية.

3) إعدادات الفلاتر (Blocklists)

من لوحة التحكم: الفلاتر → قوائم حظر DNS

الخطوات:

أزل تحديد القائمة الافتراضية إذا كنت تريد الاعتماد على قوائمك.
اضغط إضافة قائمة حظر.
اختر من القوائم الجاهزة.
أضف القائمة التي استخدمتها: HaGeZi's Pro Blocklist.
اضغط تحقق من وجود تحديثات.

ملاحظة عملية: قائمتين جيدتين عادةً تكفي. كثرة القوائم قد تسبب حجب زائد أو بطء.

4) الإعدادات العامة (Logs + Statistics)

من لوحة التحكم: الإعدادات → الإعدادات العامة

a) تكوين السجلات (Logs retention)

اختر عدد الأيام التي تريد حفظ السجلات فيها (أنا اخترت 30 يوم).

وش تحفظ هذه؟

سجل الاستعلامات: أي جهاز سأل عن أي دومين ومتى.
يفيدك في تتبع المشاكل ومعرفة أكثر الدومينات المحجوبة.

كل ما زادت الأيام، يزيد استهلاك التخزين.

b) تكوين الإحصائيات (Statistics retention)

أنا اخترت 7 أيام بدل الافتراضي 24 ساعة.

وش تحفظ هذه؟

بيانات الرسوم البيانية في لوحة الإحصائيات.
عدد الطلبات، عدد المحجوب، وأكثر الدومينات نشاطًا خلال المدة المحددة.

إذا تبغى رؤية أسبوعية واضحة، 7 أيام خيار ممتاز.

أهم خطوة: ربط DNS في الراوتر

ادخل إعدادات الراوتر وضع DNS الرئيسي (وأحيانًا الثانوي) على IP جهاز AdGuard:

DNS1 = 192.168.100.55 (مثال)
DNS2 = 192.168.100.55 (إذا الراوتر يجبرك)

بعد الحفظ، انتظر دقيقة أو دقيقتين ثم اختبر.

اختبار قبل/بعد

افتح موقع كان يظهر إعلانات قبل.
حدّث الصفحة بعد تفعيل DNS في الراوتر.
ارجع لوحة AdGuard وتأكد من زيادة الطلبات المحجوبة.
افتح نفس الموقع الي كان يظهر إعلانات.

حجب مواقع معينة للبيت كامل

من الفلاتر: a) الخوادم المحجوبة مواقع جاهزة تقدر تحجبها بضغطة زر اغلب المواقع المعروفة موجودة هنا b) قواعد التصفية المخصصة أضف قواعد مخصصة دومين بدومين.

مثال قاعدة حجب:

1

||example.com^

صفحة الاحصائيات بعد اول استخدام

أخطاء شائعة وحلولها

1. ما صار أي حجب بعد التثبيت

غالبًا الأجهزة ما زالت تستخدم DNS قديم. الحل:

تأكد DNS الراوتر يشير إلى AdGuard.
افصل/أعد اتصال الشبكة على الأجهزة.

2. تعارض على بورت 53

يوجد خدمة ثانية تستخدم DNS على نفس السيرفر. الحل: أوقف الخدمة المتعارضة أو غيّر التصميم.

3. لوحة التحكم لا تفتح

تحقق من:

docker ps
المنفذ الصحيح (3000 للإعداد الأول، ثم 80 غالبًا للوحة).
جدار الحماية المحلي.

FAQ

هل لازم Raspberry Pi 5؟

لا، أي جهاز يشغل Adguard Home يكفي.

هل هذا يحجب كل الإعلانات 100%؟

لا، لكنه يقلل نسبة كبيرة جدًا من إعلانات DNS-based tracking والطلبات الإعلانية.

مهم: بعض التطبيقات تعرض إعلانات من نفس دومين الخدمة الرئيسية، ووقتها DNS blocking وحده قد لا يكفي.

هل أقدر أخليه يعمل على جهاز واحد فقط؟

نعم، ضع DNS يدوي لذلك الجهاز بدل تغييره على الراوتر.

المصادر الرسمية (للتحديثات)

AdGuard Home GitHub: https://github.com/AdguardTeam/AdGuardHome
AdGuard Home Docker Image: https://hub.docker.com/r/adguard/adguardhome
Docker Compose Documentation: https://docs.docker.com/compose/

الخلاصة

AdGuard Home يعطيك حماية وراحة أفضل لكل أجهزة البيت من نقطة مركزية واحدة. مع IP ثابت + DNS صحيح على الراوتر، النتيجة تكون واضحة جدًا من أول يوم.

شرح Dockge بالعربي: إدارة Docker Compose بسهولة على Raspberry Pi

Sat, 07 Feb 2026 10:00:00 +0300

هذا الدليل هو نسخة مكتوبة وموسعة من الفيديو:

إذا تستخدم Docker Compose وتبغى إدارة أسهل من التيرمنال، Dockge يعطيك لوحة بسيطة وسريعة بدون تعقيد.

ما هو Dockge؟

Dockge أداة مفتوحة المصدر لإدارة مشاريع docker-compose من واجهة ويب.

تقدر من خلالها:

إنشاء Stack جديد.
تشغيل/إيقاف/تحديث الخدمات.
تعديل compose.yaml مباشرة.
قراءة Logs من نفس الواجهة.

متى يكون Dockge مناسب لك؟

عندك سيرفر واحد أو بيئة منزلية صغيرة.
تستخدم docker-compose بشكل يومي.
تبغى واجهة بسيطة بدون تعقيد أدوات أكبر.

قبل التثبيت

Docker + Docker Compose يجب أن يكونا جاهزين.
يفضل أن يكون الراسبيري باي له IP ثابت.

إذا لم تجهّزها بعد:

1) إنشاء مجلد العمل

1
2


mkdir -p ~/dockge
cd ~/dockge

2) إنشاء ملف compose.yaml لـ Dockge

1

nano compose.yaml

ضع هذا المحتوى:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


services:
 dockge:
 image: louislam/dockge:latest
 container_name: dockge
 restart: unless-stopped
 ports:
 - "5001:5001"
 volumes:
 - /var/run/docker.sock:/var/run/docker.sock
 - ./data:/app/data
 - /full/path/to/folder/stacks:/full/path/to/folder/stacks
 environment:
 - DOCKGE_STACKS_DIR=/full/path/to/folder/stacks

ثم احفظ الملف من خلال الضغط على

ctrl+x
y
enter

ملاحظة مهمة:

لازم المسار الي فيه ال ستاكس يكون مسار كامل مسار الداتا عادي يكون نسبي

نسبي مثل: ./data
كامل مثل: /home/fahdlabs/dockge/stacks
ومسار الستاكس لازم اليمين يكون نفس اليسار
مسار DOCKGE_STACKS_DIR لازم يطابق المسار المربوط في volumes.

3) تجهيز المجلدات المطلوبة

1

mkdir -p data stacks

4) تشغيل Dockge

1

docker compose up -d

تحقق:

1

docker ps

5) فتح الواجهة وإنشاء حساب Admin

من المتصفح:

1

http://RASPBERRY_PI_IP:5001

أول دخول سيطلب إنشاء حساب مدير.

6) إنشاء أول Stack تجريبي (whoami)

من داخل Dockge:

اضغط + Compose.
سمّ الـ Stack: whoami.
ألصق ملف Compose التالي:

1
2
3
4
5
6
7


services:
 whoami:
 image: traefik/whoami
 container_name: whoami
 restart: unless-stopped
 ports:
 - "8080:80"

احفظ.
اضغط Start.

اختبر الخدمة:

1

http://RASPBERRY_PI_IP:8080

ليش whoami؟ لأنها خدمة اختبار خفيفة جدًا وتأكد بسرعة أن مسار Dockge كامل شغال من البداية للنهاية.

7) أهم المميزات العملية في Dockge

Logs: لمتابعة مشاكل التشغيل بسرعة.
Edit: تعديل Compose بدون الرجوع للتيرمنال.
Stop/Start/Restart: إدارة سريعة لكل Stack.
Update: سحب أحدث صورة وإعادة التشغيل.

هيكلة منظمة مقترحة لمشاريعك

داخل ~/dockge/stacks/ اجعل كل خدمة في مجلد مستقل:

دوكجي يسويها لك بهذا الشكل من نفسه

1
2
3
4
5
6
7


stacks/
 adguard/
 compose.yaml
 immich/
 compose.yaml
 uptime-kuma/
 compose.yaml

هذا يسهل النسخ الاحتياطي والمتابعة.

أخطاء شائعة وحلولها

1. `docker: permission denied`

أضف المستخدم لمجموعة docker:

1

sudo usermod -aG docker $USER

ثم أعد تسجيل الدخول.

2. `no such file or directory: compose.yaml`

شغّلت الأمر من مجلد غير صحيح. الحل: ادخل ~/dockge ثم أعد التنفيذ.

3. Stack لا يظهر في Dockge

تأكد أن:

قيمة DOCKGE_STACKS_DIR نفس المسار الكامل الذي اخترته للـ stacks.
مثال صحيح:

1
2
3
4


volumes:
 - /home/USERNAME/dockge/stacks:/home/USERNAME/dockge/stacks
environment:
 - DOCKGE_STACKS_DIR=/home/USERNAME/dockge/stacks

FAQ

هل Dockge بديل كامل لـ Portainer؟

ليس نفس الفلسفة. Dockge أخف ومركز على Docker Compose بشكل مباشر وبسيط.

قاعدة سريعة:

إذا تريد إدارة Compose بسرعة وبشكل واضح: Dockge ممتاز.
إذا تريد إدارة أوسع (Swarm/Features كثيرة): فكر لاحقًا بأدوات أكبر.

هل ينفع على سيرفر واحد منزلي؟

نعم، وهذه أفضل حالة استخدام له.

هل يدعم العربية؟

نعم، يوجد دعم واجهة عربي ويمكن تغييره من الإعدادات.

المصادر الرسمية (للتحديثات)

Dockge Official Website: https://dockge.kuma.pet/
Dockge GitHub: https://github.com/louislam/dockge
Docker Compose Documentation: https://docs.docker.com/compose/

الخلاصة

Dockge يعطيك طريقة سريعة ومرتبة لإدارة docker-compose في الهوم لاب. وهو تجهيز ممتاز قبل تشغيل خدمات مثل AdGuard Home.

Docker-Compose on FahdLABs | مختّبر فهد

شرح AdGuard Home: مانع إعلانات لكل أجهزة البيت عبر DNS (Docker + Raspberry Pi)

فكرة AdGuard Home باختصار

المتطلبات

الطريقة 1 (مثل الفيديو): التشغيل عبر Dockge

الطريقة 2: Docker Compose مباشر (بدون Dockge)

1) إنشاء المجلدات

2) إنشاء ملف docker-compose.yml

3) ألصق الإعداد التالي

4) تشغيل الخدمة

5) التأكد من التشغيل

1) الإعداد الأول (Wizard)

2) إعدادات DNS (المهم فعليًا)

a) خوادم DNS العليا (Upstream DNS)

b) إعداد خادم DNS

c) الكاش (DNS Cache)

3) إعدادات الفلاتر (Blocklists)

4) الإعدادات العامة (Logs + Statistics)

a) تكوين السجلات (Logs retention)

b) تكوين الإحصائيات (Statistics retention)

أهم خطوة: ربط DNS في الراوتر

اختبار قبل/بعد

حجب مواقع معينة للبيت كامل

صفحة الاحصائيات بعد اول استخدام

أخطاء شائعة وحلولها

1. ما صار أي حجب بعد التثبيت

2. تعارض على بورت 53

3. لوحة التحكم لا تفتح

FAQ

هل لازم Raspberry Pi 5؟

هل هذا يحجب كل الإعلانات 100%؟

هل أقدر أخليه يعمل على جهاز واحد فقط؟

المصادر الرسمية (للتحديثات)

الخلاصة

شرح Dockge بالعربي: إدارة Docker Compose بسهولة على Raspberry Pi

ما هو Dockge؟

قبل التثبيت

1) إنشاء مجلد العمل

2) إنشاء ملف compose.yaml لـ Dockge

3) تجهيز المجلدات المطلوبة

4) تشغيل Dockge

5) فتح الواجهة وإنشاء حساب Admin

6) إنشاء أول Stack تجريبي (whoami)

7) أهم المميزات العملية في Dockge

هيكلة منظمة مقترحة لمشاريعك

أخطاء شائعة وحلولها

1. docker: permission denied

2. no such file or directory: compose.yaml

3. Stack لا يظهر في Dockge

FAQ

هل Dockge بديل كامل لـ Portainer؟

هل ينفع على سيرفر واحد منزلي؟

هل يدعم العربية؟

المصادر الرسمية (للتحديثات)

الخلاصة

2) إنشاء ملف `docker-compose.yml`

1. `docker: permission denied`

2. `no such file or directory: compose.yaml`