Sparrow-WiFi

Sparrow-WiFi هي أداة للوعي الطيفي بالواي فاي والبلوتوث على نطاقي 2.4 GHz و5 GHz لأنظمة Linux. وهي تدمج مسح الواي فاي، واكتشاف Bluetooth Low Energy وClassic، وتحليل طيف الراديو المعرّف برمجياً (HackRF، Ubertooth)، وتتبع GPS، واكتشاف طائرات FAA RemoteID بدون طيار، والعمليات عن بُعد المثبتة على الطائرات بدون طيار/المركبات الجوالة، وفهرسة ECS 8.17 في Elasticsearch أو OpenSearch ضمن منصة واحدة. مكتوبة بالكامل بلغة Python 3.

يتضمن المشروع أربعة مكونات تعمل بشكل مستقل أو معاً:

المكوّن	الواجهة	الغرض
Sparrow-WiFi	واجهة رسومية لسطح المكتب PyQt5	مسح الواي فاي/البلوتوث، تحليل الطيف، تتبع المصادر، wardriving
Sparrow Agent	خادم HTTP بلا واجهة	المسح عن بُعد، نشر الطائرات بدون طيار/المركبات الجوالة، التكامل مع الأطراف الثالثة
Sparrow DroneID	قائم على الويب (المتصفح)	اكتشاف طائرات FAA RemoteID بدون طيار عبر الواي فاي وBluetooth LE
Sparrow Elastic Bridge	خدمة CLI بلا واجهة	فهرسة ECS 8.17 لملاحظات الواي فاي/البلوتوث في Elasticsearch / OpenSearch

يكشف Sparrow Agent وSparrow DroneID عن واجهات برمجة تطبيقات REST بصيغة JSON تتيح للتطبيقات الأخرى الاستعلام عن نتائج المسح، وبدء عمليات المسح، واسترداد اكتشافات الطائرات بدون طيار، ودمج الوعي اللاسلكي/بالطائرات بدون طيار في سير عملها الخاص. يستهلك Elastic Bridge واجهة REST الخاصة بالوكيل ويُرسل مستندات ECS 8.17 مع لوحات معلومات Kibana المرفقة.

---

الجديد (أبريل 2026)

يغطي هذا الإصدار ثلاثة تحسينات مهمة مقارنة بالإصدار السابق:

• Sparrow Agent: دمج عمليات مسح الواي فاي أحادية التنفيذ. عندما تضرب عدة عملاء HTTP (تطبيق DroneID، وجسر Elasticsearch، والواجهة الرسومية) المسار /wireless/networks/<iface> في آنٍ واحد، كان الوكيل سابقاً يطلق N من استدعاءات iw scan الزائدة التي تتسلسل على قفل الواجهة الواحدة، مما يضاعف زمن استجابة المسح بعدد العملاء. أصبح الطلب الأول الآن هو "القائد" الذي يقوم فعلياً بالمسح؛ بينما تنتظر الطلبات المتزامنة على threading.Event وتشارك نتيجة القائد. يتضمن أيضاً إصلاح TOCTOU الخاص بإنشاء الأقفال، وأمان الاستثناءات على أقفال الواجهة الواحدة.
• Sparrow DroneID — تطبيق جديد قائم على الويب لاكتشاف FAA RemoteID عبر الواي فاي (ASTM F3411 NAN، وIEs الخاصة بمورّدي المنارات، وبروتوكول DroneID الخاص بـ DJI) وBluetooth LE (إعلانات BT4/BT5 Legacy). يتضمن تراكبات المناطق الجغرافية، وتنبيهات متعددة الحالات مع تكامل Slack، وتصدير KML، ومخرجات Cursor-on-Target، وفهرسة اختيارية ECS 8.17 إلى Elasticsearch / OpenSearch (مع مساحة أسماء مخصصة droneid.*)، وواجهة ويب متجاوبة متعددة الأجهزة. راجع قسم Sparrow DroneID أدناه.
• جسر Elasticsearch / OpenSearch المُحدَّث — أُعيدت كتابة جسر sparrow-elastic.py لإنتاج مستندات ECS 8.17 (كان ECS 1.5)، ويدعم الآن كلاً من Elasticsearch 8.x وOpenSearch 2.x، ويُنشئ قوالب فهارس قابلة للتركيب مع سياسات دورة حياة ILM/ISM وأسماء مستعارة للكتابة بالتناوب تلقائياً، ويُجري إثراء لمورّدي OUI وتصنيفاً للأجهزة قائماً على القواعد (مع بصمة Fingerbank الاختيارية)، ويُرسل أربع لوحات معلومات Kibana مرفقة بالإضافة إلى ست تصورات محفوظة من الإصدار القديم. الجسر القديم ECS 1.5 محفوظ في legacy/sparrow-elastic.py. راجع تكامل Elasticsearch / OpenSearch.

---

Sparrow-WiFi (واجهة سطح المكتب الرسومية)

يوفّر تطبيق Sparrow الأصلي بديلاً شاملاً قائماً على واجهة رسومية لأدوات مثل inSSIDer وLinSSID، بقدرات تتجاوز بكثير المسح الأساسي:

