Bluehood

Bluetooth Neighborhood - अपने क्षेत्र में BLE उपकरणों को ट्रैक करें और ट्रैफ़िक पैटर्न का विश्लेषण करें।

चेतावनी: अल्फा सॉफ़्टवेयर

यह प्रोजेक्ट प्रारंभिक विकास में है और उत्पादन उपयोग के लिए तैयार नहीं है। सुविधाएँ बिना सूचना के बदल सकती हैं, टूट सकती हैं, या हटाई जा सकती हैं। अपने जोखिम पर उपयोग करें। एकत्र किए गए डेटा को प्रयोगात्मक माना जाना चाहिए।

स्क्रीनशॉट

Dashboard फ़िल्टरिंग, खोज और रीयल-टाइम आँकड़ों के साथ डिवाइस सूची दिखाने वाला मुख्य डैशबोर्ड

Settings टैब्ड कॉन्फ़िगरेशन पृष्ठ — Alerts, Operations, Groups, और Security

About प्रोजेक्ट जानकारी और क्षमताओं के अवलोकन के साथ Intel पृष्ठ

क्यों?

यह प्रोजेक्ट WhisperPair vulnerability (CVE-2025-36911) से प्रेरित था, जिसने Bluetooth उपकरणों में गोपनीयता जोखिमों को उजागर किया।

हज़ारों Bluetooth उपकरण हर समय हमारे चारों ओर होते हैं: फ़ोन, कार, टीवी, हेडफ़ोन, श्रवण यंत्र, डिलीवरी वाहन, और बहुत कुछ। Bluehood दर्शाता है कि इन उपकरणों का निष्क्रिय रूप से पता लगाना और उनकी उपस्थिति में पैटर्न देखना कितना आसान है।

पर्याप्त डेटा के साथ, आप संभावित रूप से:

समझ सकते हैं कि कोई व्यक्ति आमतौर पर अपने कुत्ते को कब टहलाने ले जाता है
पता लगा सकते हैं कि कोई आगंतुक घर पर कब पहुँचता है
उपकरण की उपस्थिति के आधार पर दैनिक दिनचर्या में पैटर्न की पहचान कर सकते हैं

यह मेटाडेटा उपकरणों के साथ किसी भी सक्रिय इंटरैक्शन के बिना आश्चर्यजनक रूप से व्यक्तिगत जानकारी प्रकट कर सकता है।

Bluehood Bluetooth गोपनीयता के बारे में जागरूकता बढ़ाने के लिए एक शैक्षिक उपकरण है। यह एक वीकेंड प्रोजेक्ट है, लेकिन इसके निहितार्थों पर विचार करना उचित है।

क्या?

Bluehood एक Bluetooth स्कैनर है जो:

लगातार स्कैन करता है आस-पास के Bluetooth उपकरणों के लिए (BLE और Classic दोनों)
उपकरणों की पहचान करता है विक्रेता (MAC address lookup) और BLE service UUIDs द्वारा
उपकरणों को वर्गीकृत करता है श्रेणियों में (फ़ोन, ऑडियो, वियरेबल्स, IoT, वाहन, आदि)
उपस्थिति पैटर्न ट्रैक करता है समय के साथ प्रति घंटा/दैनिक हीटमैप के साथ
शोर को फ़िल्टर करता है रैंडमाइज़्ड MAC addresses से (गोपनीयता-रोटेटेड उपकरण)
उपकरण सहसंबंधों का विश्लेषण करता है साथ दिखने वाले उपकरणों को खोजने के लिए
पुश नोटिफ़िकेशन भेजता है जब watched उपकरण आते या जाते हैं
वेब डैशबोर्ड प्रदान करता है निगरानी और विश्लेषण के लिए

विशेषताएँ

स्कैनिंग

दोहरे मोड की स्कैनिंग: Bluetooth Low Energy (BLE) और Classic Bluetooth
MAC address विक्रेता lookup (स्थानीय डेटाबेस + ऑनलाइन API fallback)
सटीक उपकरण वर्गीकरण के लिए BLE service UUID fingerprinting
Classic Bluetooth device class parsing
रैंडमाइज़्ड MAC फ़िल्टरिंग (मुख्य दृश्य से छिपा हुआ)

उपकरण प्रबंधन

व्यक्तिगत उपकरणों को ट्रैक करने के लिए उपकरणों को "Watched" के रूप में चिह्नित करें
उपकरणों को कस्टम समूहों में व्यवस्थित करें
उपकरणों को कस्टम नाम दें (विज्ञापित नाम इसके साथ दिखाई देता रहता है)
किसी भी उपकरण के पता लगाए गए वर्गीकरण को ओवरराइड करें
किसी भी उपकरण में कस्टम नोट्स/टैग जोड़ें
उपकरण प्रकार का पता लगाना (फ़ोन, ऑडियो, वियरेबल्स, IoT, वाहन, आदि)

विश्लेषिकी

