Go-basiertes Netzwerk-Exploitation- und MITM-Framework für autorisierte Penetrationstests, Netzwerkaufklärung, Abfangen von Netzwerkverkehr, Wireless-Sicherheitstests und Layer-2/3/7-Angriffsforschung.
Ein Framework zur Bewertung der lokalen und Netzwerksicherheit, geschrieben in Go. Es ist ein Forschungs- und Werkzeug für autorisierte Penetrationstests, das die Pipeline der Netzwerkbewertung abdeckt — Host- und Dienst-Erkennung, Enumeration, Prüfung von Anmeldedaten, Identifizierung von Schwachstellen und autorisierte Ausnutzung. Seine zehn Modulkategorien umfassen Recon, Enumeration, OSINT, MITM (ARP/DHCP/DNS/IPv6- Poisoning und Inline-HTTP/HTTPS-Interception), Wireless, Switch-Layer, Web, Auth, Espionage und Post-Exploitation — alle steuerbar über eine interaktive Sitzung, einen geführten Assistenten oder einmalige Befehlssequenzen.
MITM ist eine Fähigkeit innerhalb dieser breiteren Domäne: TOHA3EE ist nicht auf Man-in-the-Middle-Szenarien beschränkt.
WARNUNG: toha3ee leitet Netzwerkverkehr aktiv um, vergiftet ihn, entschlüsselt und fängt ihn ab. Verwende es nur in Netzwerken, die dir gehören oder für die du ausdrücklich autorisiert bist zu testen. Das Ausführen dieser Module gegen Dritte ist in den meisten Rechtsordnungen illegal. Lies zuerst
docs/Security.md.
Einzeiler-Installer laden die vorgebaute Binärdatei für deine Plattform aus dem neuesten Release herunter, verifizieren ihre SHA-256-Prüfsumme und fügen sie deinem PATH hinzu. Falls noch keine vorgebaute Binärdatei existiert, bauen sie stattdessen aus dem Quellcode.
Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.sh | sh
Windows (PowerShell):
irm https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.ps1 | iex
Oder aus einem Checkout:
make install # installs ~/.local/bin/toha3ee and adds it to PATH
Installationsoptionen (Unix): --prefix <dir> (Standard: /usr/local/bin als root,
sonst ~/.local/bin), --no-path, um das Bearbeiten Ihrer Shell-rc zu überspringen, --from-source,
um statt des Downloads aus dem Quellcode zu bauen, und TOHA3EE_VERSION=<tag>, um eine Release-Version festzulegen.
Führen Sie die Installation mit sudo sh ... aus, um systemweit zu installieren. Der Windows-Installer legt die
Binärdatei in %LOCALAPPDATA%\Programs\toha3ee\bin ab und aktualisiert Ihren Benutzer-PATH;
Windows-on-ARM64 führt den x64-Build aus.
Unter Linux registriert der Installer die App außerdem bei der Desktop-Umgebung: Er
installiert das Logo im hicolor-Icon-Theme und legt einen .desktop-Eintrag
neben dem Installationspräfix ab (z. B. /usr/local/share oder ~/.local/share), sodass
toha3ee mit seinem Icon in der GNOME-Suche erscheint. Unter Windows kopiert er die
.ico-Datei und erstellt eine Startmenü-Verknüpfung. Das Release-Tarball/Zip enthält das
Icon, damit der Installer es aus demselben verifizierten Artefakt registrieren kann.
Deinstallation: Löschen Sie die Binärdatei und die PATH-Zeile, die der Installer Ihrer
Shell-rc hinzugefügt hat (oder %LOCALAPPDATA%\Programs\toha3ee unter Windows).
Sobald installiert, aktualisieren Sie mit:
toha3ee updates # `toha3ee update` works as an alias
Vergleicht die installierte Version mit dem neuesten offiziellen QYVORA-GitHub- Release, verifiziert den SHA-256-Wert des Downloads gegen die veröffentlichte Prüfsumme und tauscht die Binärdatei atomar aus. Downgrades werden abgelehnt, und bei jedem Fehler bleibt Ihre aktuelle Binärdatei unangetastet — keine Go-Toolchain oder Git erforderlich. Siehe docs/Update.md für Details.
Erfordert Go 1.26+ und libpcap.
# Debian/Ubuntu
sudo apt install libpcap-dev
# then
go build ./cmd/toha3ee
Linux-Builds benötigen libpcap-Header (der From-Source-Fallback des Installers prüft darauf und gibt den passenden apt/dnf-Befehl aus, falls sie fehlen). macOS liefert libpcap mit den Xcode Command Line Tools.
# Interactive session (bare command drops straight in)
sudo ./toha3ee --iface eth0
# Interactive session (explicit subcommand)
sudo ./toha3ee tui --iface eth0
# Guided wizard
sudo ./toha3ee wizard --iface eth0
# One-shot: scan the subnet, then show what was found
sudo ./toha3ee --eval "net.scan; net.show" --iface eth0
# One-shot: procedural deep recon (synscan -> fingerprint -> service enum)
sudo ./toha3ee --eval "net.recon; net.profile" --iface eth0
# Non-interactive caplet script
sudo ./toha3ee run --iface eth0 caplets/basic.cap
# Dry-run a .toha3ee script (validates it, prints the plan, sends no packets)
./toha3ee build scripts/full-pipeline.toha3ee
# Execute a .toha3ee script non-interactively
sudo ./toha3ee script --iface eth0 scripts/full-pipeline.toha3ee
Die meisten Angriffsmodule erfordern Root-Rechte (Raw-Sockets, Paketmitschnitt und IP-Weiterleitung). Führe sie als Root oder, wo möglich, mit CAP_NET_ADMIN/CAP_NET_RAW aus. Füge --no-color hinzu, um die farbige Ausgabe zu deaktivieren, und -v für ausführliches Logging.
Die Verben, die auf den Netzwerk-Stack zugreifen (tui, wizard, eval, run, script), laufen standardmäßig mit Administratorrechten: Unter Linux/macOS startet sich das Tool selbst über sudo neu und fragt nach dem Administrator-(Root-)Passwort. Lokale Verben eskalieren nie und benötigen kein Passwort — version, modules, capabilities, completion, help, updates, build und report laufen unprivilegiert als der aufrufende Benutzer. Übergib --no-sudo (oder setze TOHA3EE_NO_SUDO=1), um die Eskalation auch für die Netzwerk-Verben zu unterdrücken.
Alles ist ein Modul. Module registrieren sich selbst in der init() ihres Pakets und werden automatisch durch die Registry verfügbar gemacht; einen Angriff hinzuzufügen bedeutet, ein Paket unter internal/attacks/ hinzuzufügen, das den attacks.Module-Vertrag implementiert (siehe internal/attacks/attacks.go):
Meta() — ID, Kategorie, Risiko, Ziele, Beschreibung, EinschränkungenPreflight(ctx) — Vorbedingungen vor der Ausführung prüfenRun(ctx, opts) — die Angriffsschleife (muss ctx.Done respektieren)Verify(ctx) — berichten, was geschehen istCleanup(ctx) — alles rückgängig machen, das Netzwerk wiederherstellen