ESP32를 위한 ESP-IDF 네이티브 무선 보안 플랫폼.
심층적인 Wi-Fi 및 BLE 평가, 연구급 캡처와 내보내기, 그리고 실제 앱 생태계. Arduino 코어를 거치지 않고 Espressif의 ESP-IDF 위에 직접 구축되었기에, 새로운 실리콘과 무선 기능이 가장 먼저 적용되며 GhostESP와 하드웨어 사이에 추상화 계층이 존재하지 않습니다.
⭐️ GhostESP가 마음에 드시나요? 저장소에 스타를 눌러주세요. 큰 힘이 됩니다.
새로운 기능
v2.0은 UI를 재구축하고 네이티브 앱 생태계를 추가했으며 무선 워크플로를 확장했습니다. v2.1 (Revival)은 롤백 보호 기능이 있는 온디바이스 OTA, 두 번째 NFC 백엔드(ST25R3916), 앱과 스크립트 및 에셋 팩을 위한 Cloud Store, 그리고 샌드박스형 Lua 런타임인 GhostScript를 추가합니다.
전체 변경 이력은 CHANGELOG.md에서 확인하세요.
시작하기
GhostESP를 선택하는 이유
GhostESP는 도구 모음이 아니라 플랫폼입니다. 다섯 가지 점에서 차별화됩니다:
- Arduino가 아닌 ESP-IDF 기반. Marauder와 Bruce와 달리 GhostESP는 Espressif의 SDK를 직접 활용합니다. 새로운 칩과 무선 기능(802.15.4, Zigbee, C5의 5 GHz)을 가장 먼저 지원하며 무선, 메모리, 파티션에 대한 더 낮은 수준의 제어가 가능합니다. Arduino 기반 펌웨어도 동일한 API에 접근할 수 있지만, 이처럼 직접적이지는 않습니다.
- 실시간 캡처와 온디바이스 분석. USB를 통해 트래픽을 Wireshark로 실시간 스트리밍하고, 기기 자체에서 캡처(PCAP, hc22000, WiGLE, 802.15.4)를 탐색, 검사, 변환할 수 있습니다.
- GhostLink. 두 ESP32를 페어링하여 하나가 다른 하나의 무선, 키보드, 디스플레이를 실행하게 하며, Android 앱으로의 BLE 브리징, 분할 채널 워드라이빙, 피어 OTA를 지원합니다.
- 네이티브 앱. 자체 권한과 저장소를 가진 SD 앱으로,
gbt와 플러그인 SDK로 빌드되며 Cloud Store에서 설치할 수 있고, 스크립트용 Lua 런타임도 제공합니다. 예시: Device Inspector, ESP32Finder, Doom 포트, QR 생성기.
- 하나의 명령 세트, 다양한 프런트 엔드. 온디바이스 UI, 시리얼 CLI, WebUI, Flipper Zero 앱, Android 앱, 또는 GhostLink로 연결된 기기에서 GhostESP를 제어할 수 있으며, 모두 동일한 명령을 사용합니다.
기능
WiFi 기능
- Evil Portal (시리얼을 통한 버퍼의 커스텀 HTML 지원)
- Deauth / disassoc 공격
- 채널 전환 공격
- GTK 악용 / 클라이언트 격리 테스트
- EAPOL 로그오프 공격
- Karma (커스텀 SSID 목록 및 커스텀 포털 체이닝 지원)
- 비콘 스팸 (단일/목록/랜덤/Rickroll)
- AP 스캔 / STA 스캔 / scanall
- AP 및 스테이션 다중 선택
- 프로브 요청 청취 (자동 생성 Evil Twin 지원)
- 핸드셰이크 + PMKID 캡처
- SD로의 WiFi 캡처 (PCAP), 온디바이스 PCAP 브라우저 + hc22000 내보내기 지원
- Wireshark용 USB 동글 모드 (extcap 스트림)
- DHCP 기아
- ARP / 포트 / SSH / 로컬 IP 스캐너
- mDNS 검색 / NetBIOS 스캔 / HTTP 배너 스캔 / SNMP 프로브 (호스트별 및 서브넷별 변형 지원)
- WiFi OUI 벤더 조회
- WPA3/SAE 공격 (플러드 + 컴플라이언스 검사기)
- 워드라이빙 내보내기 (WiFi/BLE/GPS) + 스윕 CSV (WiFi/BLE/GPS/802.15.4)
- GhostLink를 통한 분할 채널 워드라이빙 헬퍼
- RSSI 추적 (AP/스테이션), 실시간 RSSI 미터 뷰 지원
- 드론 탐지 / 스푸핑
- PineAP 탐지
- Flock / 감시 탐지기
- WPS 탐지
- Pwnagotchi 스타일 자동 캡처 모드 (Capture PWN)
- 채널 혼잡 분석
- WiFi Airspace Monitor (실시간 패킷/위협 인사이트, 빠른 채널 호핑, 의심 기기 카드, 초당 패킷 스파크라인)
- DNS 싱크홀 (내장 블록리스트 다운로드를 통한 블록리스트 기반 NXDOMAIN 차단)
- Web UI + 파일시스템 + 원격 명령 릴레이
BLE 기능
- BLE 스캔 모드 (일반, AirTag, Flipper, raw)
- OUI 접두사/벤더 필터링 + RGB 매치 펄스를 지원하는 BLE 광고 스캔
- BLE 스팸 모드 (Apple, Microsoft, Samsung, Google, Random)
- AirTag 스캔 / 스푸핑 / 선택
- BLE 패킷 캡처
- Wireshark로의 BLE 스트림
- Flipper 파인더 + RSSI
- GATT/서비스 스캔 + 기기별 열거 + 기기 추적 (실시간 RSSI 미터)
- BLE 워드라이빙
- BLE 스키머 탐지
- 드론 / OpenDroneID 스캔 / 목록 / 추적 / 스푸핑
- 위협 분류 기능이 있는 Aerial (드론) 탐지기
- Android 컴패니언 앱으로의 GhostLink BLE 브리지
USB 기능
- USB 키보드 호스트 모드 (ESP32-S3 빌드)
- GhostLink를 통한 원격 키보드 제어
- BadUSB 스크립트 러너
- BadUSB 아이덴티티 옵션 (VID/PID/제조사/제품/레이아웃/무작위화)
- BadUSB 트랙패드 (터치패드 스타일 커서 제어)
- BadUSB 마우스 지글러
- 개별 ASCII 문자 입력을 위한 BadUSB
type_char CLI
- USB HID 키보드 출력 모드 (온디바이스 키 입력을 USB로 전달)
- 전용 WebUI BadUSB 페이지
IR 기능
- 지원 보드에서의 IR TX/RX
- IR 학습 모드
- IR 간편 학습 모드
- Flipper
.ir 파일 지원
- 유니버설 라이브러리 전송
- IR CLI 도구
- IR dazzler (38 kHz 높은 듀티)
NFC 기능
- PN532 NTAG/MIFARE Classic 지원
- ST25R3916 NFC 백엔드 (EMV 결제 카드 읽기, DESFire 애플리케이션 및 파일 트리, PicoPass 및 iCLASS)
- Flipper
.nfc 가져오기/내보내기
- MIFARE Classic 사전 공격 (기본 + 사용자 사전 + 세션 키 재사용 / 섹터 스윕)
- 완전 내장 MIFARE Classic 사전
- MIFARE Classic 하드네스티드 복구
- Flipper NFC 파서 세트 (교통, 주차, 출입, 놀이공원, 로열티): BIP, Clipper, CharlieCard, Troika, Plantain, Zolotaya Korona, Ventra, WashCity, Social Moscow, Sonicare, Saflok, Gallagher, Disney Infinity, Skylanders, Aime, Hi, HWorld, Two Cities, Umarsh, Microel, MIZIP, MetroMoney, Kazan, SmartRider, TRT 등
- MIFARE Desfire 탐지
- Chameleon Ultra 지원 (CLI + UI + BLE 제어)
- Chameleon Ultra HF/LF RFID 스캔 + 리더 제어
SubGHz 기능
- 64개 채널에 걸친 신호 스캔
- 워터폴 디스플레이가 있는 주파수 분석기
- 신호 캡처 및 디코딩
- Flipper Unleashed/xMasterX 기반 20개 이상의 프로토콜 디코더
- 신호 전송 및 재생
.sub 파일로 신호 저장- Flipper SubGhz Key File 형식 호환
- CC1101 하드웨어 지원
- 주파수 대역: 315, 390, 433.92, 868.35, 915 MHz
- 완전한 CLI 지원
- GhostLink를 통한 SubGHz 원격 무선 지원
오디오 기능
- I2S DAC 오디오 플레이어 (헤드폰 감지 및 볼륨 제어가 있는 MP3 재생)
- 오디오 리시버 (TLV320DAC I2S)
- 뮤직 비주얼라이저 (RGB LED 오디오 시각화)
- 마이크 스펙트럼 / MIC 비주얼라이저 (다중 모드, 색상 모드, 감도, 스무딩, 대비를 갖춘 마이크 기반 RGB LED 효과)
디스플레이 및 센서 기능
- 캐러셀, 그리드, 리스트 레이아웃을 갖춘 완전한 LVGL 그래픽 UI
- SD에서 로드되는 커스텀 에셋 팩 (아이콘, 색상, 배경, 테마)
- 21가지 색상 테마
- 진행 표시줄이 있는 온스크린 스플래시/부팅 애니메이션
- 토스트 알림 시스템
- 레벨 배지가 있는 영구 상태 표시줄
- 터치 드래그 스크롤 + 탭 투 웨이크
- 구성 가능한 화면 타임아웃, 밝기, 방향
- 유휴 애니메이션 (Game of Life, Ghost, Starfield, HUD, Matrix, Flying Ghosts, Spiral, Falling Leaves, Bouncing Text)
- 온스크린 시계
- 나침반 화면 (자기계)
- 가속도계 화면 (G-force, 기울기, 방향, 흔들림, 속도)
- ENV-III 센서 화면 (온도, 습도, 기압, 이슬점, 고도)
- 자동 잠금이 있는 PIN 잠금 화면 (오버레이 모드는 잠금 상태에서도 캡처를 계속 실행)
- 트랙패드 / 커서 제어
- Home WiFi 구성이 있는 설정 마법사
- 접근성 설정 (글꼴 크기, 고대비, 모션 감소, 입력 반복 속도, 간질 안전 모드)
- 터미널 글꼴 크기 제어
- Rave 모드 (디스플레이 빌드)
- DRV2605 햅틱 피드백 (S3TWatch)
앱 및 확장성
- Apps Gallery (네이티브 SD 앱을 위한 중앙 런처, 카테고리별 하위 메뉴 포함)
- 네이티브 SD 앱 시스템 (권한 및 범위 지정 저장소를 가진 앱 로드, 목록, 검사, 실행, 중지, 재설정)
- 앱과 펌웨어 스캐폴딩, 빌드, 패키징을 위한 Ghost Build Tool (
gbt)
- 플러그인/앱 SDK 및 예제 앱 (Device Inspector, ESP32Finder)
- Cloud Store (온디바이스에서 앱, 스크립트, 에셋 팩 탐색 및 설치)
- GhostScript (SD 카드의 스크립트를 위한 샌드박스형 Lua 5.4 스크립팅 런타임)
- Ghostchi 가상 펫 컴패니언 (50레벨 XP 시스템, 27가지 XP 소스, 수동/공격 모드, 컴패니언 잠금 화면, 글로벌 무드, 레벨업 토스트, 상태 표시줄 배지)
- SD 브라우저 (파일/폴더 탐색, 이름 변경, 삭제, 복사/이동, 텍스트 파일 미리보기)
- hc22000 내보내기가 있는 온디바이스 PCAP 브라우저
- 온디바이스 Info 화면 (기기, 런타임, 빌드, 크레딧)
- 위험한 UI 작업을 위한 재사용 가능한 확인 팝업
추가 기능
ghostesp-revival/ghostesp