brucedevices/firmware포식자 ESP32 펌웨어
# :shark: Bruce
Bruce는 Red Team 작전을 빠르고 휴대성 있게 수행하도록 제작된, 공격적 보안 도구로 가득한 다목적 ESP32 펌웨어입니다.
또한 [M5Stack](https://shop.m5stack.com), [LILYGO](https://lilygo.cc), [RockBase IoT](https://www.rockbaseiot.com) 및 [Elecrow](https://www.elecrow.com) 제품을 지원하며 Cardputer, Sticks, M5Cores, T-Decks, T-Embeds와도 잘 작동합니다.
## :zap: 공식 DevKit을 만나보세요!
# RF REAPER
**RF REAPER**는 Bruce를 위해 특별히 제작된 맞춤형 PCB devkit입니다!
모든 주요 기능이 기본적으로 즉시 작동합니다. Sub-GHz, NFC/RFID, IR, 2.4GHz(NRF), GPS 지원, microSD까지 모두 강력한 ESP32-S3(16MB Flash / 8MB PSRAM)로 구동됩니다. AW9523 익스팬더를 통한 수많은 GPIO와 Flipper Zero 및 iButton 헤더 호환성 덕분에 끝없이 해킹하고, 개조하고, 확장할 수 있습니다. 특정 기능이 필요하신가요? 이슈로 문의해 주시면 확인해 드리겠습니다.
👉 **[RF REAPER 및 공식 보드 구매하기](https://shop.bruce.computer)**
**완전 오픈소스 하드웨어도 확인해 보세요:** https://bruce.computer/boards
더 많은 맞춤형 devkit 보드가 곧 출시됩니다! 커뮤니티에서 소식을 놓치지 마세요!
## :building_construction: 설치 방법
### Bruce를 설치하는 가장 쉬운 방법은 공식 Web Flasher를 이용하는 것입니다!
### 확인하세요: https://bruce.computer/flasher
또는 releases나 actions에서 최신 바이너리를 다운로드한 후 esptool.py를 사용하여 로컬로 플래시할 수 있습니다.
```sh
esptool.py --port /dev/ttyACM0 write_flash 0x00000 Bruce-<device>.bin
```
**m5stack 기기의 경우**
이미 M5Launcher를 사용해 m5stack 기기를 관리하고 있다면 OTA로 설치할 수 있습니다.
또는 [m5burner 도구](https://docs.m5stack.com/en/download)에서 직접 구울 수 있습니다. 원하는 기기 카테고리에서 'Bruce'를 검색하고(제 공식 빌드는 "owner"로 업로드되며 사진이 포함됩니다) burn을 클릭하면 됩니다.
## :keyboard: Discord 서버
[Discord 서버](https://discord.gg/WJ9XF9czVT)에서 연락해 주세요!
## :bookmark_tabs: 위키
Bruce가 지원하는 각 기능에 대한 자세한 내용은 [여기 위키](https://wiki.bruce.computer/)에서 확인하세요.
또한 [FAQ](https://wiki.bruce.computer/faq/)도 읽어 보세요.
## :computer: 기능 목록
<details>
<summary><h2>WiFi</h2></summary>
- [x] WiFi에 연결
- [x] WiFi AP
- [x] WiFi 연결 해제
- [x] [WiFi 공격](https://wiki.bruce.computer/features/wifi/#wifi-atks)
- [x] [비콘 스팸](https://wiki.bruce.computer/features/wifi/#beacon-spam)
- [x] [대상 공격](https://wiki.bruce.computer/features/wifi/#target-atks)
- [x] 정보
- [x] 대상 Deauth
- [x] EvilPortal + Deauth
- [x] Deauth Flood (대상 2개 이상)
- [x] [Wardriving](https://wiki.bruce.computer/features/gps/#wardriving)
- [x] [TelNet](https://wiki.bruce.computer/features/wifi/#telnet)
- [x] [SSH](https://wiki.bruce.computer/features/wifi/#ssh)
- [x] [RAW Sniffer](https://wiki.bruce.computer/features/wifi/#raw-sniffer)
- [x] [TCP Client](https://wiki.bruce.computer/features/wifi/#client-tcp)
- [x] [TCP Listener](https://wiki.bruce.computer/features/wifi/#listen-tcp)
- [x] [Evil Portal](https://wiki.bruce.computer/features/wifi/#evil-portal)
- [x] [Scan Hosts](https://wiki.bruce.computer/features/wifi/#scan-hosts) (TCP 포트 스캔 포함)
- [x] [Responder](https://wiki.bruce.computer/features/wifi/#responder)
- [x] [Arp Spoofing](https://wiki.bruce.computer/features/wifi/#arp-spoofing)
- [x] [Arp Poisoning](https://wiki.bruce.computer/features/wifi/#arp-poisoning)
- [x] [WireGuard 터널링](https://wiki.bruce.computer/features/wifi/#wireguard-tunneling)
- [x] Brucegotchi
- [x] Pwnagotchi 친구
- [x] Pwngrid 얼굴 및 이름 스팸
- [x] [선택] DoScreen: 매우 긴 이름과 얼굴
- [x] [선택] 고유 피어 식별자 Flood
</details>
<details>
<summary><h2>BLE</h2></summary>
- [x] [BLE Scan](https://wiki.bruce.computer/features/ble/#ble-scan)
- [x] Bad BLE - Ducky 스크립트 실행, [BadUsb](https://wiki.bruce.computer/features/ble/#badble)와 유사
- [x] BLE 키보드 - Cardputer 및 T-Deck 전용
- [x] iOS 스팸
- [x] Windows 스팸
- [x] Samsung 스팸
- [x] Android 스팸
- [x] 모두 스팸
</details>
<details>
<summary><h2>RF</h2></summary>
- [x] Scan/Copy
- [x] [Custom SubGhz](https://wiki.bruce.computer/features/rf/#replay-payloads-like-flipper)
- [x] Spectrum
- [x] Jammer Full (출력에 전체 구형파 전송)
- [x] Jammer Intermittent (출력에 PWM 신호 전송)
- [x] 설정
- [x] RF TX Pin
- [x] RF RX Pin
- [x] RF 모듈
- [x] RF433 T/R M5Stack
- [x] [CC1101 (Sub-Ghz)](https://wiki.bruce.computer/features/rf/#cc1101)
- [x] RF 주파수
- [x] Replay
</details>
<details>
<summary><h2>RFID</h2></summary>
- [x] 태그 읽기
- [x] 125kHz 읽기
- [x] 태그 복제
- [x] NDEF 레코드 쓰기
- [x] Amiibolink
- [x] Chameleon
- [x] 데이터 쓰기
- [x] 데이터 지우기
- [x] 파일 저장
- [x] 파일 불러오기
- [x] 설정
- [x] [RFID 모듈](https://wiki.bruce.computer/features/rfid/#supported-modules)
- [x] PN532
- [x] PN532Killer
- [ ] 태그 에뮬레이션
</details>
<details>
<summary><h2>IR</h2></summary>
- [x] TV-B-Gone
- [x] IR Receiver
- [x] [Custom IR (NEC, NECext, SIRC, SIRC15, SIRC20, Samsung32, RC5, RC5X, RC6)](https://wiki.bruce.computer/features/ir/#replay-payloads-like-flipper)
- [x] 설정 - [X] Ir TX Pin - [X] Ir RX Pin
</details>
<details>
<summary><h2>FM</h2></summary>
- [x] [표준 방송](https://wiki.bruce.computer/features/fm/#broadcast-standard)
- [x] [예약 방송](https://wiki.bruce.computer/features/fm/#broadcast-standard)
- [x] [방송 중지](https://wiki.bruce.computer/features/fm/#broadcast-stop)
- [ ] [FM Spectrum](https://wiki.bruce.computer/features/fm/#fm-spectrum)
- [ ] [교통 안내 방송 탈취](https://wiki.bruce.computer/features/fm/#hijack-ta)
- [ ] [설정](https://wiki.bruce.computer/features/fm/#bookmark_tabs-config)
</details>
<details>
<summary><h2>NRF24</h2></summary>
- [x] [NRF24 Jammer](https://wiki.bruce.computer/features/nrf24/)
- [x] 2.4G Spectrum
- [ ] Mousejack
</details>
<details>
<summary><h2>스크립트</h2></summary>
- [x] [JavaScript 인터프리터](https://wiki.bruce.computer/features/js-interpreter/) [justinknight93님께 감사](https://github.com/justinknight93/Doolittle)
</details>
<details>
<summary><h2>기타</h2></summary>
- [x] Mic Spectrum
- [x] [QR코드](https://wiki.bruce.computer/features/others/#qrcodes)
- [x] 커스텀
- [x] PIX (브라질 계좌이체 시스템)
- [x] [SD 카드 관리자](https://github.com/pr3y/Bruce/wiki/Others#sd-card-mngr)
- [x] 이미지 보기 (jpg)
- [x] 파일 정보
- [x] [Wigle 업로드](https://wiki.bruce.computer/features/gps/#how-to-use-wigle)
- [x] 오디오 재생
- [x] 파일 보기
- [x] LittleFS 관리자
- [x] [WebUI](https://wiki.bruce.computer/controlling-device/webui/)
- [x] 서버 구조
- [x] HTML
- [x] SD 카드 관리자
- [x] SPIFFS 관리자
- [x] Megalodon
- [x] [BADUsb (새 기능, LittleFS 및 SD 카드)](https://wiki.bruce.computer/features/others/#badusb)
- [x] USB 키보드 - Cardputer 및 T-Deck 전용
- [x] [iButton](https://wiki.bruce.computer/features/others/#ibutton)
- [x] LED 제어
</details>
<details>
<summary><h2>시계</h2></summary>
- [x] RTC 지원
- [x] NTP 시간 조정
- [x] 수동 조정
</details>
<details>
<summary><h2>연결 (ESPNOW)</h2></summary>
- [x] 파일 보내기
- [x] 파일 받기
- [x] 명령 보내기
- [x] 명령 받기
</details>
<details>
<summary><h2>설정</h2></summary>
- [x] 밝기
- [x] 디밍 시간
- [x] 화면 방향
- [x] UI 색상
- [x] 부팅음 켜기/끄기
- [x] 시계
- [x] 절전
- [x] 다시 시작
</details>
## 기기별 특정 기능, 여기에 언급되지 않은 기능은 모든 기기에서 사용할 수 있습니다.
| Device | CC1101 | NRF24 | FM Radio | PN532 | Mic | BadUSB | RGB Led | Speaker | Fuel Gauge | LITE_VERSION |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----: | :---: | :------: | :------------------: | :--: | :----: | :-----: | :-----: | :--------: | :----------: |
| [M5Stack Cardputer](https://shop.m5stack.com/products/m5stack-cardputer-kit-w-m5stamps) (및 ADV) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | NS4168 | :x: | :x: |
| [M5Stack M5StickC PLUS2](https://shop.m5stack.com/products/m5stickc-plus2-esp32-mini-iot-development-kit) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok:¹ | :x: | Tone | :x: | :x: |
| [M5Stack M5StickC PLUS](https://shop.m5stack.com/products/m5stickc-plus-esp32-pico-mini-iot-development-kit) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok:¹ | :x: | Tone | :x: | :x:² |
| [M5Stack M5Core BASIC](https://shop.m5stack.com/products/basic-core-iot-development-kit) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok:¹ | :x: | Tone | :x: | :x: |
| [M5Stack M5Core2](https://shop.m5stack.com/products/m5stack-core2-esp32-iot-development-kit-v1-1) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok:¹ | :x: | :x: | :x: | :x: |
| [M5Stack M5CoreS3](https://shop.m5stack.com/products/m5stack-cores3-esp32s3-lotdevelopment-kit)/[SE](https://shop.m5stack.com/products/m5stack-cores3-se-iot-controller-w-o-battery-bottom) | :ok: | :ok: | :ok: | :ok: | :x: | :ok: | :x: | :x: | :x: | :x: |
| [JCZN CYD‑2432S028](https://www.aliexpress.us/item/3256804774970998.html) | :ok: | :ok: | :ok: | :ok: | :x: | :ok:¹ | :x: | :x: | :x: | :x:² |
| [Lilygo T‑Embed CC1101](https://lilygo.cc/products/t-embed-cc1101) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :x: |
| [Lilygo T‑Embed](https://lilygo.cc/products/t-embed) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :x: | :x: |
| [Lilygo T-Display-S3](https://lilygo.cc/products/t-display-s3) | :ok: | :ok: | :x: | :x: | :x: | :ok: | :x: | :x: | :x: | :x: |
| [Lilygo T‑Deck](https://lilygo.cc/products/t-deck) ([and pro](https://lilygo.cc/products/t-deck-plus-1)) | :ok: | :x: | :x: | :x: | :x: | :ok: | :x: | :x: | :x: | :x: |
| [Lilygo T-Watch-S3](https://lilygo.cc/products/t-watch-s3) | :x: | :x: | :x: | :x: | :x: | :ok: | :x: | :x: | :x: | :x: |
| [Lilygo T-LoRa Pager](https://lilygo.cc/products/t-lora-pager) | :x: | :x: | :x: | :x: | :x: | :ok: | :x: | :x: | :x: | :x: |
| [Smoochiee V2](https://www.pcbway.com/project/shareproject/Bruce_PCB_Smoochiee_d6a0284b.html) | :ok: | :ok: | :x: | :ok: | :x: | :ok: | :x: | :x: | :x: | :x: |
| [ESP32-C5](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32c5/esp32-c5-devkitc-1/user_guide.html) | :ok: | :ok: | :x: | :ok: | :x: | :x: | :x: | :x: | :x: | :x: |
| [Bruce RF Reaper](https://www.elecrow.com/bruce-pcb-rf-reaper.html) | :ok: | :ok: | :x: | :ok: 단, ST25R3916 사용 | :x: | :ok: | :ok: | :x: | :ok: | :x: |
| [Elecrow 24B](https://www.elecrow.com/2-4inch-esp32-miner-lcd-display-2pcs-cryptocurrency-solo-miner-with-1000kh-s-hashrate.html) | :ok: | :ok: | :ok: | :ok: | :x: | :ok:¹ | :x: | :x: | :x: | :x:² |
| [Elecrow 3.5"](https://www.elecrow.com/esp-terminal-with-esp32-3-5-inch-parallel-480x320-tft-capacitive-touch-display-rgb-by-chip-ili9488.html) | :ok: | :ok: | :ok: | :ok: | :x: | :ok:¹ | :x: | :x: | :x: | :x:² |
| [NM-CYD-C5 + RF HAT](https://https://rockbase.shop/products/nm-cyd-c5-colorful) | :ok: | :ok: | :x: | :ok: | :x: | :ok: | :ok: | :x: | :ok: | :x: |
² CYD는 Launcher 호환성을 위한 LITE_VERSION 버전이 있습니다.
¹ Core, CYD 및 StickCs의 Bad-USB: [여기](https://wiki.bruce.computer/features/others/#badusb)
_LITE_VERSION_: TelNet, SSH, WireGuard, ScanHosts, RawSniffer, Brucegotchi, BLEBacon, BLEScan 및 Interpreter는 M5Launcher 호환성을 위해 사용할 수 없습니다.
## :sparkles: 왜, 그리고 어떤 모습인가요?
Bruce는 Flipper Zero와 같은 기기에 집중하는 커뮤니티의 날카로운 관찰에서 시작되었습니다. 이 기기들은 공격적 보안의 세계를 엿볼 수 있게 해 주었지만, 특히 ESP32 디바이스, Lilygo, M5Stack 제품이 제공하는 견고하고 모듈식 하드웨어 생태계를 활용한다면 그렇게 높은 비용을 들이지 않고도 더 많은 것을 성취할 수 있다는 강한 인상이 있었습니다.
기타 미디어는 [여기](https://github.com/brucedevices/firmware/blob/main/media)에서 찾을 수 있습니다.
## :clap: 감사의 말
- [@bmorcelli](https://github.com/bmorcelli) - 새로운 코어와 많은 신규 기능, 그리고 다양한 기기로의 포팅에 감사드립니다!
- [@IncursioHack](https://github.com/IncursioHack) - RF 및 RFID 모듈 기능을 추가해 주셔서 감사합니다.
- [@Luidiblu](https://github.com/Luidiblu) - 로고 및 UI 디자인 지원에 감사드립니다.
- [@eadmaster](https://github.com/eadmaster) - 많은 기능을 추가해 주셔서 감사합니다.
- [@rennancockles](https://github.com/rennancockles) - 많은 RFID 코드, 리팩토링 및 기타 기능에 감사드립니다.
- [@7h30th3r0n3](https://github.com/7h30th3r0n3) - 리팩토링과 WiFi 공격에 많은 도움을 주셔서 감사합니다.
- [@Tawank](https://github.com/Tawank) - 인터프리터 리팩토링 외 여러 작업에 감사드립니다.
- @pablonymous - RAW 데이터를 읽기 위한 RF 기능
- [Smoochiee](https://github.com/smoochiee) - Bruce PCB 디자인에 감사드립니다.
- TH3_KR4K3N - Stick cplus 확장 PCB 디자인에 감사드립니다.
- 어떤 방식으로든 프로젝트에 기여해 주신 모든 분께 감사드립니다 :heart:
Bruce는 또한 프로젝트 전반에 걸쳐 기능과 코드에 영감을 준 위대한 오픈소스 펌웨어 프로젝트들의 어깨 위에 서 있습니다:
- [ESP32Marauder](https://github.com/justcallmekoko/ESP32Marauder) by [@justcallmekoko](https://github.com/justcallmekoko) — WiFi/Bluetooth 공격 툴킷.
- [Launcher](https://github.com/bmorcelli/Launcher) by [@bmorcelli](https://github.com/bmorcelli) — 기기용 멀티 앱 런처/부트로더.
- [Evil-M5Project](https://github.com/7h30th3r0n3/Evil-M5Project) by [@7h30th3r0n3](https://github.com/7h30th3r0n3) — M5Stack용 WiFi 공격 도구 모음.
- [M5Stick-Nemo](https://github.com/n0xa/m5stick-nemo) by [@n0xa](https://github.com/n0xa) — M5Stick 기기용 멀티툴 펌웨어.
Bruce는 많은 자유 소프트웨어 라이브러리를 기반으로 하며, RF 및 NFC/RFID 모듈의 일부는 다른 프로젝트에서 파생되었습니다. 서드파티 저작자 표시 및 카피레프트 준수에 대한 자세한 내용은 [THIRD_PARTY.md](https://github.com/brucedevices/firmware/blob/main/THIRD_PARTY.md)를 참조하세요.
## :construction: 면책 조항
Bruce는 Affero General Public License(AGPL) 조건에 따라 배포되는 사이버 공격 및 레드 팀 운영 도구입니다. 본 소프트웨어는 합법적이고 승인된 보안 테스트 목적으로만 사용해야 합니다. 악의적이거나 승인되지 않은 활동에 이 소프트웨어를 사용하는 것은 엄격히 금지됩니다. Bruce를 다운로드, 설치하거나 사용함으로써 귀하는 모든 관련 법률과 규정을 준수하는 데 동의하게 됩니다. 이 소프트웨어는 무료로 제공되며, 사본이나 수정본에 대한 대금을 받지 않습니다. Bruce 개발자는 소프트웨어의 오용에 대해 어떠한 책임도 지지 않습니다. 사용에 따른 위험은 전적으로 사용자 본인에게 있습니다.