Сетевой фреймворк на Go для эксплуатации уязвимостей и MITM-атак, предназначенный для авторизованного тестирования на проникновение, разведки сети, перехвата трафика, тестирования безопасности беспроводных сетей и исследования атак на уровнях 2/3/7.
Фреймворк для оценки локальной и сетевой безопасности, написанный на Go. Это инструмент для исследований и авторизованного тестирования на проникновение, охватывающий конвейер оценки сети — обнаружение хостов и сервисов, перечисление, аудит учётных данных, выявление уязвимостей и авторизованную эксплуатацию. Его десять категорий модулей охватывают разведку, перечисление, OSINT, MITM (отравление ARP/DHCP/DNS/IPv6 и встроенный перехват HTTP/HTTPS), беспроводные сети, коммутационный уровень, веб, аутентификацию, шпионаж и постэксплуатацию — всё управляется из интерактивной сессии, пошагового мастера или однократных последовательностей команд.
MITM — лишь одна из возможностей в этой более широкой области: TOHA3EE не ограничен сценариями «человек посередине».
ВНИМАНИЕ: toha3ee активно перенаправляет, отравляет, расшифровывает и перехватывает сетевой трафик. Используйте его только в сетях, которыми вы владеете или которые вам явно разрешено тестировать. Запуск этих модулей против третьих лиц незаконен в большинстве юрисдикций. Сначала прочитайте
docs/Security.md.
Однострочные установщики загружают готовый бинарный файл для вашей платформы из последнего релиза, проверяют его контрольную сумму SHA-256 и добавляют его в PATH. Если готового бинарного файла ещё нет, они собирают из исходного кода.
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
Или из рабочей копии:
make install # installs ~/.local/bin/toha3ee and adds it to PATH
Параметры установки (Unix): --prefix <dir> (по умолчанию: /usr/local/bin для root,
иначе ~/.local/bin), --no-path — пропустить редактирование rc-файла вашей оболочки, --from-source —
собрать вместо загрузки, и TOHA3EE_VERSION=<tag> — закрепить релиз.
Запустите с sudo sh ... для установки в масштабе системы. Установщик для Windows помещает
бинарный файл в %LOCALAPPDATA%\Programs\toha3ee\bin и обновляет пользовательский PATH;
Windows-on-ARM64 запускает сборку x64.
В Linux установщик также регистрирует приложение в окружении рабочего стола: он
устанавливает логотип в тему иконок hicolor и добавляет запись .desktop
рядом с префиксом установки (например, /usr/local/share или ~/.local/share), так что
toha3ee появляется в поиске GNOME со своей иконкой. В Windows он копирует
.ico и создаёт ярлык в меню «Пуск». Релизный tarball/zip содержат
иконку, чтобы установщик мог зарегистрировать её из того же проверенного артефакта.
Удаление: удалите бинарный файл и строку PATH, которую установщик добавил в
rc-файл вашей оболочки (или %LOCALAPPDATA%\Programs\toha3ee в Windows).
После установки обновляйтесь с помощью:
toha3ee updates # `toha3ee update` works as an alias
Проверяет установленную версию на соответствие последнему официальному релизу QYVORA на GitHub, сверяет SHA-256 загруженного файла с опубликованной контрольной суммой и атомарно заменяет бинарный файл. Понижение версии отклоняется, а любой сбой оставляет текущий бинарный файл нетронутым — Go-инструментарий и Git не требуются. Подробности см. в docs/Update.md.
Требуется Go 1.26+ и libpcap.
# Debian/Ubuntu
sudo apt install libpcap-dev
# then
go build ./cmd/toha3ee
Для сборок под Linux нужны заголовочные файлы libpcap (резервный вариант установщика со сборкой из исходников проверяет их наличие и выводит правильную команду apt/dnf, если они отсутствуют). В macOS libpcap поставляется вместе с 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
Большинство атакующих модулей требуют прав root (raw-сокеты, перехват пакетов и IP-форвардинг). Запускайте от имени root или, где возможно, с CAP_NET_ADMIN/CAP_NET_RAW. Добавьте --no-color, чтобы отключить цветной вывод, -v для подробного логирования.
Команды, работающие с сетевым стеком (tui, wizard, eval, run, script), по умолчанию выполняются с административными привилегиями: в Linux/macOS инструмент перезапускает себя через sudo и запрашивает пароль администратора (root). Локальные команды никогда не повышают привилегии и не требуют пароля — version, modules, capabilities, completion, help, updates, build и report выполняются без привилегий от имени вызывающего пользователя. Передайте --no-sudo (или установите TOHA3EE_NO_SUDO=1), чтобы отключить повышение привилегий и для сетевых команд.
Всё является модулем. Модули самостоятельно регистрируются в init() своего пакета и автоматически становятся доступны через реестр; чтобы добавить атаку, нужно добавить пакет в internal/attacks/, реализующий контракт attacks.Module (см. internal/attacks/attacks.go):
Meta() — ID, категория, риск, цели, описание, ограниченияPreflight(ctx) — проверка предусловий перед запускомRun(ctx, opts) — цикл атаки (должен учитывать ctx.Done)Verify(ctx) — отчёт о том, что произошлоCleanup(ctx) — отмена всего, восстановление сети