<p align="center">
<img src="https://raw.githubusercontent.com/SudoPacman-Syuu/Beatrix-suite/HEAD/beatrix/cli/assets/beatrix-banner.png" alt="Beatrix — The Black Mamba" width="820">
</p>
<p align="center"><em>"복수는 작동하는 PoC와 함께 제공될 때 가장 맛있는 요리이다."</em></em></p>
<p align="center">
<img src="https://img.shields.io/badge/Python-3.11%2B-blue?style=flat-square&logo=python" alt="Python">
<img src="https://img.shields.io/badge/Platform-Linux-orange?style=flat-square&logo=linux" alt="Platform">
<img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License">
<img src="https://img.shields.io/github/stars/SudoPacman-Syuu/Beatrix-suite?style=flat-square" alt="Stars">
<img src="https://img.shields.io/badge/Version-2.1%20%C2%B7%20The%20Black%20Mamba-brightgreen?style=flat-square" alt="Version">
</p>
<p align="center">
로컬에서 사용 가능한 무료 <b>마스터 펜테스팅 슈퍼 스위트</b>입니다. 전체 버그 바운티 워크플로우를 하나의 웹 GUI에 담았으며, 그 아래에는 헤드리스 CLI가 작동합니다. 이 도구는 전적으로 <code >127.0.0.1</code>에서 실행되므로, 아무것도 외부로 나가지 않습니다.
</p>
스위트(The Suite)
단 하나의 명령어로 로컬 웹 워크벤치가 열립니다. 사이버 킬 체인(cyber kill chain)을 따라 정리된 전체 탐색 과정이 브라우저에서 이루어집니다. 클라우드 연결, 계정 등록, 원격 측정 기능이 전혀 없습니다:
<p align="center"><img src="https://raw.githubusercontent.com/SudoPacman-Syuu/Beatrix-suite/HEAD/screenshots/dashboard.png" alt="Beatrix Suite — scanning dashboard" width="100%"></p>
대부분의 도구는 작업의 한 부분만을 해결합니다. Beatrix는 단 하나의 로컬 명령 뒤에서 전체 침투 테스트 과정을 실행합니다. 여기에는 정찰(reconnaissance), 네트워크 및 웹 스캐닝, 바이트 단위로 충실한 Repeater, 자동화된 fuzzer, 자율적인 AI pentester, 그리고 분류 가능한 Issues 보드가 포함됩니다. 프리셋을 선택하고 원하는 스캐너 모듈(OWASP 카테고리별 그룹화)에 체크한 다음, 스캔 시작(Begin Scan) 버튼을 누르고 실시간 터미널로 이벤트와 발견 사항이 스트리밍되는 것을 지켜보세요. 터미널 사용을 선호하십니까? 동일한 도구 키트는 CLI에서 완전히 헤드리스 방식으로 실행됩니다.
**작업 공간(The workspaces)**은 킬체인(kill-chain) 단계별로 구성되어 있습니다:
- 설정(Setup) — 프로젝트, 대상 범위(Scope) (종단 간 강제 적용), 그리고 원스톱 인증(Auth) (HAR / 쿠키 / 토큰 / IDOR 슬롯)
- 정찰(Reconnaissance) — OSINT (키리스 자산 검색 + 실시간 엔티티 맵), 네트워크(Network) (nmap/Zenmap 워크벤치), 수동 스캔(Passive Scan), 사이트 맵(Site map), 그리고 패킷(Packets) 실험실
- 무기화(Weaponization) — 능동 스캔(Active Scan), 상단의 탐지 제어판
- 전달(Delivery) — 내장된 **브라우저(Browser)**와 전체 HTTP 기록(HTTP history)
- 익스플로잇(Exploitation) — Ghost (자율 AI 펜테스터), Nuclei, Repeater, AutoRepeater, 그리고 Metasploit
- 목표 달성 행동(Actions on Objectives) — 이슈(Issues) 보드
OSINT — 대상의 전체 외부 표면 매핑
키리스 서브도메인, DNS, 인증서 투명성(certificate-transparency), 수동 DNS(passive-DNS), WHOIS/RDAP, 그리고 오리진 IP 검색을 제공하며, 원클릭으로 재개 가능한 **전체 스윕(Full Sweep)**이 가능합니다. 이는 드래그하고 확장하며 피벗할 수 있는 패널형 엔티티 맵 형태로 구현됩니다.
<p align="center"><img src="https://raw.githubusercontent.com/SudoPacman-Syuu/Beatrix-suite/HEAD/screenshots/osint-map.png" alt="Beatrix Suite — OSINT entity map" width="100%"></p>
네트워크(Network) — 브라우저 기반 nmap 워크벤치
Zenmap 스타일의 프런트 엔드: 주문형 프로필 카탈로그, 재개 가능한 전체 스윕, 그리고 트레이서루트 토폴로지 뷰가 포함된 중복 제거된 포트/호스트/서비스 인벤토리입니다.
<p align="center"><img src="https://raw.githubusercontent.com/SudoPacman-Syuu/Beatrix-suite/HEAD/screenshots/network.png" alt="Beatrix Suite — Network / nmap" width="100%"></p>
HTTP 기록(history) — 리피터급 뷰어
스위트가 감지하는 모든 요청/응답을 필터링하고 검색할 수 있으며, 바이트 단위로 충실한 구문 강조 표시된 요청 및 응답 창이 제공됩니다. 마우스 오른쪽 버튼을 클릭하여 Repeater, AutoRepeater, Nuclei 또는 Scope로 원하는 데이터를 전송할 수 있습니다.
<p align="center"><img src="https://raw.githubusercontent.com/SudoPacman-Syuu/Beatrix-suite/HEAD/screenshots/http-history.png" alt="Beatrix Suite — HTTP history" width="100%"></p>
Repeater — 모든 요청을 직접 제작하고 재전송
헤더 순서를 유지하고, 디청킹(dechunks)하며, gzip/deflate를 디코딩하는 충실한 raw-HTTP 에디터입니다. 사용자가 보는 것이 곧 네트워크를 통해 전송된 것입니다. 탭, 응답 타이밍, 그리고 AutoRepeater로 한 번에 이동할 수 있습니다.
<p align="center"><img src="https://raw.githubusercontent.com/SudoPacman-Syuu/Beatrix-suite/HEAD/screenshots/repeater.png" alt="Beatrix Suite — Repeater" width="100%"></p>
Issues — 실제 요청 및 응답으로 분류/처리
정렬 가능하고 재분류 가능한 보드에서 모든 발견 사항을 관리하며, 각 항목은 완전한 Advisory / Request / Response / PoC 상세 정보를 제공합니다. 이는 재구성된 추측이 아닌 실제 캡처된 HTTP 데이터입니다. 하나 또는 전체 심각도(severity) 그룹을 Ghost로 전송하여 검증할 수 있습니다.
<p align="center"><img src="https://raw.githubusercontent.com/SudoPacman-Syuu/Beatrix-suite/HEAD/screenshots/issues.png" alt="Beatrix Suite — Issues board" width="100%"></p>
설치(Install)
git clone https://github.com/SudoPacman-Syuu/Beatrix-suite.git && cd Beatrix-suite && ./install.sh
설치 프로그램은 ~/.beatrix/venv에 Python 환경을 생성합니다(체크아웃된 버전이 편집 가능(editable)으로 설치되므로, beatrix-update가 즉시 적용됩니다). 또한 beatrix, beatrix-suite, 그리고 beatrix-update를 사용자의 PATH에 추가하고, 외부 도구들(nuclei, nmap, sqlmap, subfinder, ffuf, kiterunner, trufflehog 등)을 설치하며, 마지막으로 설정된 모든 항목을 확인하는 과정을 거칩니다. 필요한 부분이 누락되면 비정상 종료됩니다. ~/.beatrix에 있는 사용자의 데이터(발견 사항, 세션, 설정, 키)는 절대 건드리지 않습니다.
선택적 추가 기능:
./install.sh --with-sudo-rules
./install.sh --with-docker
./install.sh --with-android
나중에 도구를 복구하거나 추가하려면 beatrix setup을 사용하고, Beatrix를 제거하려면 ./uninstall.sh를 실행합니다(데이터 삭제 전에 확인 메시지를 표시합니다).
beatrix-suite는 액세스 토큰이 포함된 링크를 출력합니다 (또한 ~/.beatrix/suite.token에 저장됨). 이 링크를 열면, Suite의 API는 토큰 없이는 요청을 거부합니다. beatrix-suite --new-token 명령으로 이를 교체할 수 있습니다.
빠른 시작
beatrix-suite
beatrix
beatrix hunt example.com
...
업데이트
beatrix-update는 체크아웃을 빠르게 진행시키고(fast-forwards) 종속성을 새로 고치며, 프로젝트, 발견 사항 또는 설정을 절대 건드리지 않습니다 (설치 프로그램을 다시 실행하지 않음). beatrix update도 동일한 명령어입니다.
CLI
GUI가 가장 눈에 띄지만, 원래의 CLI는 그대로 유지되어 있습니다. 이 전체 툴킷은 Codespaces, 서버 및 CI 환경에서 헤드리스(headless)로 스크립팅이 가능합니다:
beatrix hunt example.com --preset full
beatrix strike https://api.example.com -m cors
beatrix ghost2 https://api.example.com
요구 사항
- Linux 환경의 Python 3.11 이상
- 핵심 외부 보안 도구는
./install.sh에 의해 자동으로 설치됩니다 (언제든지 beatrix setup --check로 재확인 가능).
라이선스
Apache-2.0 — 상업적 및 비상업적 사용 모두에서 자유롭고 오픈 소스입니다. LICENSE를 참조하십시오.
법적 고지
승인된 보안 테스트 목적으로만 사용해야 합니다. 명시적인 서면 허가를 받은 시스템에 대해서만 Beatrix를 실행하십시오. 컴퓨터 시스템에 대한 무단 접근은 대부분의 관할권에서 불법입니다.
<p align="center">
Beatrix는 한 개발자가 무료로 수작업으로 제작한 것입니다. 만약 이것이 워크플로우에 자리 잡게 된다면, Suite 내에 <b style="color: #FFC0CB;">개발자 지원하기</b> 버튼이 있습니다. 💛
</p>
