BruceDevices/firmware

GitHub: BruceDevices/firmware

Bruce 是一款专为 ESP32 硬件设计的开源红队渗透固件,集成了 WiFi 攻击、RFID 读写、射频重放及 BadUSB 等功能,可作为低成本的安全测试工具。

Stars: 5421 | Forks: 1836

![Bruce 主菜单](https://static.pigsec.cn/wp-content/uploads/repos/2026/04/ad8cfef469193456.jpg) # :shark: Bruce Bruce 是一款多功能 ESP32 固件,支持大量专注于促进红队行动的攻击性功能。 它还支持 M5stack 和 Lilygo 的产品,并且与 Cardputer、Sticks、M5Cores、T-Decks 和 T-Embeds 完美兼容。 **同时也请查看我们完全开源的硬件:** https://bruce.computer/boards ## :building_construction: 如何安装 ### 安装 Bruce 最简单的方法是使用我们的官方 Web Flasher! ### 请查看:https://bruce.computer/flasher 或者,你可以从 releases 或 actions 下载最新的二进制文件,并使用 esptool.py 在本地烧录 ``` esptool.py --port /dev/ttyACM0 write_flash 0x00000 Bruce-.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://github.com/pr3y/Bruce/wiki)。 此外,[阅读我们的常见问题解答](https://github.com/pr3y/Bruce/wiki/FAQ) ## :computer: 功能列表

WiFi

- [x] 连接到 WiFi - [x] WiFi AP - [x] 断开 WiFi 连接 - [x] [WiFi 攻击](https://github.com/pr3y/Bruce/wiki/WiFi#wifi-atks) - [x] [Beacon 垃圾信息](https://github.com/pr3y/Bruce/wiki/WiFi#beacon-spam) - [x] [目标攻击](https://github.com/pr3y/Bruce/wiki/WiFi#target-atk) - [x] 信息 - [x] 目标 Deauth - [x] EvilPortal + Deauth - [x] Deauth 泛洪(多个目标) - [x] [战争驾驶](https://github.com/pr3y/Bruce/wiki/Wardriving) - [x] [TelNet](https://github.com/pr3y/Bruce/wiki/WiFi#telnet) - [x] [SSH](https://github.com/pr3y/Bruce/wiki/WiFi#ssh) - [x] [RAW 嗅探器](https://github.com/pr3y/Bruce/wiki/WiFi#raw-sniffer) - [x] [TCP 客户端](https://github.com/pr3y/Bruce/wiki/WiFi#tcp-client) - [x] [TCP 监听器](https://github.com/pr3y/Bruce/wiki/WiFi#tcp-listener) - [x] [恶意热点](https://github.com/pr3y/Bruce/wiki/WiFi#evil-portal) - [x] [扫描主机](https://github.com/pr3y/Bruce/wiki/WiFi#evil-portal)(带有 TCP 端口扫描) - [x] [Responder](https://github.com/BruceDevices/firmware/wiki/WiFi#responder) - [x] [ARP 欺骗](https://github.com/BruceDevices/firmware/wiki/WiFi#arp-spoofing) - [x] [ARP 毒化](https://github.com/BruceDevices/firmware/wiki/WiFi#arp-poisoning) - [x] [Wireguard 隧道](https://github.com/pr3y/Bruce/wiki/WiFi#wireguard-tunneling) - [x] Brucegotchi - [x] Pwnagotchi 伙伴 - [x] Pwngrid 刷屏表情和名称 - [x] [可选] DoScreen 设置一个非常长的名称和表情 - [x] [可选] 泛洪唯一的 peer 标识符

BLE

- [X] [BLE 扫描](https://github.com/pr3y/Bruce/wiki/BLE#ble-scan) - [X] Bad BLE - 运行 Ducky 脚本,类似于 [BadUsb](https://github.com/pr3y/Bruce/wiki/Others#badusb) - [X] BLE 键盘 - 仅限 Cardputer 和 T-Deck - [X] iOS 垃圾信息 - [X] Windows 垃圾信息 - [X] Samsung 垃圾信息 - [X] Android 垃圾信息 - [X] 垃圾信息轰炸全部

RF

- [x] 扫描/复制 - [x] [自定义 SubGhz](https://github.com/pr3y/Bruce/wiki/RF#replay-payloads-like-flipper) - [x] 频谱 - [x] 全频段干扰(向输出发送完整的方波) - [x] 间歇干扰(向输出发送 PWM 信号) - [x] 配置 - [X] RF TX 引脚 - [X] RF RX 引脚 - [X] RF 模块 - [x] RF433 收发 M5Stack - [x] [CC1101 (Sub-Ghz)](https://github.com/pr3y/Bruce/wiki/CC1101) - [X] RF 频率 - [x] 重放

RFID

- [x] 读取标签 - [x] 读取 125kHz - [x] 克隆标签 - [x] 写入 NDEF 记录 - [x] Amiibolink - [x] Chameleon - [x] 写入数据 - [x] 擦除数据 - [x] 保存文件 - [x] 加载文件 - [x] 配置 - [X] [RFID 模块](https://github.com/pr3y/Bruce/wiki/RFID#supported-modules) - [x] PN532 - [x] PN532Killer - [ ] 模拟标签

IR

- [x] TV-B-Gone - [x] IR 接收器 - [x] [自定义 IR (NEC, NECext, SIRC, SIRC15, SIRC20, Samsung32, RC5, RC5X, RC6)](https://github.com/pr3y/Bruce/wiki/IR#replay-payloads-like-flipper) - [x] 配置 - [X] Ir TX 引脚 - [X] Ir RX 引脚

FM

- [x] [广播标准](https://github.com/pr3y/Bruce/wiki/FM#play_or_pause_button-broadcast-standard) - [x] [广播保留](https://github.com/pr3y/Bruce/wiki/FM#no_entry_sign-broadcast-rerserved) - [x] [广播停止](https://github.com/pr3y/Bruce/wiki/FM#stop_button-broadcast-stop) - [ ] [FM 频谱](https://github.com/pr3y/Bruce/wiki/FM#ocean-fm-spectrum) - [ ] [劫持交通广播](https://github.com/pr3y/Bruce/wiki/FM#car-hijack-ta) - [ ] [配置](https://github.com/pr3y/Bruce/wiki/FM#bookmark_tabs-config)

NRF24

- [X] [NRF24 干扰器](https://github.com/pr3y/Bruce/wiki/BLE#nrf24-jammer) - [X] 2.4G 频谱 - [ ] Mousejack

脚本

- [X] [JavaScript 解释器](https://github.com/pr3y/Bruce/wiki/Interpreter) [感谢 justinknight93](https://github.com/justinknight93/Doolittle)

其他

- [X] 麦克风频谱 - [X] 二维码 - [x] 自定义 - [x] PIX(巴西银行转账系统) - [x] [SD 卡管理器](https://github.com/pr3y/Bruce/wiki/Others#sd-card-mngr) - [x] 查看图片 - [x] 文件信息 - [x] [Wigle 上传](https://github.com/pr3y/Bruce/wiki/Wardriving#how-to-upload) - [x] 播放音频 - [x] 查看文件 - [x] [LittleFS 管理器](https://github.com/pr3y/Bruce/wiki/Others#littlefs-mngr) - [x] [WebUI](https://github.com/pr3y/Bruce/wiki/Others#webui) - [x] 服务器结构 - [x] Html - [x] SDCard 管理器 - [x] Spiffs 管理器 - [x] 巨齿鲨 - [x] [BADUsb(新功能,LittleFS 和 SDCard)](https://github.com/pr3y/Bruce/wiki/Others#badusb) - [x] USB 键盘 - 仅限 Cardputer 和 T-Deck - [x] [iButton](https://github.com/pr3y/Bruce/wiki/Others#ibutton) - [x] [LED 控制](https://github.com/pr3y/Bruce/wiki/Others#led-control)

时钟

- [X] RTC 支持 - [X] NTP 时间校准 - [X] 手动校准

连接 (ESPNOW)

- [X] 发送文件 - [X] 接收文件 - [X] 发送命令 - [X] 接收命令

配置

- [x] 亮度 - [x] 暗屏时间 - [x] 屏幕方向 - [X] UI 颜色 - [x] 开机提示音 开/关 - [x] 时钟 - [x] 睡眠 - [x] 重启
## 特定设备的功能,未在此处提及的功能适用于所有设备。 | 设备 | 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: | 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) ([及 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: | | [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: | :x: 但带有 ST25R3916 | :x: | :ok: | :ok: | :x: | :ok: | :x: | ² CYD 有一个用于 Launcher 兼容性的 LITE_VERSION 版本 ¹ Core、CYD 和 StickCs 的 Bad-USB:[这里](https://github.com/pr3y/Bruce/wiki/Others#badusb) *LITE_VERSION*:为了兼容 M5Launcher,TelNet、SSH、WireGuard、ScanHosts、RawSniffer、Brucegotchi、BLEBacon、BLEScan 和解释器均不可用 ## :sparkles: 为什么以及它看起来如何? Bruce 源于专注于像 Flipper Zero 这类设备的社区内的敏锐观察。虽然这些设备提供了对攻击性安全领域的一瞥,但明显感觉到,特别是借助于 ESP32 设备、Lilygo 和 M5Stack 产品所提供的强大且模块化的硬件生态系统,无需那么高昂的代价也能实现更多功能。 ![Bruce 主菜单](https://static.pigsec.cn/wp-content/uploads/repos/2026/04/7c89df60cb193502.png) ![Bruce 在 M5Core 上](https://static.pigsec.cn/wp-content/uploads/repos/2026/04/1b9f61e5ca193508.png) ![Bruce 在 Stick 上](https://static.pigsec.cn/wp-content/uploads/repos/2026/04/0d17f560aa193515.png) ![Bruce 在 CYD 上](https://static.pigsec.cn/wp-content/uploads/repos/2026/04/6f5fdb2f3d193521.png) 其他媒体可以[在这里找到](./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]() 感谢其 Bruce PCB 设计。 + [TH3_KR4K3N]() 感谢其 Stick cplus 扩展板 PCB 设计。 + 以某种方式为该项目做出贡献的每一个人,谢谢你们 :heart: ## :construction: 免责声明 Bruce 是一款用于网络攻击和红队行动的工具,基于 Affero General Public License (AGPL) 条款分发。它仅供合法和授权的安全测试目的使用。严禁将该软件用于任何恶意或未经授权的活动。下载、安装或使用 Bruce 即表示您同意遵守所有适用的法律和法规。本软件免费提供,我们不接受任何针对副本或修改的付款。Bruce 的开发者对任何软件滥用不承担任何责任。使用风险由您自行承担。
标签:API接口, BadUSB, Beacon Flood, Cardputer, CSV导出, Deauth攻击, ESP32固件, EvilPortal, LilyGo, M5Stack, PE 加载器, T-Deck, Wardriving, WiFi攻击, ближний бой, 信号欺骗, 开源硬件, 恶意AP, 攻击路径可视化, 物联网安全, 硬件黑客, 网络安全, 隐私保护, 黑客工具