**كل جهاز محمي:** الهواتف، الأجهزة اللوحية، أجهزة الكمبيوتر المحمولة، أجهزة التلفاز الذكية، أجهزة الألعاب، أجهزة إنترنت الأشياء، الضيوف - كل شيء. يمكن [تجاوز](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/CONFIGURATION.md#vpn-bypass-routing) الأجهزة الفردية للوصول المباشر إلى الشبكة الواسعة عند الحاجة.

---

## لماذا لا نستخدم فقط تطبيقات Mullvad QUIC أو WireGuard؟

سؤال رائع. أنفاق QUIC وتطبيقات WireGuard من Mullvad ممتازة لحماية الأجهزة الفردية. إليك متى يكون كل نهج مناسبًا:

### تطبيقات VPN أفضل عندما:
- تحتاج فقط لحماية 1-2 أجهزة
- تسافر كثيرًا وتستخدم شبكات مختلفة
- تريد تقسيم التطبيقات لكل تطبيق على حدة
- أنت على شبكة لا تتحكم بها

### VPN على مستوى الشبكة أفضل عندما:
- لديك العديد من الأجهزة (خاصة تلك التي لا يمكنها تشغيل تطبيقات VPN)
- تريد حماية "اضبط وانسَ" لجميع أفراد منزلك
- تحتاج إلى حماية أجهزة المنزل الذكي/إنترنت الأشياء
- تريد **مفتاح قتل يعمل بالفعل** (المزيد حول هذا أدناه)
- أنت في منطقة بها حظر VPN/فحص عميق للحزم

### مشكلة مفتاح القتل

إليك شيء لا يدركه معظم الناس: **مفاتيح قتل تطبيقات VPN غالبًا ما تفشل**.

عندما يتعطل تطبيق VPN، أو يفقد الاتصال، أو في اللحظات بين انقطاع الاتصال وإعادة الاتصال، يمكن أن يتسرب حركة المرور الخاصة بك إلى مزود خدمة الإنترنت. تحاول مفاتيح القتل المستندة إلى التطبيق منع ذلك، لكنها تعمل على مستوى التطبيق - إذا تعطل التطبيق نفسه، يموت مفتاح القتل معه.

**هذه المجموعة تنفذ مفتاح قتل قائم على جدار الحماية:**```
Normal Operation:
  Device → Privacy Router → VPN Tunnel → Internet ✓

VPN Down (App-based kill switch):
  Device → [App crashed] → ISP sees traffic ✗

VPN Down (This stack):
  Device → Privacy Router → [No route exists] → Traffic blocked ✓

يمكن لحركة المرور من الشبكة المحلية (LAN) أن تذهب **فقط** إلى منطقة VPN. لا توجد قاعدة توجيه من LAN إلى WAN. ليست هذه قاعدة "حظر" يمكن تجاوزها - فالمسار ببساطة غير موجود.

### جدول التوجيه```bash
# When VPN is UP:
default dev awg0           # All traffic → VPN tunnel
1.2.3.4 via 192.168.1.1    # VPN server → WAN (exception)

# When VPN is DOWN:
# No default route exists
# Traffic has nowhere to go = blocked

> **🤖 لست متأكدًا أيهما تختار؟** يمكن لوكيل ذكاء اصطناعي تقييم إعداداتك والتوصية بأفضل خيار. وجّهه إلى [AGENTS.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/AGENTS.md) ودعه يرشدك خلال عملية النشر.

### نظرة عامة على التثبيت

**للخيارين A و B (OpenWrt):**
1. تثبيت OpenWrt على جهازك
2. تثبيت AmneziaWG (أو WireGuard)
3. تكوين واجهات الشبكة
4. إعداد مفتاح إيقاف جدار الحماية
5. نشر AdGuard Home لـ DNS
6. تثبيت جهاز المراقبة للاسترداد التلقائي
7. تحويل شبكتك

**تعليمات مفصلة:** [docs/DEPLOYMENT.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/DEPLOYMENT.md)

**للخيار C (Docker):** راجع [docker/README.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docker/README.md) لإعداد خاص بالحاويات.

---

## التوثيق

| المستند | الوصف |
|----------|-------------|
| [ARCHITECTURE.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/ARCHITECTURE.md) | تصميم النظام، المكونات، نموذج الأمان |
| [HOW-IT-WORKS.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/HOW-IT-WORKS.md) | غوص تقني عميق في كل مكون |
| [DEPLOYMENT.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/DEPLOYMENT.md) | دليل التثبيت خطوة بخطوة |
| [docker/README.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docker/README.md) | نشر Docker (للمستخدمين المتقدمين) |
| [CONFIGURATION.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/CONFIGURATION.md) | مرجع التكوين الكامل |
| [OPTIONAL_ADDONS.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/OPTIONAL_ADDONS.md) | AdGuard Home و BanIP وإضافات أمان أخرى |
| [TROUBLESHOOTING.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/TROUBLESHOOTING.md) | المشكلات الشائعة والحلول |

---

## مخطط الشبكة```
                                    INTERNET
                                        │
                            ┌───────────┴───────────┐
                            │     VPN Provider      │
                            │   (Mullvad/IVPN/etc)  │
                            └───────────┬───────────┘
                                        │
                              Encrypted WireGuard
                                     Tunnel
                                        │
┌───────────────────────────────────────┼───────────────────────────────────────┐
│ YOUR HOME                             │                                       │
│                                       │                                       │
│    ┌──────────┐              ┌────────┴────────┐              ┌──────────┐   │
│    │   ISP    │    WAN       │                 │    LAN       │  WiFi    │   │
│    │  MODEM   │─────────────▶│ PRIVACY ROUTER  │─────────────▶│  ROUTER  │   │
│    │          │  (Untrusted) │                 │  (Protected) │          │   │
│    └──────────┘              │  ┌───────────┐  │              └────┬─────┘   │
│                              │  │ AdGuard   │  │                   │         │
│                              │  │ DNS + Ads │  │                   │         │
│                              │  └───────────┘  │              ┌────┴─────┐   │
│                              │  ┌───────────┐  │              │ DEVICES  │   │
│                              │  │ Kill      │  │              │          │   │
│                              │  │ Switch    │  │              │ Phone    │   │
│                              │  └───────────┘  │              │ Laptop   │   │
│                              │  ┌───────────┐  │              │ Smart TV │   │
│                              │  │ Watchdog  │  │              │ Console  │   │
│                              │  │ Recovery  │  │              │ IoT      │   │
│                              │  └───────────┘  │              └──────────┘   │
│                              └─────────────────┘                             │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Traffic Flow:
  Device → WiFi Router → Privacy Router → VPN Tunnel → VPN Server → Internet
                              │
                    DNS: AdGuard (DoH) ─────────────▶ VPN Provider DNS

Kill Switch:
  If VPN down → No route to internet → All traffic blocked (not leaked)

> **تركز هذه الحزمة على WireGuard/AmneziaWG.** بالنسبة لبروتوكولات VLESS أو XRay أو غيرها من البروتوكولات المتقدمة، يجب على المستخدمين البحث عن حلول مخصصة أو التفكير في تشغيل [Amnezia VPN](https://amnezia.org) الذي يدعم بروتوكولات متعددة بما في ذلك XRay.

---

## توصيات الأجهزة

> **الحد الأدنى من المتطلبات:** 1 جيجابايت RAM، واجهات شبكة مزدوجة (مدمجة + USB)، دعم OpenWrt. الموصى به: 2 جيجابايت+ RAM لتصفية DNS باستخدام AdGuard Home.

### ميزانية محدودة (~50-80 دولارًا)
- Raspberry Pi 4 (2 جيجابايت+) مع محول Ethernet USB
- أجهزة توجيه السفر GL.iNet (بعضها يعمل بنظام OpenWrt)

### موصى به (~100-150 دولارًا)
- Raspberry Pi 5 مع Ethernet USB 3.0
- Zimaboard أو ما يشابهه من أجهزة SBC x86

### أداء عالٍ (~150-300 دولارًا)
- كمبيوتر صغير مع بطاقات شبكة مزدوجة (أنظمة Intel N150)
- Protectli Vault أو ما يشابهه

### معمل منزلي / مؤسسة
- جهاز افتراضي على مشرف افتراضي موجود (Proxmox, ESXi, Hyper-V)
- جهاز جدار ناري مخصص x86

---

## اعتبارات أمنية

### ما يحمي منه هذا
- مراقبة وتسجيل حركة المرور من مزود خدمة الإنترنت
- تتبع الإعلانات على مستوى الشبكة
- اختطاف ومراقبة DNS
- التحديد الجغرافي استنادًا إلى IP
- ربط حركة المرور (عند دمجه مع أمن عمليات جيد)
- حظر VPN عبر DPI (مع AmneziaWG)

### ما لا يحمي منه هذا
- بصمة المتصفح
- تتبع الحسابات المسجل دخولها (Google, Facebook, إلخ)
- البرامج الضارة على أجهزتك
- الوصول المادي إلى شبكتك
- اختراق مزود VPN

### توصيات أمن العمليات
- استخدم متصفحات تركز على الخصوصية (Firefox, Brave)
- استخدم محركات بحث تحترم الخصوصية
- سجل الخروج من خدمات التتبع عند عدم الحاجة
- فكر في هويات منفصلة
- حافظ على تحديث الأجهزة

---

## الإعداد بمساعدة الذكاء الاصطناعي

للنشر المعقد أو استكشاف الأخطاء وإصلاحها، امنح وكيل ترميز ذكي إمكانية الوصول إلى هذا **المستودع بأكمله** بالإضافة إلى وصول SSH إلى جهاز التوجيه الخاص بك (إذا كنت لا تعرف كيف، اطلب من الوكيل توجيهك).

**موصى به:** تم تطوير هذه الحزمة واختبارها ونشرها باستخدام **Claude Opus 4.6** عبر [Claude Code](https://claude.com/claude-code). للحصول على أفضل النتائج، استخدم نموذجًا متقدمًا قادرًا على تنفيذ أوامر shell وفهم تكوين الشبكة:

- **Claude Opus 4.6 / Sonnet 4.6** (Anthropic) - مستخدم لهذا التطبيق
- **GPT-5.4** (OpenAI)
- **Gemini 3.1** (Google)

**ما يمكن للوكيل القيام به:**
- **تدقيق الشبكة** - فحص الإعداد الحالي وتحديد المتطلبات
- **تكوين موجّه** - توليد تكوينات بعناوين IP ومفاتيح وتفضيلاتك الخاصة
- **استكشاف الأخطاء آليًا** - تشخيص مشكلات التوجيه وجدار الحماية وDNS في الوقت الفعلي
- **نشر نصّي** - تنفيذ خطوات التثبيت بموافقتك

**بدء سريع:**
1. استنساخ هذا المستودع أو منح الوكيل حق الوصول إلى GitHub
2. وجّه الوكيل إلى **[AGENTS.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/AGENTS.md)** - يحتوي على الإطار التشغيلي الكامل
3. قدّم بيانات اعتماد SSH للجهاز الهدف
4. دع الوكيل يدقق ويخطط ويوجهك خلال النشر

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

---

## مشاريع ذات صلة

يبني هذا النمط على أعمال ممتازة مفتوحة المصدر:

| المشروع | الوصف |
|---------|-------------|
| [amnezia-vpn/amneziawg-linux-kernel-module](https://github.com/amnezia-vpn/amneziawg-linux-kernel-module) | وحدة نواة AmneziaWG |
| [amnezia-vpn/amneziawg-tools](https://github.com/amnezia-vpn/amneziawg-tools) | أدوات مساحة المستخدم AmneziaWG |
| [Slava-Shchipunov/awg-openwrt](https://github.com/Slava-Shchipunov/awg-openwrt) | حزم AmneziaWG مبنية مسبقًا لـ OpenWrt |
| [wgtunnel/wgtunnel](https://github.com/wgtunnel/wgtunnel) | إدارة نفق WireGuard |

---

## الترخيص

رخصة MIT - انظر [LICENSE](https://github.com/yoloshii/privacy-first-network/blob/HEAD/LICENSE) للتفاصيل.

---

## شكر وتقدير

- [OpenWrt Project](https://openwrt.org/) - الأساس
- [AmneziaWG](https://github.com/amnezia-vpn/amneziawg-tools) - تجاوز DPI
- [AdGuard Home](https://adguard.com/adguard-home.html) - تصفية DNS
- [WireGuard](https://www.wireguard.com/) - بروتوكول VPN حديث

---

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

**س: هل سيؤدي هذا إلى إبطاء اتصالي بالإنترنت؟**
ج: تأثير ضئيل. WireGuard فعال للغاية. معظم المستخدمين يرون انخفاضًا في السرعة أقل من 5%. العامل الرئيسي هو جودة خادم مزود VPN الخاص بك.

**س: هل يمكنني الوصول إلى أجهزة الشبكة المحلية؟**
ج: نعم. تبقى حركة مرور الشبكة المحلية محلية ولا تمر عبر VPN.

**س: ماذا لو فشل جهاز توجيه الخصوصية؟**
ج: تفقد شبكتك الإنترنت حتى يتم إصلاحها أو تجاوزها. هذه ميزة وليس خطأ - فهي تضمن عدم تسرب أي حركة مرور غير محمية.

**س: هل يمكنني استبعاد أجهزة معينة من VPN؟**
ج: نعم، مع تكوين إضافي. يمكنك إنشاء قواعد جدار ناري لتوجيه عناوين IP محددة مباشرة إلى WAN. انظر [CONFIGURATION.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/CONFIGURATION.md).

**س: هل يعمل هذا مع IPv6؟**
ج: تم تعطيل IPv6 لمنع التسريبات. معظم مزودي VPN لا يدعمون IPv6 بشكل صحيح بعد.

**س: هل يمكن لمزود خدمة الإنترنت رؤية أنني أستخدم VPN؟**
ج: مع WireGuard القياسي، يمكنهم رؤية حركة مرور تشبه VPN. مع إخفاء AmneziaWG، تظهر حركة المرور كضوضاء عشوائية.

**س: كيف يساعد هذا في مخاوف الخصوصية المتعلقة بالتحقق من العمر؟**
ج: يقوم VPN بتوجيه حركة المرور الخاصة بك عبر نفق مشفر، مما يمنع مزود خدمة الإنترنت من تسجيل المواقع التي تزورها. هذه **أداة خصوصية** - تمنع خدمات التحقق من العمر التابعة لجهات خارجية من ربط نشاط التصفح الخاص بك عبر المواقع أو بناء ملفات تعريف سلوكية. يبقى التحقق الفعلي من عمرك مع المنصات بينك وبين تلك المنصة، ولا تتم مشاركته مع مزودي خدمة الإنترنت أو وسطاء البيانات. لأسئلة الامتثال المحددة، استشر اللوائح المحلية.

**س: هل سيعمل هذا بعد دخول حظر وسائل التواصل الاجتماعي في أستراليا حيز التنفيذ؟**
ج: تحمي هذه الحزمة حركة مرور شبكتك من تسجيل مزود خدمة الإنترنت وتوفر الخصوصية لجميع الأجهزة. يؤثر التشريع الأسترالي في ديسمبر 2025 بشكل أساسي على التحقق من جانب المنصة. يضمن VPN أن مزود خدمة الإنترنت الخاص بك لا يمكنه رؤية المواقع التي تزورها، بغض النظر عن متطلبات مستوى المنصة.

**س: هل هذا قانوني؟**
ج: استخدام VPN قانوني في معظم الدول الغربية بما في ذلك المملكة المتحدة وأستراليا والولايات المتحدة والاتحاد الأوروبي. هذه الحزمة هي أداة خصوصية مشابهة لـ HTTPS - فهي تشفر حركة المرور الخاصة بك. استخدام VPN للوصول إلى المحتوى المتاح في منطقتك قانوني بشكل عام. تحقق دائمًا من قوانينك المحلية.

---

*احم شبكتك بالكامل. اضبطها وانسه.*