外观
ESP32 Marauder
ESP32 Marauder 是 JustCallMeKoko 开发的 Wi-Fi / 蓝牙安全研究固件，仓库自述是「A suite of WiFi/Bluetooth offensive and defensive tools for the ESP32」。它让一块小小的 ESP32 变成便携的无线分析设备，常见于网络安全学习、无线环境勘测和防御测试。
只能用于自己拥有或获得书面授权的设备与网络
影响范围：该固件包含会影响他人网络的主动功能。未经授权对他人的 Wi-Fi、蓝牙设备进行干扰、冒充或抓包，在多数国家和地区属于违法行为，可能涉及刑事责任，也可能影响医疗等无关设备。
前置条件：只在自己拥有的设备和网络上测试，或拿到所有者的书面授权；了解当地关于未经授权访问网络、无线电干扰的法律；不要在公共场所或他人环境中使用主动功能。
回退：无法撤销已发生的违规行为。本站只介绍项目和硬件的概况，不提供任何攻击操作步骤。
项目概况
| 项目 | 内容 |
|---|---|
| 仓库 / 官网 | github.com/justcallmekoko/ESP32Marauder，另有 Wiki 和作者商店 |
| 作者 / 组织 | JustCallMeKoko |
| 开源协议 | MIT（仓库 LICENSE 文件；GitHub 元数据未识别协议，这里以文件内容为准） |
| 支持芯片 | ESP32 为主；也有适配其他 ESP32 系列的构建，具体看 release 说明 |
| 首次发布 | 仓库创建于 2019 年 9 月 13 日 |
| 版本 | release 以每日构建 (nightly) 形式发布，最近一次为 2026 年 10 月 9 日 |
| 热度 | 约 1.3 万星（2026 年 10 月） |
它是怎么工作的
固件基于 ESP32 的 Wi-Fi 混杂模式和 BLE 扫描能力，提供一个菜单式界面（有屏幕的板子）或串口 / 蓝牙命令行。按用途大致分为：
- 观察类：扫描周边 Wi-Fi 接入点和站点、统计信道使用、BLE 设备扫描、抓包保存为 PCAP 文件到 SD 卡，用于无线环境勘测和事后在电脑上分析。
- 主动测试类：对授权的目标网络做安全评估。具体功能和参数请阅读项目 Wiki，本站不展开。
- 辅助：GPS 联动记录、SD 卡日志、OTA 更新。
对防御者的价值在于：可以看到自己的网络暴露了什么，检验接入点对异常帧的反应，向非技术人员演示无线安全风险。
需要的硬件
| 类型 | 说明 |
|---|---|
| 作者官方设备 | README 提到可在作者的商店购买成品 ESP32 Marauder（具体型号以商店为准） |
| 通用开发板 | 可使用 ESP32 Dev Kit 等带 SD 卡和屏幕的板子，如 Cheap Yellow Display、M5Stack Cardputer 等（以仓库支持列表为准） |
| 外设 | microSD 卡（存放抓包）、GPS 模块（可选）、电池 |
注意：不同 ESP32 型号对 Wi-Fi 帧的支持不同，ESP-IDF 本身对部分原始帧发送有限制，这也是固件需要特殊构建的原因。
上手路径
- 阅读项目 Wiki 的概览，确认自己的使用目的合法。
- 在自己的实验室网络上做测试：自己的路由器，自己的手机，自己的开发板。
- 从下载 release、用 Web 烧录器或 esptool 刷入对应板型固件开始，工具见 烧录工具。
- 先练习被动功能：扫描、统计、保存抓包，在电脑上用 Wireshark 分析。
- 想系统学习，可看 安全研究 一篇。
生态与衍生
- 同类项目：Bruce 是功能更广的多工具固件；ESP32 Bit Pirate 偏硬件协议分析。
- 官方周边：作者在自己的商店销售成品设备。
- 社区：大量第三方设备把 Marauder 作为预装固件销售，请注意各国对此类设备的进口、销售和使用规定。
局限与注意事项
- 法律风险是最大的局限，参见上方警告。
- 项目以 nightly 构建发布，稳定性依赖具体提交；生产测试环境中，建议记录所用版本。
- ESP32 单天线、2.4 GHz only：不能覆盖 5 GHz 和 6 GHz 网络（后续芯片如 ESP32-C5 支持 5 GHz，需项目自己适配）。
- 抓包质量受限于 ESP32 射频性能，远不如专业网卡。
- 文档分散在 Wiki 和 Discord，更新速度不一致。