ESP32를 위한 ESP-IDF 네이티브 무선 보안 플랫폼.
심층적인 Wi-Fi 및 BLE 평가, 연구급 캡처와 내보내기, 그리고 실제 앱 생태계. Arduino 코어를 거치지 않고 Espressif의 ESP-IDF 위에 직접 구축되어, 새로운 실리콘과 무선 기능이 가장 먼저 적용되며 GhostESP와 하드웨어 사이에 추상화 계층이 없습니다.

⚠️ GhostESP는 공식 플래셔 또는 GitHub 릴리스의 바이너리로만 플래시하세요. 서드파티 플래셔와 미러에 대해서는 무결성을 검증하거나 지원을 제공할 수 없습니다.
⭐️ GhostESP가 마음에 드시나요? 저장소에 스타를 눌러주세요. 큰 힘이 됩니다.
새로운 기능
v2.2: LoRa가 듀얼 스택이 되고, 캡처가 더 풍부해지며, 탐지 범위가 넓어졌습니다.
- LoRa: SX1262에서 Meshtastic과 MeshCore를 런타임에 전환 가능하며, BLE를 통한 공식 앱을 지원합니다. Heltec V3, T-Deck, CrowPanel Advance 2.4/2.8/4.3", CrowPanel Advanced P4 7/9/10.1"에 탑재됩니다.
- 캡처: Wireshark에서 프레임별 신호, 채널, 속도; 802.1Q/QinQ VLAN 태그; EAPOL 및 Wireshark 캡처에서 제어 프레임(RTS/CTS/ACK).
- 탐지: 더 넓어진 BLE 기기 탐지 목록(Tile, SmartTag, Chipolo, AirPods, Apple Watch, FindMy, Fast Pair, 보청기 등), 그리고
bledetect, mdnssniff, dualwd BLE + Wi-Fi 워드라이빙.
- 앱: Game Boy / Game Boy Color 에뮬레이터, 갤러리 폴더(Tools, System, Games, Communication, Media, Sensors), 그리고 더 풍부해진 플러그인 UI API.
- 편의성: 아날로그 및 세븐세그먼트 페이스가 있는 상태 표시줄 시계, 국가 선택기, 행 높이 설정, 런타임 IR TX/RX 핀 구성, 사용자 지정 채널 호핑, USB SD 패스스루(S3), T-Deck 오디오.
이전 버전: v2.1(Revival)은 롤백 보호 기능이 있는 온디바이스 OTA, ST25R3916 NFC 백엔드, Cloud Store, GhostScript(샌드박스 Lua)를 추가했습니다. v2.0은 UI를 재구축하고 네이티브 앱 생태계를 도입했습니다.

전체 이력은 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 스트림)
- 캡처에서 프레임별 신호, 채널, 속도, 그리고 802.1Q/QinQ VLAN 태그 및 제어 프레임(RTS/CTS/ACK) 지원
- DHCP 기아 공격
- ARP / 포트 / SSH / 로컬 IP 스캐너
- mDNS 검색 / NetBIOS 스캔 / HTTP 배너 스캔 / SNMP 프로브 (호스트별 및 서브넷별 변형 지원)
- ARP로 발견된 호스트별 수동 로컬 이름 스니퍼 (
mdnssniff: mDNS/LLMNR/SSDP/NetBIOS)
- WiFi OUI 벤더 조회
- WPA3/SAE 공격 (플러드 + 규정 준수 검사기)
- 워드라이빙 내보내기 (WiFi/BLE/GPS) + 스윕 CSV (WiFi/BLE/GPS/802.15.4)
- GhostLink를 통한 분할 채널 워드라이빙 헬퍼
- 듀얼 밴드
dualwd BLE + Wi-Fi 공존 워드라이빙 (PSRAM 보드)
- RSSI 추적 (AP/스테이션), 실시간 RSSI 미터 뷰
- 드론 탐지 / 스푸핑
- PineAP 탐지
- Flock / 감시 탐지기
- WPS 탐지
- Pwnagotchi 스타일 자동 캡처 모드 (Capture PWN)
- 채널 혼잡 분석
- 공격, AP/스테이션 스캔, Airspace Monitor, 패킷 호핑을 위한 사용자 지정 채널 호핑 계획
- WiFi Airspace Monitor (실시간 패킷/위협 인사이트, 빠른 채널 호핑, 의심 기기 카드, 초당 패킷 스파크라인)
- DNS 싱크홀 (내장 블록리스트 다운로드를 통한 블록리스트 기반 NXDOMAIN 차단)
- Web UI + 파일시스템 + 원격 명령 릴레이
BLE 기능
- BLE 스캔 모드 (일반, AirTag, Flipper, raw)
- OUI 접두사/벤더 필터링 + RGB 매치 펄스가 있는 BLE 광고 스캔
- BLE 스팸 모드 (Apple, Microsoft, Samsung, Google, Random), 선택적 사용자 지정 광고주 이름 (
blespam -name)
- AirTag 스캔 / 스푸핑 / 선택
- BLE 패킷 캡처
- Wireshark로 BLE 스트림
- Flipper 파인더 + RSSI
- GATT/서비스 스캔 + 기기별 열거 + 기기 추적 (실시간 RSSI 미터)
- BLE 워드라이빙
- BLE 스키머 탐지
- 목록, 추적, AirTag 스푸핑 액션이 있는 BLE 기기 탐지 스캔 (
bledetect): Tile, Samsung SmartTag, Chipolo, AirPods (모델별), Apple Watch, 일반 FindMy 클론, Fast Pair / Find Hub, 보청기, 노출 비콘, Chameleon Ultra
- 드론 / OpenDroneID 스캔 / 목록 / 추적 / 스푸핑
- 위협 분류 기능이 있는 Aerial (드론) 탐지기
- Android 컴패니언 앱으로의 GhostLink BLE 브리지
USB 기능
- USB 키보드 호스트 모드 (ESP32-S3 빌드)
- USB SD 카드 패스스루 (SD 슬롯이 있는 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 TX/RX 핀 구성 (CLI 또는 설정)
- 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 hardnested 복구
- Flipper NFC 파서 세트 (교통, 주차, 출입, 놀이공원, 로열티): BIP, Clipper, CharlieCard, Troika, Plantain, Zolotaya Korona, WashCity, Social Moscow, Saflok, Gallagher, Disney Infinity, Skylanders, Aime, Hi, HWorld, Two Cities, Umarsh, Microel, MIZIP, MetroMoney, Kazan, SmartRider 등
- 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)
- T-Deck 온보드 MAX98357A 스피커 앰프 지원
- 음악 비주얼라이저 (RGB LED 오디오 시각화)
- 마이크 스펙트럼 / MIC 비주얼라이저 (여러 모드, 색상 모드, 감도, 스무딩, 대비가 있는 마이크 기반 RGB LED 효과)
디스플레이 및 센서 기능