基于 Go 语言的网络利用与中间人(MITM)框架,适用于授权渗透测试、网络侦察、流量拦截、无线安全测试及第 2/3/7 层攻击研究。
一个用 Go 编写的本地与网络安全评估框架。它是一个研究与授权渗透测试工具,覆盖网络评估流程——主机与服务发现、枚举、凭据审计、漏洞识别以及授权利用。它的十个模块类别涵盖侦察、枚举、OSINT、MITM(ARP/DHCP/DNS/IPv6 投毒以及内联 HTTP/HTTPS 拦截)、无线、交换层、Web、认证、间谍活动与后渗透——全部可通过交互式会话、引导式向导或一次性命令序列来驱动。
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>(默认:以 root 身份运行时为 /usr/local/bin,否则为 ~/.local/bin)、--no-path 用于跳过编辑 shell rc、--from-source 用于从源码构建而非下载,以及 TOHA3EE_VERSION=<tag> 用于固定某个发布版本。使用 sudo sh ... 运行以进行系统级安装。Windows 安装程序会将二进制文件放入 %LOCALAPPDATA%\Programs\toha3ee\bin 并更新你的用户 PATH;Windows-on-ARM64 会运行 x64 构建。
在 Linux 上,安装程序还会向桌面环境注册该应用:它将徽标安装到 hicolor 图标主题,并在安装前缀旁边(例如 /usr/local/share 或 ~/.local/share)放置一个 .desktop 条目,因此 toha3ee 会带着其图标出现在 GNOME 的搜索中。在 Windows 上,它会复制 .ico 并创建开始菜单快捷方式。发布 tarball/zip 中包含该图标,因此安装程序可以从同一个经过验证的产物中注册它。
卸载:删除二进制文件以及安装程序添加到你的 shell rc 中的 PATH 行(在 Windows 上则为 %LOCALAPPDATA%\Programs\toha3ee)。
安装完成后,使用以下命令更新:
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 随 Xcode Command Line Tools 一起提供 libpcap。
# 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 权限(原始套接字、数据包捕获和 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) — 撤销一切,恢复网络一个中央 safety 生命周期(internal/safety)跟踪已注册的清理操作和心跳,以便每次攻击即使在 panic 或 SIGINT 时也能被拆除;共享的 store 保存主机清单、捕获的凭据、会话以及为报告生成器提供数据的事件日志。
| 路径 | 用途 |
|---|---|
cmd/toha3ee | CLI:控制台、向导、--eval、caplet 运行器、script/build |
internal/ui | 控制台渲染:横幅、调色板、分区、表格、状态字形、HUD |
internal/script | .toha3ee 脚本语言:词法分析器、解析器、引擎 |
internal/attacks/ | 按类别划分的所有攻击模块 |
internal/netx/ | 协议原语(ARP、DHCP、DNS、NDP、802.11、SMB/NTLM、代理等) |
internal/hijack | HTTP/HTTPS MITM 代理和凭据/会话拦截 |
internal/phish | 强制门户钓鱼和登录页面克隆 |
internal/store | 共享数据存储和事件总线 |
internal/safety | 清理/心跳生命周期 |
internal/config | JSON 配置加载 |
internal/oui | MAC 厂商数据库 |
pkg/certutil | 框架 CA 和每主机 TLS 证书 |
运行 toha3ee modules 获取完整、最新的目录。亮点:
| 类别 | 模块 |
|---|---|
| mitm | arp.spoof、dns.spoof、dns.rebind、dhcp.rogue、dhcp.starve、dhcp6.spoof、icmp.redirect、ipv6.ra、ipv6.ndp、llmnr.poison、wpad.poison |
| espionage | http.harvest、http.proxy、https.proxy、ssl.strip、phish.inject |
| auth | default.creds、ntlm.relay、smb.signing、smb.kerberoast、auth.spray、auth.brute、auth.userenum、auth.asrep |
| recon | net.scan、net.ping、net.traceroute、net.osdetect、service.synscan、service.tcpconnect、service.udpscan、service.finxmas、service.ack、service.protoscan、service.idle、service.fingerprint、service.tls、web.dir、cve.suggest |
| osint | osint.dns、osint.whois、osint.ct、osint.asn、osint.shodan、osint.bucket、osint.wayback、osint.github、osint.hibp、osint.metadata、osint.dork、osint.harvest |
| enum | smtp.enum、snmp.enum、ldap.enum、nfs.enum、smb.enum、net.ip6sweep |
| web | web.misconfig |
| switch | switch.flood、switch.portsteal、switch.vlanhop、switch.cdp、switch.stp |
| wireless | wlan.scan、wlan.deauth、wlan.handshake、wlan.eviltwin、wlan.pmkid、wlan.beaconflood、wlan.karma |
| post | report.generate、session.replay、pcap.export |
裸 toha3ee(或 toha3ee tui,或较早的 interactive/repl/shell 拼写)会打开共享的 QYVORA 终端应用程序。命令在提示符处输入,并针对一个实时会话进行求值,因此先执行 net.scan 再执行 net.show 会看到相同的主机、凭据和运行中的模块:评估是累积的,而不是每条命令都重新构建。
该界面与一次性 CLI 一样,从相同的结构化事件流渲染,因此不会从人类可读输出中抓取任何内容。每条命令都会成为滚动记录中一个带标签的块——发现、工件、进度以及命令自身的输出——并带有显示界面状态的持久页眉、用于查看原始事件日志的 Ctrl+O 视图、基于实时模块注册表的制表符补全,以及用于停止正在运行的命令的 Ctrl+C 或用于退出的 Ctrl+D。
由于会话本身就是产品,因此有两种行为与其他框架不同:保存已发现主机和凭据的存储在整个进程生命周期内驻留在内存中,并且会话本身会拒绝机器报告格式。在会话内部,report <file> 改为将 JSON 报告写入该路径,因为会话的 stdout 属于人类界面,而不是机器流。