Go 기반 네트워크 공격 및 MITM 프레임워크로, 승인된 침투 테스트, 네트워크 정찰, 트래픽 가로채기, 무선 보안 테스트, 레이어 2/3/7 공격 연구를 위한 도구입니다.
Go로 작성된 로컬 및 네트워크 보안 평가 프레임워크입니다. 이는 네트워크 평가 파이프라인 전반을 다루는 연구 및 승인된 침투 테스트 도구로, 호스트 및 서비스 검색, 열거, 자격 증명 감사, 취약점 식별, 승인된 익스플로잇을 포함합니다. 열 개의 모듈 카테고리는 정찰, 열거, OSINT, MITM(ARP/DHCP/DNS/IPv6 포이즈닝 및 인라인 HTTP/HTTPS 가로채기), 무선, 스위치 계층, 웹, 인증, 첩보, 그리고 침투 후 단계에 걸쳐 있으며, 모두 대화형 세션, 안내 마법사 또는 일회성 명령 시퀀스로 구동됩니다.
MITM은 이 광범위한 영역 내의 한 가지 기능일 뿐입니다. TOHA3EE는 중간자 시나리오에 국한되지 않습니다.
경고: toha3ee는 네트워크 트래픽을 적극적으로 리디렉션, 포이즈닝, 복호화 및 가로챕니다. 소유한 네트워크 또는 명시적으로 테스트 권한을 부여받은 네트워크에서만 사용하십시오. 제3자를 대상으로 이러한 모듈을 실행하는 것은 대부분의 관할 구역에서 불법입니다. 먼저
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), 셸 rc 편집을 건너뛰려면 --no-path, 다운로드 대신
빌드하려면 --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에는 아이콘이 포함되어 있어 설치 프로그램이 동일한
검증된 아티팩트에서 이를 등록할 수 있습니다.
제거: 바이너리와 설치 프로그램이 셸 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 권한이 필요합니다(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()에서 스스로 등록되며
레지스트리에 의해 자동으로 노출됩니다. 공격을 추가한다는 것은 attacks.Module
계약(참고: internal/attacks/attacks.go)을 구현하는 패키지를 internal/attacks/ 아래에
추가하는 것을 의미합니다:
Meta() — ID, 카테고리, 위험도, 대상, 설명, 제한 사항Preflight(ctx) — 실행 전 사전 조건 확인Run(ctx, opts) — 공격 루프 (ctx.Done을 반드시 준수해야 함)Verify(ctx) — 무슨 일이 일어났는지 보고Cleanup(ctx) — 모든 것을 되돌리고 네트워크 복원중앙 safety 라이프사이클(internal/safety)은 등록된 정리 작업과
하트비트를 추적하여 패닉이나 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 |