brucedevices/firmware掠夺性ESP32固件
# :shark: Bruce
Bruce 是一款多功能的 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: 获取我们的官方开发套件！
# RF REAPER
**RF REAPER** 是我们专为 Bruce 打造的定制 PCB 开发套件！
所有主要功能开箱即可原生运行。Sub-GHz、NFC/RFID、IR、2.4GHz(NRF)、GPS 就绪以及 microSD，全部由强大的 ESP32-S3（16MB Flash / 8MB PSRAM）驱动。通过 AW9523 扩展器提供的大量 GPIO，加上 Flipper Zero 和 iButton 排针兼容性，意味着你可以无休止地对其进行破解、改装和构建。想要特定功能？通过 issue 告诉我们，我们会处理。
👉 **[购买 RF REAPER 和官方开发板](https://shop.bruce.computer)**
**也可以查看我们完全开源的硬件：** https://bruce.computer/boards
更多定制开发套件即将推出！请持续关注我们的社区！
## :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" 上传，并带有照片。），然后点击烧录即可
## :keyboard: Discord 服务器
欢迎在我们的 [Discord 服务器](https://discord.gg/WJ9XF9czVT) 上联系我们！
## :bookmark_tabs: Wiki
想了解 Bruce 支持的每一项功能的更多信息，[请在此阅读我们的 wiki](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] [Beacon 泛滥](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 泛滥（多目标）
- [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 嗅探器](https://wiki.bruce.computer/features/wifi/#raw-sniffer)
- [x] [TCP 客户端](https://wiki.bruce.computer/features/wifi/#client-tcp)
- [x] [TCP 监听器](https://wiki.bruce.computer/features/wifi/#listen-tcp)
- [x] [Evil Portal](https://wiki.bruce.computer/features/wifi/#evil-portal)
- [x] [主机扫描](https://wiki.bruce.computer/features/wifi/#scan-hosts)（支持 TCP 端口扫描）
- [x] [Responder](https://wiki.bruce.computer/features/wifi/#responder)
- [x] [ARP 欺骗](https://wiki.bruce.computer/features/wifi/#arp-spoofing)
- [x] [ARP 投毒](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] [可选] 投屏一个超长的名字和面容
- [x] [可选] 泛滥唯一对等标识符
</details>
<details>
<summary><h2>BLE</h2></summary>
- [x] [BLE 扫描](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] 扫描/复制
- [x] [自定义 SubGhz](https://wiki.bruce.computer/features/rf/#replay-payloads-like-flipper)
- [x] 频谱
- [x] 全频干扰器（向输出端发送完整方波）
- [x] 间歇干扰器（向输出端发送 PWM 信号）
- [x] 配置
- [x] RF TX 引脚
- [x] RF RX 引脚
- [x] RF 模块
- [x] RF433 T/R M5Stack
- [x] [CC1101 (Sub-Ghz)](https://wiki.bruce.computer/features/rf/#cc1101)
- [x] RF 频率
- [x] 重放
</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 接收器
- [x] [自定义 IR（NEC、NECext、SIRC、SIRC15、SIRC20、Samsung32、RC5、RC5X、RC6）](https://wiki.bruce.computer/features/ir/#replay-payloads-like-flipper)
- [x] 配置 - [X] IR TX 引脚 - [X] IR RX 引脚
</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 频谱](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 干扰器](https://wiki.bruce.computer/features/nrf24/)
- [x] 2.4G 频谱
- [ ] 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] 麦克风频谱
- [x] [二维码](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>
## 各设备的特定功能，未在此列出的功能对所有设备均可用。
| 设备 | CC1101 | NRF24 | FM 收音机 | PN532 | 麦克风 | BadUSB | RGB LED | 扬声器 | 电量计 | 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: | 提示音 | :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: | 提示音 | :x: | :x:² |
| [M5Stack M5Core BASIC](https://shop.m5stack.com/products/basic-core-iot-development-kit) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok:¹ | :x: | 提示音 | :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)（[和 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) 协助设计了 logo 和 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)，作者 [@justcallmekoko](https://github.com/justcallmekoko) — WiFi/蓝牙攻击工具包。
- [Launcher](https://github.com/bmorcelli/Launcher)，作者 [@bmorcelli](https://github.com/bmorcelli) — 适用于这些设备的多应用启动器/引导加载程序。
- [Evil-M5Project](https://github.com/7h30th3r0n3/Evil-M5Project)，作者 [@7h30th3r0n3](https://github.com/7h30th3r0n3) — 适用于 M5Stack 的 WiFi 攻击套件。
- [M5Stick-Nemo](https://github.com/n0xa/m5stick-nemo)，作者 [@n0xa](https://github.com/n0xa) — 适用于 M5Stick 设备的多功能工具固件。
Bruce 基于许多自由软件库构建，RF 和 NFC/RFID 模块的部分内容源自其他项目。
有关第三方归属和 copyleft 合规性详情，请参阅 [THIRD_PARTY.md](https://github.com/brucedevices/firmware/blob/main/THIRD_PARTY.md)。
## :construction: 免责声明
Bruce 是一款用于网络攻击和红队行动的工具，根据 Affero 通用公共许可证（AGPL）的条款分发。它仅用于合法且获得授权的安全测试目的。严禁将此软件用于任何恶意或未经授权的活动。下载、安装或使用 Bruce，即表示你同意遵守所有适用的法律法规。本软件免费提供，我们不接受针对副本或修改的任何付款。Bruce 的开发者对软件的任何滥用不承担任何责任。请自行承担使用风险。