AirmonGUI

واجهة ويب محلية لحزمة أدوات aircrack-ng اللاسلكية.

لقطات الشاشة · بدء سريع · المزايا · خارطة الطريق · المساهمة

[!WARNING] استخدم هذه الأداة فقط على الشبكات التي تملكها أو لديك إذن كتابي لاختبارها. إن فحص الشبكات أو إلغاء مصادقتها أو التقاط حركة المرور من شبكات لا تتحكم فيها أمر غير قانوني في معظم الأماكن. انظر الاستخدام القانوني والمسؤول.

ما هي الأداة

تضع AirmonGUI أدوات airmon-ng وairodump-ng وaireplay-ng وaircrack-ng خلف تطبيق ويب واحد يعمل على جهازك. يمكنك تفعيل وضع المراقبة، وفحص الشبكات، والتقاط مصافحة WPA، وكسرها عبر النقر في نماذج مرقّمة بدلاً من تذكّر الخيارات (flags).

لا تعيد الأداة تنفيذ أيٍّ من هذه الأدوات. تستدعي الواجهة الخلفية الملفات التنفيذية الحقيقية وتُحلّل مخرجاتها، فما تراه هو ما فعلته الحزمة فعلاً. ترتبط الواجهة بـ 127.0.0.1 ولا تصل API إلى خارج جهازك أبدًا.

لماذا بنيتُها

حزمة aircrack-ng ممتازة، لكن سير العمل موزّع عبر أربعة أوامر منفصلة والكثير من الخيارات التي عليك حفظها في ذهنك: ضع البطاقة في وضع المراقبة، وتنقّل بين القنوات للعثور على هدف، وثبّت القفل على BSSID، وأطلق إلغاء المصادقة على القناة الصحيحة، وانتظر مصافحة الأطراف الأربعة، ثم مرّر ملف الالتقاط عبر قائمة كلمات. أخطئ القناة فلن يصل إلغاء المصادقة إلى أي مكان. انسَ --bssid وستمتلئ بيانات الالتقاط بالضوضاء.

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

المزايا

كيف تعمل

تتحرك الجلسة من أعلى الشريط الجانبي إلى أسفله. إليك كل شاشة.

الشبكات وعناوين BSSID والعملاء في لقطات الشاشة أدناه بيانات تجريبية اصطناعية، وليست التقاطًا حقيقيًا.

1. ضع المحول في وضع المراقبة

اختر واجهة، وافحص برنامج التشغيل والشريحة وPHY، وفعّل وضع المراقبة. حرّر تلك الواجهة فقط عند الانتهاء.

2. امسح الهواء

ابدأ مهمة airodump-ng وشاهد نقاط الوصول والعملاء تملأ الجدول كلما اُكتشفت. صفِّ الجدول، ثم أرسل أي شبكة مباشرةً إلى سير عمل إلغاء المصادقة أو المصافحة.

3. اختر هدفًا

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

4. التقط المصافحة

تثبّت هذه الشاشة airodump-ng على BSSID الهدف وقناته، وتشغّل محرك إلغاء المصادقة التلقائي لطرد العملاء فيُعيدون الاتصال، وتتحول إلى اللون الأخضر لحظة التقاط مصافحة رباعية الأطراف.

5. اكسرها

وجّه aircrack-ng إلى ملف الالتقاط مع قائمة كلمات. يتدفق السجل أثناء التشغيل، وإذا كانت عبارة المرور موجودة في قائمتك فستظهر في الأعلى.

مزيد من الشاشات: إلغاء المصادقة، ملفات الالتقاط، السجلات

إلغاء مصادقة مستقل مع تثبيت القناة وسجل التشغيل ومخرجات الأحداث المحللة:

إدارة ملفات الالتقاط:

سجل أوامر الجلسة:

بدء سريع

تحتاج إلى Linux وصلاحيات الجذر ومحول لاسلكي يدعم وضع المراقبة وحزمة aircrack-ng ضمن $PATH. انظر المتطلبات للقائمة الكاملة.

# 0. Install the suite (Debian, Ubuntu, Kali)
sudo apt update && sudo apt install aircrack-ng wireless-tools

# 1. Clone
git clone https://github.com/ELHart05/AirmonGUI.git
cd AirmonGUI

# 2. Backend (terminal 1)
cd backend
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
sudo -E .venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000

# 3. Frontend (terminal 2)
cd frontend
npm install
npm run dev

افتح http://localhost:5173. الواجهة تتواصل مع 127.0.0.1:8000 فقط.

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

======================================================================
AirmonGUI API token (generated for this run):

    Xy3k...long-random-string...

Paste it into the AirmonGUI web UI when prompted.
======================================================================

الصق ذلك الرمز في شاشة فتح القفل. وللإبقاء على رمز ثابت عبر عمليات إعادة التشغيل، عيّن AIRMON_GUI_AUTH_TOKEN في backend/.env (تحمّل الواجهة الخلفية هذا الملف عند الإقلاع). يتطلب كل مسار من مسارات API باستثناء فحص الصحة هذا الرمز، وهذا ما يمنع أي عملية محلية شاردة أو صفحة ويب تصادفك زيارتها من تشغيل أدوات اللاسلكي خلف ظهرك. يجب عليك تعيين الرمز صراحةً قبل ربط الواجهة الخلفية بأي عنوان غير 127.0.0.1 — وإلا رفضت الإقلاع.

إذا كانت رسالة الطلب مجرد عائق على جهاز أحادي المستخدم، فعيّن AIRMON_GUI_AUTH_ENABLED=false لتعطيل المصادقة كليًا؛ وعندها تتخطى الواجهة شاشة فتح القفل. ومع تعطيل المصادقة ترفض الواجهة الخلفية الارتباط بأي مكان سوى loopback — وجّه API_HOST إلى أي شيء غير 127.0.0.1 ولن تقلع.

