تثبيت Pi-hole وAdGuard Home: حجب الإعلانات على مستوى الشبكة

version: '3.8'

services:
  pihole:
    image: pihole/pihole:latest
    container_name: pihole
    restart: unless-stopped
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "127.0.0.1:8080:80"
    environment:
      TZ: 'Asia/Riyadh'
      WEBPASSWORD: 'كلمة-مرور-قوية'
      PIHOLE_DNS_: '1.1.1.1;8.8.8.8'
      DNSSEC: 'true'
      DNSMASQ_LISTENING: 'all'
    volumes:
      - ./pihole/etc-pihole:/etc/pihole
      - ./pihole/etc-dnsmasq.d:/etc/dnsmasq.d
    cap_add:
      - NET_ADMIN

# إيقاف الخدمة التي تستخدم المنفذ 53 (Ubuntu)
sudo systemctl stop systemd-resolved
sudo systemctl disable systemd-resolved

# تحديث /etc/resolv.conf
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf

# تشغيل Pi-hole
docker compose up -d

version: '3.8'

services:
  adguardhome:
    image: adguard/adguardhome:latest
    container_name: adguardhome
    restart: unless-stopped
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "127.0.0.1:3000:3000"
      - "127.0.0.1:8080:80"
      - "853:853/tcp"
      - "443:443/tcp"
    volumes:
      - ./adguard/work:/opt/adguardhome/work
      - ./adguard/conf:/opt/adguardhome/conf

docker compose up -d
# الإعداد الأولي: http://IP_الخادم:3000

لوحة إدارة الراوتر → إعدادات DHCP
DNS الأساسي: IP_الخادم (IP Pi-hole/AdGuard)
DNS الثانوي: 1.1.1.1 (احتياطي)

# Linux
sudo nano /etc/resolv.conf
nameserver IP_الخادم

# Windows (PowerShell)
Set-DnsClientServerAddress -InterfaceAlias "Ethernet" -ServerAddresses IP_الخادم

Group Management → Adlists → إضافة

قوائم شائعة:
https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts
https://adaway.org/hosts.txt
https://v.firebog.net/hosts/Easylist.txt
https://v.firebog.net/hosts/Easyprivacy.txt

# تحديث gravity (تحديث القوائم)
docker exec pihole pihole -g

الفلاتر → قوائم حجب DNS → إضافة قائمة حجب

قوائم موصى بها:
- AdGuard DNS filter (افتراضي)
- EasyList
- EasyPrivacy
- Malware Domains

# إضافة إلى القائمة البيضاء
docker exec pihole pihole -w example.com

# إضافة إلى القائمة السوداء
docker exec pihole pihole -b ads.example.com

# قائمة سوداء Regex
docker exec pihole pihole --regex '(^|\.)ads\..*'

الفلاتر → قواعد الفلترة المخصصة

# حجب
||ads.example.com^

# السماح (قائمة بيضاء)
@@||example.com^

Pi-hole: الإعدادات → DHCP
- خادم DHCP مفعّل: نعم
- النطاق: 192.168.1.100 - 192.168.1.200
- الراوتر: 192.168.1.1
- مدة الإيجار: 24 ساعة

AdGuard Home: الإعدادات → إعدادات DHCP
- تفعيل خادم DHCP
- نطاق IP: 192.168.1.100 - 192.168.1.200
- البوابة: 192.168.1.1

الإعدادات → إعدادات التشفير:
- تفعيل التشفير: نعم
- اسم الخادم: dns.example.com
- منفذ HTTPS: 443
- منفذ DNS-over-TLS: 853

cloudflared:
  image: cloudflare/cloudflared:latest
  container_name: cloudflared
  restart: unless-stopped
  command: proxy-dns --port 5053 --upstream https://1.1.1.1/dns-query
  network_mode: host

Pi-hole → الإعدادات → DNS
DNS مخصص: 127.0.0.1#5053