razkom/ghostESP32-S3 फर्मवेयर जो TFT UI के माध्यम से स्टैंडअलोन WPA/WPA2 हैंडशेक कैप्चर और डीऑथेंटिकेशन परीक्षण के लिए है, साथ ही वाई-फाई AP पर pcap डाउनलोड की सुविधा प्रदान करता है।
# GHOST
**सामान्य हैकिंग एवं अवलोकन सुरक्षा उपकरण**
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/8441/723fefa9a386c635a4dbc81bc529af66c055507be31570c0208defdcd82be4ff.jpg" alt="GHOST — मुख्य दृश्य" width="720" />
</p>
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/8441/85ab843ff95aebf93c0a93eafb70864215b983fb8ce8b6da3465809adab2fd89.jpg" alt="GHOST — पिछला दृश्य" width="360" />
<img src="https://assets.kitploit.com/production/public/readmes/8441/7fc978103ef475436089bb18084593b50f2d51146427bb64a3d77631b6b133da.jpg" alt="GHOST — खड़ा" width="360" />
</p>
स्टैंडअलोन WPA/WPA2 **हैंडशेक कैप्चर** फर्मवेयर **Adafruit ESP32-S3 Reverse TFT Feather** के लिए: इसमें **240×135 TFT** और **तीन बटन** हैं — सामान्य उपयोग के लिए किसी साथी फ़ोन ऐप या ब्राउज़र की आवश्यकता नहीं है। कैप्चर `.pcap` के रूप में LittleFS पर सहेजे जाते हैं; **Captures → Download AP** एक छोटा WiFi नेटवर्क प्रकट करता है ताकि आप फ़ाइलों को सूचीबद्ध कर सकें और किसी अन्य डिवाइस पर डाउनलोड कर सकें।
**केवल शैक्षिक और अधिकृत परीक्षण के लिए।** केवल उन नेटवर्कों पर उपयोग करें जिनके आप मालिक हैं या जिनके परीक्षण की स्पष्ट अनुमति आपके पास है।
---
## यह क्या करता है
एक अधिकृत लक्ष्य पर, फर्मवेयर डीऑथेंटिकेशन फ्रेम भेज सकता है, ग्राहकों के पुनः कनेक्ट होने पर WPA 4-वे हैंडशेक कैप्चर कर सकता है, और परिणाम को फ्लैश पर संग्रहीत कर सकता है। UI पूरी तरह से TFT पर है; डाउनलोड वेब UI केवल तब चलता है जब आप **Captures** से **Download AP** शुरू करते हैं।
---
## विशेषताएँ
- **स्टैंडअलोन UI** — TFT पर मेनू; Up / Select / Down (और आवश्यकतानुसार बोर्ड रीसेट)
- **स्कैन** — नेटवर्क ब्राउज़ करें; प्रति नेटवर्क **Attack**, **+WL**, **+BL**, या वापस
- **Hunt Whitelisted** — श्वेतसूची को क्रम से चलें
- **Hunt All** — ब्लैकलिस्टेड को छोड़कर सभी दृश्यमान नेटवर्क (जहाँ लागू हो, खुले नेटवर्क को छोड़ता है)
- **Whitelist & Blacklist** — स्थायी सूचियाँ
- **Captures** — `.pcap` फ़ाइलों की सूची, स्टोरेज साफ़ करें, या **Download AP** शुरू करें
- **बुनियादी एंटीफ़िंगरप्रिंट** — वैकल्पिक STA MAC रैंडमाइज़ेशन (बूट और/या प्रत्येक हमले पर, साथ ही मैन्युअल नवीनीकरण), डीऑथ स्पेसिंग पर ±20–30% जिटर, रैंडमाइज़्ड डीऑथ रीज़न कोड (स्थिर के बजाय 1/2/3/4/8), और Preferences में संग्रहीत प्रति-डिवाइस Download AP SSID/पासवर्ड (**Settings** में संपादन योग्य या पुनः-रैंडमाइज़ किया जा सकता है)
- **सेटिंग्स** — टाइमिंग और हंट सीमाएँ (ऊपर), साथ ही सभी एंटीफ़िंगरप्रिंट टॉगल और AP क्रेडेंशियल्स; परिवर्तन फ्लैश पर **ऑटोसेव** (छोटा डिबाउंस; **Settings** छोड़ते समय फ्लश)
- **NeoPixel** स्टेटस फ़ेदर पर
---
## हार्डवेयर
### भागों की सूची
| भाग | Adafruit | मूल्य (लगभग) |
|------|----------|-----------------|
| **Adafruit ESP32-S3 Reverse TFT with w.FL Antenna** | [उत्पाद 6303](https://www.adafruit.com/product/6303) | स्टोर देखें |
| **RP-SMA to w.FL / MHF3 / IPEX3 एडाप्टर** | [उत्पाद 5444](https://www.adafruit.com/product/5444) | $2.95 |
| **2.4GHz Dipole Swivel Antenna with RP-SMA — 2dBi** | [उत्पाद 944](https://www.adafruit.com/product/944) | $7.95 |
**w.FL** बोर्ड बाहरी 2.4 GHz पथ का उपयोग करता है: **w.FL / IPEX3** (u.FL नहीं) → **RP-SMA** पिगटेल → **डायपोल** ([Feather गाइड](https://learn.adafruit.com/adafruit-esp32-s3-reverse-tft-feather/overview))
आपको पावर और फ्लैशिंग के लिए **USB-C केबल** की आवश्यकता है।
**पावर (बैटरी की आवश्यकता नहीं):** आप बोर्ड को USB-C से चला सकते हैं (चार्जर, लैपटॉप, या उपयुक्त केबल/OTG वाला फ़ोन)। JST पर LiPoly वैकल्पिक है; यह बिल्ड अक्सर नीचे दिए गए बोर्ड मॉड के बाद इसे छोड़ देता है।
### बोर्ड संशोधन (बाहरी एंटीना)
एनक्लोजर क्लीयरेंस / रूटिंग के लिए कंपोनेंट साइड पर **दो** थ्रू-होल कनेक्टर हटाएँ: **JST-PH बैटरी** कनेक्टर (USB-C के पास) और **STEMMA QT / JST-SH** I²C कनेक्टर (मिड-बोर्ड)। ध्यान से डीसोल्डर करें।
### पिन
कोई अतिरिक्त वायरिंग नहीं; डिफ़ॉल्ट [`config_s3.h`](https://github.com/razkom/ghost/blob/main/config_s3.h) में हैं।
---
## सॉफ़्टवेयर सेटअप
### 1. Arduino IDE
[arduino.cc](https://www.arduino.cc/en/software) — 2.x ठीक है।
### 2. ESP32 बोर्ड पैकेज
1. **File → Preferences** → अतिरिक्त बोर्ड मैनेजर URL:
```text
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
```
2. **Tools → Board → Boards Manager** → **esp32** by Espressif इंस्टॉल करें (3.x, ESP32-S3 सक्षम)।
### 3. बोर्ड चयन
- **Adafruit ESP32-S3 Reverse TFT Feather** (नाम कोर संस्करण के अनुसार थोड़ा भिन्न हो सकता है)
- सही **Port**; यदि अपलोड विफल होते हैं तो **USB CDC On Boot** सक्षम करें (Adafruit के अनुसार)
### 4. Deauth फ्रेम पैच (लिंकर)
ESP32 WiFi स्टैक रॉ डीऑथ फ्रेम को तब तक ब्लॉक करता है जब तक फर्मवेयर `ieee80211_raw_frame_sanity_check` को ओवरराइड नहीं कर सकता (`GHOST_TFT.ino` में लागू)। लिंकर को उस प्रतीक को SDK कॉपी को ओवरराइड करने की अनुमति देनी चाहिए — अपने इंस्टॉल किए गए **`platform.txt`** में `compiler.c.elf.libs` में **`-zmuldefs`** जोड़ें (कई ESP32 "रॉ फ्रेम" स्केच में उपयोग किया जाने वाला समान परिवर्तन):
**`platform.txt` ढूँढें:**
``` text
Windows: C:\Users\<USERNAME>\AppData\Local\Arduino15\packages\esp32\hardware\esp32\<VERSION>\platform.txt
Mac: ~/Library/Arduino15/packages/esp32/hardware/esp32/<VERSION>/platform.txt
Linux: ~/.arduino15/packages/esp32/hardware/esp32/<VERSION>/platform.txt
```
बदलें:
``` text
compiler.c.elf.libs="@{compiler.sdk.path}/flags/ld_libs"
```
को:
``` text
compiler.c.elf.libs="@{compiler.sdk.path}/flags/ld_libs" -zmuldefs
```
सहेजें और **Arduino IDE पुनरारंभ करें**।
### 5. स्केच खोलें और फ्लैश करें
1. **`GHOST_TFT.ino`** खोलें (सभी `.h` फ़ाइलों को उसी फ़ोल्डर में रखें)।
2. **Upload** करें। यदि ROM बूटलोडर की आवश्यकता हो तो **BOOT** / रीसेट का उपयोग करें।
स्केच फ़ोल्डर का नाम `.ino` फ़ाइल नाम से मेल खाना चाहिए (यह रेपो: **`GHOST_TFT`** / **`GHOST_TFT.ino`**)।
---
## उपयोग
### मुख्य मेनू
- **Scan Networks** — **Attack**, **+WL**, **+BL**, या वापस चुनें
- **Hunt Whitelisted** / **Hunt All**
- **Captures** — **Download AP** एक WiFi AP शुरू करता है जो **Settings** से SSID और पासवर्ड का उपयोग करता है (पहले बूट पर रैंडमाइज़ किया गया, फिर Preferences में संग्रहीत)
- **Lists** — श्वेतसूची / ब्लैकलिस्ट प्रविष्टियाँ संपादित करें
- **Settings** — हमले का समय, एंटीफ़िंगरप्रिंट विकल्प, Download AP SSID/पासवर्ड (परिवर्तन थोड़ी देरी के बाद ऑटोसेव होते हैं, या जब आप **Settings** छोड़ते हैं)। SSID/पासवर्ड संपादन: वर्तमान वर्ण पर हाइलाइटेड कर्सर; अगली स्थिति के लिए **Select** टैप करें (रिलीज़ करें); समाप्त करने के लिए **hold Select** (~1s, `config_s3.h` में `SELECT_LONG_PRESS_MS` के रूप में कॉन्फ़िगर करने योग्य)
### Download AP
**Captures** से **Download AP** शुरू करें, किसी अन्य डिवाइस पर उस SSID से जुड़ें (पासवर्ड TFT और **Settings** पर दिखाया गया है), दिखाया गया IP खोलें (अक्सर `http://192.168.4.1`), `.pcap` फ़ाइलें डाउनलोड करें, फिर **Select** से AP बंद करें।
---
## परियोजना संरचना
``` text
GHOST_TFT/
├── assets/
│ └── logo.svg
├── docs/images/
├── GHOST_TFT.ino
├── config_s3.h
├── types.h
├── display.h
├── input.h
├── storage.h
├── attack.h
├── download_server.h
└── logo.h
```
---
## सीमाएँ
- **केवल 2.4 GHz** — 5 GHz ग्राहक बैंड के बाहर पुनः कनेक्ट हो सकते हैं।
- **PMF / WPA3** — जहाँ प्रबंधन फ्रेम संरक्षित हैं, वहाँ डीऑथ को अनदेखा किया जा सकता है।
- **एक रेडियो** — Download AP केवल तब चलता है जब आप इसे **Captures** से शुरू करते हैं।
- **फ्लैश** — LittleFS आकार सीमित करता है कि आप कितने बड़े कैप्चर रख सकते हैं।
---
## समस्या निवारण
**`unsupport frame type` / डीऑथ काम नहीं कर रहा** — `-zmuldefs` जोड़ें और IDE पुनरारंभ करें; `platform.txt` में लाइन की पुष्टि करें।
**ESP32-S3 पर अपलोड विफलता** — डेटा-सक्षम USB केबल; Adafruit के अनुसार BOOT/रीसेट।
**कैप्चर में अधूरा या गायब हैंडशेक** — सिग्नल, PMF, 5 GHz ग्राहक, या टाइमआउट; **Settings** ट्यून करें और अपने नियंत्रण वाले प्रयोगशाला नेटवर्क पर पुनः परीक्षण करें।
---
## कानूनी
**केवल शैक्षिक और अधिकृत सुरक्षा परीक्षण।** उन नेटवर्कों पर डीऑथेंटिकेशन ट्रैफ़िक भेजना या हैंडशेक कैप्चर करना जिनका परीक्षण करने की आपको अनुमति नहीं है, कई क्षेत्राधिकारों में **अवैध** है।
---
## क्रेडिट
**Arduino-ESP32** कोर के साथ निर्मित। रॉ WiFi फ्रेम तकनीकें [Jeija / esp32-80211-tx](https://github.com/Jeija/esp32-80211-tx) जैसे सामुदायिक कार्य की ऋणी हैं।
---
## समर्थन
GHOST मुफ्त और ओपन सोर्स है। यदि यह उपयोगी रहा है, तो टिप की हमेशा सराहना की जाती है लेकिन कभी उम्मीद नहीं की जाती।
[](https://ko-fi.com/razcom)