صلاحيات الجذر ضرورية لأن airmon-ng وairodump-ng وaireplay-ng تستخدم مقابس خام (raw sockets). استدعِ .venv/bin/uvicorn مباشرةً بدلاً من uvicorn العادي، لأن sudo يعيد تعيين PATH وقد لا يجد البيئة الافتراضية؛ وتحافظ علامة -E على أي متغيرات AIRMON_GUI_* عيّنتها. وإذا فضّلت عدم تشغيل الخادم بصلاحيات الجذر، فأعدّ sudo بدون كلمة مرور لتلك الملفات التنفيذية المحددة وعدّل backend/app/utils.py.

cd frontend
npm run build   # writes static files to frontend/dist/

الرصة التقنية

البنية

AirmonGUI
├── backend/    FastAPI REST API and WebSocket, one route module per tool
│               app/routes/ (interfaces, airodump, aireplay, aircrack, handshake, captures)
│               app/models.py (validated Pydantic I/O), app/state.py (in-process job registry)
│               app/utils.py (subprocess and sudo logic), app/config.py (env config)
│
├── frontend/   Vue 3 single-page app, the control console
│               views/ (Overview, Monitor, Scan, Signal, Deauth, Handshake, Crack, Captures, Reports, Terminal, Logs)
│               composables/ (reactive job and state logic), api/ (fetch wrappers)
│
└── website/    Standalone React landing site (optional)

توفّر الواجهة الخلفية واجهة REST API على http://127.0.0.1:8000/api وWebSocket طرفية على /ws/terminal (محكومة برمز API؛ عطّلها عبر AIRMON_GUI_TERMINAL_ENABLED=0). وفي بيئة التطوير، يعمل خادم Vite التطويري على :5173 كوسيط (proxy) لكليهما نحو الواجهة الخلفية.

المتطلبات

استكشاف الأخطاء وإصلاحها

"تعذّر تثبيت wlan0 على القناة N" أو فحص بدون أي شبكات. في أغلب الحالات، تكون الواجهة لا تزال في وضع managed. وضع المراقبة هو ما يتيح للمحول الالتقاط وتغيير القنوات. فعّله من تبويب المراقبة أولاً (أو airmon-ng start wlan0)، ثم افحص على واجهة المراقبة — غالبًا wlan0mon، وإن كانت بعض برامج التشغيل تُبقي الاسم الأصلي. يرفض الفحص الواجهة في وضع managed مع هذه التلميحة نفسها، ولم يعد الفحص أحادي القناة يتوقف إذا تعذّر التحقق من التثبيت المسبق، لأن airodump-ng يضبط القناة بنفسه.

تظهر الشبكات في أول تشغيل لكن ليس في الثاني. يمكن أن تترك واجهة مراقبة متبقية، أو إعادة NetworkManager السيطرة على المحول بين عمليات التشغيل، الواجهة في حالة عالقة. شغّل airmon-ng check kill (زر Check Kill) قبل الفحص، وأوقف أي فحص قبل بدء فحص آخر على الواجهة نفسها.

خارطة الطريق

المساعدة في أي من هذه البنود مرحّب بها. انظر المساهمة.

• مشغّل بأمر واحد (هدف Makefile أو Docker Compose) للواجهة الخلفية والأمامية
• نقل الملف إلى hashcat للكسر عبر GPU
• التقاط PMKID والهجوم به
• رسوم بيانية للعملاء ونقاط الوصول عبر الزمن
• عرض التقارير، مكتملًا وقابلًا للتصدير
• إصدار معبأ ونص برمجي للتثبيت

لديك فكرة؟ افتح مشكلة. طلبات المزايا والأسئلة مرحّب بها.

المساهمة

طلبات السحب (Pull requests) مرحّب بها، وكلما كانت أصغر وأكثر تركيزًا كان أفضل.

1. اقرأ CONTRIBUTING.md للإعداد والتحقق وقواعد الأمان.
2. انسخ المستودع (Fork) وأنشئ فرعًا (Branch) وأبقِ التغيير مقتصرًا على شيء واحد.
3. تحقق من إقلاع الواجهة الخلفية (uvicorn) والأمامية (npm run dev) بنجاح دون أخطاء.
4. افتح PR يوضح ما الذي تغيّر ولماذا.

لكل مجلد ملف README خاص به مع ملاحظات: backend وfrontend وwebsite.

إذا كان المشروع مفيدًا لك، فإن النجمة تساعد الآخرين على اكتشافه وتخبرني أنه يستحق المواصلة.

سجل النجوم

الاستخدام القانوني والمسؤول

أداة AirmonGUI مخصصة لاختبارات اللاسلكي والأبحاث والتدريس المصرّح بها على الشبكات التي تملكها أو لديك إذن كتابي لتقييمها.

اعتراض حركة المرور وإلغاء مصادقة الشبكات أو الأجهزة التي لا تتحكم فيها أمر غير قانوني في معظم الولايات القضائية. الإعدادات الافتراضية تُبقي واجهة API وخادم التطوير على loopback لسبب وجيه، فلا تعرّضهما على شبكة مشتركة أو عامة. لا يتحمل المؤلفون أي مسؤولية عن سوء الاستخدام. وباستخدامك لهذا البرنامج فإنك تؤكد أن لديك إذنًا لكل شبكة وجهاز تتعامل معه.

استخدمها لفهم الشبكات والدفاع عنها، لا لمهاجمة شبكات ليست ملكك.

الترخيص

MIT، انظر LICENSE. مبني على مشروع aircrack-ng الذي يقوم بالعمل الفعلي.