• مسح WiFi — اكتشاف SSID في نطاقي 2.4 GHz و5 GHz، وقوة الإشارة، واستخدام القنوات
• تتبع المصادر — وضع Hunt بمعدلات أخذ عينات عالية ونوافذ قياس عن بُعد لتحديد مواقع مصادر WiFi وBluetooth
• تحليل الطيف — تراكبات طيفية فورية لنطاقي 2.4/5 GHz عبر Ubertooth One أو HackRF One
• Bluetooth — مسح إعلانات BLE، واكتشاف/بث iBeacon، ووضع Ubertooth promiscuous لكلاسيكي + LE
• الوكيل البعيد — وكيل بلا واجهة (sparrowwifiagent.py) للمسح الموزع، والعمليات المثبتة على الطائرات بدون طيار/المركبات الجوالة، ونشر Raspberry Pi
• تكامل GPS — gpsd، أو إحداثيات ثابتة، أو MAVLink (GPS الطائرة بدون طيار)
• الرسم الخرائطي — تصور نتائج المسح مع مسارات GPS على Google Maps / OpenStreetMap
• الاستيراد/التصدير — CSV وJSON ومخرجات iw scan الخام
• Elasticsearch / OpenSearch — فهرسة متوافقة مع ECS 8.17 لبيانات مسح WiFi وBluetooth مع إدارة دورة الحياة ILM/ISM، وتصنيف الأجهزة، وبصمة Fingerbank الاختيارية، ولوحات Kibana المرفقة
• إضافة Falcon — تكامل Aircrack-ng لاختبار الاختراق (وضع المراقبة، واكتشاف SSID المخفي، وdeauth، والتقاط WEP/WPA)

لقطات الشاشة

---

Sparrow DroneID (تطبيق ويب)

نظام مستقل قائم على الويب لاكتشاف الطائرات بدون طيار وتتبعها، ويفك تشفير بث التعريف عن بُعد (RemoteID) الإلزامي من FAA. يعمل كخادم HTTP بلغة Python مع واجهة مستخدم قائمة على المتصفح يمكن الوصول إليها من أي جهاز على الشبكة.

القدرات

• التقاط WiFi — يفك تشفير إطارات ASTM F3411 NAN action، وbeacon vendor IEs، وDJI DroneID الخاص
• التقاط Bluetooth LE — يفك تشفير إعلانات ASTM F3411 BT4/BT5 Legacy (UUID 0xFFFA)
• خريطة فورية — خريطة قائمة على Leaflet مع أيقونات الطائرات الرباعية، ومؤشرات الاتجاه، وعلامات موقع المشغّل، وخطوط تربط الطائرة بالمشغّل
• تسميات سريعة — يُعرض معرّف المشغّل والارتفاع AGL تحت كل أيقونة طائرة على الخريطة
• نوافذ تفاصيل منبثقة — انقر على طائرة بدون طيار لعرض الرقم التسلسلي، ومعرّف التسجيل، ومعرّف المشغّل، والنوع، والسرعة، والاتجاه، والارتفاع، والاتجاه/المدى من المستقبل، وحالة BVLOS
• نظام التنبيهات — تنبيهات قابلة للتهيئة للطائرات الجديدة، وانتهاكات الارتفاع، وانتهاكات السرعة، وفقدان الإشارة، مع نغمات صوتية، وإشعارات مرئية منبثقة، وإشعارات Slack webhook، وعمليات POST اختيارية بصيغة JSON مع bearer-token إلى واجهة API عامة خارجية لاستقبال التنبيهات (انظر التنبيهات القائمة على API أدناه)
• الإقرار بالتنبيهات — سير عمل ثلاثي الحالات (نشط/مُقر به/محلول) مع هوية المشغّل، مشترك بين جميع الأجهزة المتصلة
• مناطق المطارات الجغرافية — تنزيل وعرض تلقائي للمطارات القريبة (بيانات OurAirports) ومضلعات المجال الجوي المحظور/المقيد من FAA، مخزّنة محليًا للعمل دون اتصال
• GPS — تكامل gpsd أو إحداثيات ثابتة قابلة للتهيئة
• السجل وإعادة التشغيل — سجل اكتشافات مدعوم بـ SQLite مع إعادة تشغيل زمني وتصدير KML
• TAK / Cursor-on-Target — UDP multicast/broadcast/unicast، أو TCP أو TLS إلى TAK Server مع تسجيل الشهادات واستيراد حزمة البيانات؛ تُلوَّن الطائرات بدون طيار حسب التصنيف، ونقاط المشغّل وروابطه، ونقطة مستشعر المستقبل
• متعدد الأجهزة — تعمل واجهة الويب على سطح المكتب والجهاز اللوحي والهاتف في آنٍ واحد
• متري / إمبراطوري — دعم كامل لتفضيلات الوحدات في جميع أنحاء الواجهة والتنبيهات

TAK / Cursor-on-Target

يرسل تبويب TAK في الإعدادات كل طائرة بدون طيار متتبَّعة، ونقطة مشغّلها (أو نقطة الإقلاع)، وخط رابط متقطع، وهذا المستقبل إلى ATAK أو WinTAK أو iTAK أو TAK Server بصيغة Cursor-on-Target. اختر UDP multicast للعملاء على الشبكة نفسها، أو TCP/TLS إلى TAK Server؛ واستورد حزمة بيانات TAK (.zip) لملء الخادم ومخزن الثقة والتسجيل في خطوة واحدة. تُزال الطائرات بدون طيار من خريطة TAK عند اختفائها. انظر sparrow-droneid/TAK_INTEGRATION.md لمعرفة وسائل النقل والشهادات والرموز والتوقيت واستكشاف الأخطاء وإصلاحها.

يعمل واجهة الويب على http://localhost:8097 بمجرد التشغيل. راجع Installation أدناه للإعداد، ومرجع API للوصول البرمجي.

التنبيهات القائمة على API