Ein aktives Cyber-Abwehr- & Honeypot-System für OpenWrt-Router, das von einem USB-Stick läuft.
Dynamischer Wi-Fi-Entauthentifizierungsdetektor, Engine für aktive Gegenmaßnahmen & Echtzeit-Web-Dashboard mit RSSI-Triangulationsradar. Entwickelt für ressourcenarme OpenWrt-Router, die vollständig von einem USB-ExtRoot laufen.
Das System arbeitet mit einer multithreaded, ressourcenschonenden Architektur, die CPU-Zyklen auf eingebetteter Hardware durch kernel-seitige BPF-Filter und eine thread-sichere IPC-Infrastruktur minimiert:
wlan0mon (Monitor Mode)
│
▼
[spider_core.py] ───► /tmp/spider_ipc.sock ───► [spider_attacker.py]
│ │
▼ (Kernel BPF Filter) ├─► Tarpit Engine (Freeze Tools)
[IPCSocketReader] ├─► Captive Portal Trap
│ └─► Hardware Ban (iptables)
▼
[spider_web.py] (Lightweight ThreadingTCPServer on :8080)
│
▼ (Server-Sent Events - SSE Stream)
[index.html Dashboard] ───► Real-Time Radar Sweep & Attacker Profiles Map
| Funktion | Details |
|---|---|
| Kernprotokoll | IEEE 802.11 Deauth/Disassoc-Erkennung über Scapy (store=False Zero-Packet-Pufferung). |
| Web-Dashboard | 66 KB eigenständige UI mit Tailwind CSS & Vanilla JS (Keine externen schweren Frameworks). |
| Radar-Triangulation | Echtzeit-requestAnimationFrame-Canvas, das die Entfernung von Angreifern basierend auf RSSI-Werten abbildet. |
| Offensiver Tarpit | Roh-Socket-Flood-Schleife, die darauf ausgelegt ist, Tabellen zur Dissection von Streams in Wireshark, Nmap und Masscan einzufrieren. |
| Captive Portal Trap | ThreadingTCPServer, der eine gefälschte Firmware-Update-Seite ausliefert, um WebRTC-IP-Leaks und System-Fingerabdrücke zu extrahieren. |
| Automatisierte Bereitstellung | POSIX-konformes usb_autorun.sh mit integriertem Process-Watchdog-Daemon für automatische Wiederherstellung. |
spider_core.py, spider_attacker.py, spider_web.py, index.html und usb_autorun.sh) im Stammverzeichnis Ihres USB-Sticks ab.sh usb_autorun.sh --install-hotplug
python3 spider_web.py --patch-core
python3 spider_web.py --patch-html
python3 spider_web.py --port 8080
http://IHR_ROUTER_IP:8080, um das Live-Dashboard aufzurufen. Klicken Sie auf "Activate Spider-Web Defense", um den automatisierten Daemon-Pool zu starten.Der interne Mikro-Server verwaltet die Zustandsreplikation über die folgenden schlanken Endpunkte:
GET / : Liefert die eigenständige Überwachungs-UI aus.GET /api/status : Gibt aktuelle CPU-/RAM- und Prozess-Gesundheitsmetriken des Systems zurück.GET /api/alerts : Permanente Server-Sent-Events (SSE)-Pipe, die Telemetrie zu eingehenden Bursts streamt.POST /api/toggle : Startet/beendet Hintergrundverteidigungs-Daemons sauber.| Wireless Driver | Maximal unterstützte virtuelle VAPs |
|---|---|
ath9k | 8 VAPs |
ath10k | 8–16 VAPs |
mt76 | 16 VAPs |
Hinweis: Wenn die Stabilität Ihres Hardware-Chipsatzes bei hoher hostapd-VAP-Zuweisung nachlässt, passen Sie die Variable HONEYPOT_VAP_COUNT in spider_core.py an die maximale VAP-Grenze Ihres Treibers an.
MIT — Kostenlos für persönliche, Forschungs- und defensive Sicherheitsaudits. Unbefugtes Paketmitschnitt und Hardware-Manipulation können gegen lokale Cybercrime-Gesetze verstoßen (CFAA, GDPR, Computer Misuse Act). Testen Sie immer in autorisierten Laborumgebungen.