
متتبع الأجهزة السلبي (Android) TrackEm Mobile هو ماسح طلبات استقصاء سلبي وزمن حقيقي بتقنيتي Wi-Fi و Bluetooth LE، مصمم لـ OSINT وعمليات الفريق الأحمر وأبحاث الشبكات اللاسلكية. يستمع للأجهزة العميلة (الهواتف، الحواسيب المحمولة، إنترنت الأشياء) التي تبث بنشاط أسماء شبكات Wi-Fi.
مراقب سلبي لـ Wi-Fi + Bluetooth LE على أندرويد. يستمع TrackEm إلى ما تبثّه الأجهزة القريبة بالفعل — طلبات استكشاف Wi-Fi (probe requests)، وإعلانات BLE، ونقاط الوصول المرئية — ويحوّلها إلى جرد حيّ وقابل للتصفية للراديوهات المحيطة بك. صُمّم لأبحاث الشبكات اللاسلكية، ومسوحات مواقع RF، واستطلاع الفرق الحمراء، وأعمال OSINT حيث تريد المراقبة بدلاً من التدخل.
لا يبثّ TrackEm أبداً إطارات Wi-Fi أو Bluetooth. إنه مراقب: لا طلبات استكشاف، ولا إطارات اقتران (association)، ولا إلغاء مصادقة (deauthentication)، ولا حقن إطارات. راجع ما لا يفعله TrackEm.
الحزمة: com.veteranop.trackem · الترخيص: MIT · أندرويد 7.0+ (API 24)
يشغّل TrackEm ثلاثة أنماط مسح، كلٌّ منها من الشاشة الرئيسية:
| النمط | ما يراقبه | الاستخدام النموذجي |
|---|---|---|
| الأجهزة المحمولة | طلبات استكشاف Wi-Fi بالإضافة إلى إعلانات BLE من الهواتف والحواسيب المحمولة والساعات وأجهزة IoT | كشف الحضور، وإحصاء الأجهزة، وأبحاث طلبات الاستكشاف |
| Bluetooth LE | معلنو BLE فقط (دون الحاجة إلى راديو Wi-Fi) | مسوحات المنارات (beacons) / المتتبعات / أجهزة BLE |
| نقاط وصول Wi-Fi | نقاط الوصول المرئية (SSID، BSSID، RSSI)، بالإضافة إلى العملاء المرتبطين حيث تُبلّغ المنصة عنهم | مسوحات المواقع، والبحث عن نقاط وصول دخيلة (rogue AP) |
api.maclookup.app)
وبحث WiGLE الاختياري — وكلاهما يرسل MAC/BSSID ولا شيء غير ذلك.التحليلات، بصراحة: إذا وفّرت ملف
app/google-services.jsonالخاص بك، يسجّل Firebase Analytics ثلاثة أحداث على مستوى التطبيق —app_opened، وstart_scan(مع نمط المسح) وdevice_renamed(بقيمة منطقية فقط، وليس MAC أبداً). لا يُرسَل أي معرّف لجهاز مراقَب. وبدون ذلك الملف يُبنى التطبيق ويعمل مع تعطيل التحليلات: فالاستدعاءات قابلة للقيمة الفارغة (nullable)، لذا لا يمكن لغياب إعداد Firebase أن يتسبب في تعطّل بدء التشغيل.
هذا مهم للترخيص والتوقعات معاً، لذا يُذكر بوضوح:
WifiManager.startScan())، مما يمنح جهازاً هادئاً
فرصة أخرى للظهور في نافذة المسح التالية. هذا الزر مُسمّى
FORCE WI-FI RESCAN (10x) وهذا كل ما يفعله — عشر عمليات إعادة مسح.api.maclookup.app.
لا يُرسَل أي شيء عن الأجهزة التي يراقبها إلى أي مكان.إذا كنت بحاجة إلى اختبار لاسلكي نشط، فاستخدم عتادًا وأدوات مخصصة (واحصل على تفويض كتابي للشبكة أولًا).
| الإذن | السبب |
|---|---|
ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION | يتطلب Android إذن الموقع قبل أن يمنح التطبيق نتائج فحص Wi-Fi أو نتائج فحص BLE. هذا متطلب من نظام التشغيل، وليس تفضيلًا من TrackEm. |
ACCESS_BACKGROUND_LOCATION | اختياري — فقط إذا كنت تريد استمرار عمليات الفحص أثناء عمل التطبيق في الخلفية. |
BLUETOOTH_SCAN (neverForLocation) / BLUETOOTH_CONNECT | فحص BLE والاتصال بجهاز طرفي. |
ACCESS_WIFI_STATE / CHANGE_WIFI_STATE | قراءة نتائج الفحص؛ تشغيل إعادة فحص Wi-Fi. |
INTERNET / ACCESS_NETWORK_STATE | البحث عن الشركة المصنّعة (maclookup.app) والبحث الاختياري عبر WiGLE. |
يُستخدم الموقع لتحليل نتائج الفحص، و(إذا استخدمت وضع الاقتفاء/الخريطة) لوضع العينات على خريطة. لا يخزّن TrackEm سجلًا للموقع في أي مكان خارج الجهاز.
المتطلبات: Android Studio (أو SDK + JDK 17 فقط)، ومنصة Android SDK 34.
git clone https://github.com/veteranop/trackem.git
cd trackem
مفتاح API الخاص بـ maclookup.app غير موجود في هذا المستودع (كان مضمّنًا بشكل ثابت في commit سابق
وقد تم تدويره وحذفه من السجل منذ ذلك الحين). قدّم مفتاحك الخاص — إما في
local.properties (متجاهَل بواسطة git):
sdk.dir=/path/to/Android/Sdk
MACLOOKUP_API_KEY=your-key-from-maclookup.app
…أو في البيئة لـ CI:
export MACLOOKUP_API_KEY=...
تُحقن القيمة باسم BuildConfig.MACLOOKUP_API_KEY. ومع عدم تعيين أي مفتاح، يظل التطبيق
يُبنى ويعمل — إذ يتم ببساطة تخطي البحث عن الشركة المصنّعة.
ملف app/google-services.json مُستبعَد من git، لأنه يحتوي على مفتاح Firebase API. إذا
أردت تفعيل Firebase Analytics، فأنشئ إدخال تطبيق Android خاصًا بك في وحدة تحكم Firebase
للحزمة com.veteranop.trackem وضع ملف google-services.json الناتج في app/.
وبدون هذا الملف، لا يتم تطبيق إضافة Google Services Gradle ويُبنى التطبيق
بدون Firebase.
./gradlew :app:assembleDebug # debug APK
./gradlew :app:test # JVM unit tests
ثبّت نسخة التصحيح باستخدام adb install -r app/build/outputs/apk/debug/app-debug.apk.
هل تثبّت نسخة أقدم؟ أصبح معرّف التطبيق الآن
com.veteranop.trackem(سابقًاcom.example.trackemmobile)، لذا يُثبَّت إلى جانب نسخة قديمة بدلًا من استبدالها. أزل تثبيت النسخة القديمة لتجنّب الالتباس.
تسبّب اعتمادان في مشكلات في تاريخ هذا المستودع؛ ويُتعامل معهما بالطريقة نفسها الآن:
| السر | مكانه الآن |
|---|---|
MACLOOKUP_API_KEY | local.properties / سر CI → BuildConfig.MACLOOKUP_API_KEY |
| مفتاح Firebase API | app/google-services.json، مُستبعَد عبر gitignore، يُولَّد لكل مطوّر/CI |
يحجب .gitignore الملفات google-services.json و.kotlin/ و.gradle/ و*.apk/*.aab،
ومخازن المفاتيح. إذا نسخت هذا المستودع (fork)، بدّل كلا المفتاحين لاستخدامك الخاص — فقد كانت
القيم القديمة علنية ويجب اعتبارها محروقة.
لاحظ أن حقل BuildConfig ليس خزنة: فهو يُجمَّع داخل APK ويمكن
استخراجه. بالنسبة لمفتاح بحث MAC محدود المعدّل، فهذه مقايضة مقبولة؛ لا تضع
أي شيء عالي القيمة هناك.
app/src/main/java/com/veteranop/trackem/
├── MainActivity.kt scan modes, device lists, API-key menu
├── DeviceScanner.kt Wi-Fi + BLE scanning, fingerprinting, vendor lookup
├── DetailActivity.kt single-device view, rescan, BLE connect
├── MapActivity.kt Wi-Fi AP map (WiGLE)
├── DeviceFingerprint.kt device model + RHID grouping
├── ui/hunting/ hunting mode (Compose + Maps)
└── utils/, data/ location helper, RSSI samples