30-दिन की उपस्थिति टाइमलाइन विज़ुअलाइज़ेशन
सिग्नल स्ट्रेंथ (RSSI) इतिहास चार्ट 7-दिन के डेटा के साथ
प्रति घंटा और दैनिक गतिविधि हीटमैप दिखाते हुए कि उपकरण कब सक्रिय हैं
पैटर्न विश्लेषण ("Weekdays, evenings 5PM-9PM")
Dwell time विश्लेषण दिखाते हुए कि उपकरण कुल कितना समय रेंज में बिताते हैं
उपकरण सहसंबंध पता लगाना साथ दिखने वाले उपकरणों को खोजने के लिए (co-presence और synchronized arrival/departure)
MAC-rotation linkage ("Likely same device") — समय में हैंडऑफ़ करने वाले, समान सिग्नल स्ट्रेंथ साझा करने वाले, और समान कैडेंस पर पिंग करने वाले रैंडमाइज़्ड identifiers को heuristic रूप से जोड़ता है
निकटता क्षेत्र (immediate, near, far, remote) सिग्नल स्ट्रेंथ के आधार पर
MAC, विक्रेता, या नाम से खोजें
ऐतिहासिक क्वेरी के लिए दिनांक सीमा खोज

नोटिफ़िकेशन (ntfy के माध्यम से)

ntfy.sh या self-hosted ntfy सर्वर के माध्यम से अपने फ़ोन/डेस्कटॉप पर पुश नोटिफ़िकेशन
नए उपकरणों का पता चलने पर सूचित करें
watched उपकरणों के वापस आने पर सूचित करें
watched उपकरणों के जाने पर सूचित करें
आगमन/प्रस्थान के लिए कॉन्फ़िगर करने योग्य थ्रेशोल्ड

संचालन

Heartbeat check-in — समय-समय पर uptime monitoring सेवा (जैसे, Uptime Kuma, Healthchecks.io) पर status POST करें
Storage rotation — कॉन्फ़िगर करने योग्य दिनों से पुरानी sightings को स्वचालित रूप से prune करें; वैकल्पिक रूप से pruning को उन पूरे stale उपकरणों तक सीमित करें जो न्यूनतम संख्या से कम बार देखे गए हों (watched उपकरण कभी prune नहीं होते)
दोनों वेब UI से या environment variables के माध्यम से कॉन्फ़िगर करने योग्य

वेब इंटरफ़ेस

Compact/Detailed view toggle विभिन्न प्रदर्शन प्राथमिकताओं के लिए
Screenshot mode सुरक्षित साझा करने के लिए MACs और नामों को अस्पष्ट करने के लिए
कीबोर्ड शॉर्टकट पावर उपयोगकर्ताओं के लिए (? दबाकर देखें)
CSV export विस्तृत उपकरण डेटा का (MAC, विक्रेता, identifier, प्रकार, BT प्रकार, device class, watched/ignored flags, first/last seen, sightings, समूह, service UUIDs, और नोट्स) — पूरे फ़िल्टर किए गए सेट को export करता है, केवल वर्तमान पृष्ठ को नहीं
उपकरण समूह संबंधित उपकरणों को व्यवस्थित करने के लिए
वैकल्पिक प्रमाणीकरण पहुँच सुरक्षित करने के लिए

कैसे?

Docker के साथ त्वरित शुरुआत (अनुशंसित)

पूर्वापेक्षाएँ — केवल Linux होस्ट

Bluehood BlueZ, Linux Bluetooth स्टैक के माध्यम से आपके Bluetooth adapter के साथ संचार करता है। कंटेनर शुरू करने से पहले होस्ट पर BlueZ इंस्टॉल और चालू होना चाहिए — Docker image में स्वयं यह शामिल नहीं है।
# Debian / Ubuntu (including Ubuntu Server)
sudo apt install bluez
sudo systemctl enable --now bluetooth

# Arch Linux
sudo pacman -S bluez bluez-utils
sudo systemctl enable --now bluetooth
होस्ट पर BlueZ के बिना आपको इस तरह की त्रुटि दिखेगी: BLE scan error: [org.freedesktop.DBus.Error.ServiceUnknown] The name org.bluez was not provided by any .service files

# Create a docker-compose.yml or download the one from this repo
# Then start with Docker Compose
docker compose up -d

# View logs
docker compose logs -f

Docker image GitHub Container Registry पर उपलब्ध है:

ghcr.io/dannymcc/bluehood:latest

वेब डैशबोर्ड http://localhost:8080 पर उपलब्ध होगा

Docker आवश्यकताएँ

Docker और Docker Compose
BLE-सक्षम Bluetooth adapter (Bluetooth 4.0+) वाला Linux होस्ट जो Central role का समर्थन करता हो
होस्ट पर BlueZ इंस्टॉल और चालू (sudo apt install bluez && sudo systemctl enable --now bluetooth)

नोट: पुराने adapters (Bluetooth 2.x/3.x) BLE स्कैनिंग का समर्थन नहीं करते। यदि आपके adapter में BLE Central role समर्थन नहीं है, तो आपको दिखेगा: No Bluetooth adapters with BLE 'central' role found.

नोट: Docker Bluetooth पहुँच के लिए privileged mode में host networking के साथ चलता है। यह BLE स्कैनिंग के लिए आवश्यक है।

सबसे लोकप्रिय

bluehood