Mirage 无线通信分析框架

使用条件与局限

• 据 mirage/__init__.py，版本为 1.2；仓库没有标签或 GitHub 发布版本。README 于所审提交（2025-04-13）最后修改，宣布项目正式弃用、不再维护，并指向后继项目 WHAD（whad-team/whad-client）；最后一次代码改动在 2022-11-24。需从本源码树用 setup.py 安装，因为 PyPI 上名为 mirage 的包是无关的 JWST 数据模拟器。
• setup.py 依赖 scapy、pyusb、pyserial、pycryptodomex、keyboard、psutil、terminaltables 和 matplotlib，分类信息列出 Python 3.6 与 Linux。实时采集需要受支持的无线电硬件：蓝牙 HCI 适配器、运行 BTLEJack 固件的 BBC micro:bit、Nordic 与 Sniffle 嗅探器、Ubertooth、用于 Enhanced ShockBurst 和 Mosart 的 Crazyradio PA、用于 Zigbee 的 RZUSBStick、Wi-Fi 网卡、IRma 红外设备、ButteRFly nRF52840 加密狗，或用于实验性软件无线电路径的 HackRF One。这些设备的固件在其他仓库中；本仓库只有 Python 源码，不含固件镜像。
• 没有无线电硬件时，可把 PCAP 文件当作输入接口（BLE 链路层 PCAP 使用 DLT 256），ADB 与 hcidump 接口则读取 Android 手机或 Linux 主机记录的 HCI 通信。README 链接的文档网站在审阅时返回 HTTP 404；其 Sphinx 源文件位于 LAAS 的 Redmine。
• README 和 setup.py 称 Mirage 为攻击性框架，其模块和示例场景还涉及中间人、干扰、劫持、克隆和注入，包括实验性的 InjectaBLE 攻击；本条目只涵盖扫描、嗅探、解析和信息收集功能，不介绍其他部分。只应采集自己有权观察的设备和网络。
• MIT 许可（LICENSE.txt，版权 2019 Romain Cayre）。README 引用了介绍该框架的 SSTIC 2019 和 IEEE ISSRE 2019 论文。本次审阅未使用任何硬件，也未安装或运行；所审来源未确立与 REA 的关联。

关于此条目

说明已依据一手来源复核；这不代表已运行验证、经过安全审计或确认兼容。

报告条目过时 ↗建议修正翻译 ↗

一手来源

1. readme.md GitHub · RCayre/mirage · 修订 b6cd39e
2. setup.py GitHub · RCayre/mirage · 修订 b6cd39e
3. CHANGELOG.md GitHub · RCayre/mirage · 修订 b6cd39e
4. mirage/__init__.py GitHub · RCayre/mirage · 修订 b6cd39e
5. mirage/modules GitHub · RCayre/mirage · 修订 b6cd39e
6. mirage/modules/ble_discover.py GitHub · RCayre/mirage · 修订 b6cd39e
7. mirage/libs/ble_utils/adb.py GitHub · RCayre/mirage · 修订 b6cd39e
8. mirage/libs/wireless_utils/pcapDevice.py GitHub · RCayre/mirage · 修订 b6cd39e
9. mirage/libs/ble_utils/pcap.py GitHub · RCayre/mirage · 修订 b6cd39e
10. LICENSE.txt GitHub · RCayre/mirage · 修订 b6cd39e
11. https://hal.science/hal-02346074