izagoto/wall-of-flippers

GitHub: izagoto/wall-of-flippers

一款用于发现 Flipper Zero 设备并检测蓝牙低功耗广告攻击的安全监测工具。

Stars: 0 | Forks: 0

Wall of Flippers

🐬 A simple and easy way to find Flipper Zero Devices and Bluetooth Low Energy Based Attacks 🐬

🐬 Local project documentation for BLE monitoring and analysis 🐬

Project Maintainer

Contributor

Discord Shield

🐬 目录

- [简介](#doc_introduction) - [功能](#doc_features) - [视频](#doc_videos) - [安装指南](#doc_install) - [如何安装](#install_guides) - [Debian Linux 安装](#debian_install) - [Fedora 安装](#fedora_install) - [macOS 安装](#macos_install) - [Arch Linux 安装(即将推出)](#arch_install) - [Windows 安装](#windows_install) - [运行后端和前端](#run_backend_frontend) - [无头模式使用](#headless_usage) - [运行时配置](#runtime_config) - [架构](#architecture) - [问题与修复](#doc_issues_and_fixes) - [常见错误与修复](#doc_c_and_e) - [相关项目](#doc_related) - [通知](#doc_statement)

# 🐬 Wall of Flippers 是什么? # 🐬 当前功能与未来更新 - [x] 发现 Flipper Zero 设备(必须启用 Bluetooth) - [x] 发现 Flipper 名称 - [x] 发现 Flipper 地址 - [x] 发现 Flipper “标识符”(透明、白色和黑色 Flipper 检测) - [ ] 欺骗检测(即将推出) - [x] 能够存档过去发现的 flipper zero 设备 - [x] 支持 Debian Linux 和 Windows 的自动安装功能 - [x] 能够识别潜在的 Bluetooth Advertisement 攻击 - [x] 疑似 Advertisement 攻击 - [x] ~iOS 崩溃 Advertisement 攻击~ - [x] iOS 弹窗 Advertisement 攻击 - [x] Samsung 和 Android BLE Advertisement 攻击 - [x] Windows Swift Pair Advertisement 攻击 - [x] LoveSpouse Advertisement 攻击(拒绝快乐/Denial of Pleasure) - [x] BT 设置泛洪 - [x] Bluetooth 遥控器检测 - [x] BLE 广告商(检测其他 WoF 实例) - [x] 自定义名称实现 - [x] BLE 聊天 - [x] 徽章模式(较少花哨的统计数据) - [x] 支持 BLE 外部/内部适配器 - [x] 支持 Linux - [ ] 支持 Windows - [x] 速率限制(新连接) - [x] 支持 Linux - [x] 支持 Windows(受限) - [x] 通过 JSON 配置运行时扫描和离线阈值 - [ ] 支持 Chromium Web Bluetooth - [ ] iOS/Android 检测(配对) - [ ] 动画(正在寻找 ASCII 艺术家) # 🐬 文章

Talking Sasquach - Wall of Flippers Busts Flipper Zero BLE Spammers Red Handed!

BleepingComputer - ‘Wall of Flippers’ detects Flipper Zero Bluetooth spam attacks

# 🐬 安装与要求 ## 如何安装 # 🐬 运行后端和前端 ## 运行后端 ``` python3 -m venv .venv source .venv/bin/activate python3 -m pip install -r requirements.txt python3 run_web.py ``` 后端默认地址: `http://127.0.0.1:8787` 要从局域网中的其他设备访问: ``` python3 run_web.py --host 0.0.0.0 --port 8787 ``` ## 运行前端 ``` cd web-frontend npm install npm run dev ``` 前端默认地址: `http://127.0.0.1:5173`
Debian Linux 安装指南 ### Debian Linux 安装指南 ### 第一步:完整的系统升级/更新 ``` sudo apt-get update && sudo apt-get upgrade -y ``` ### 第二步:Git Clone 和 Git 安装 ``` sudo apt-get install git cd /path/to/Wall-of-Flippers ``` ### 第三步:安装 python (python3) ``` sudo apt-get install python3 ``` sudo apt-get install python3-dev ### 第四步:设置并安装所需的包(多种方式) ``` sudo apt-get install libglib2.0-dev ``` sudo apt-get install python3-bluez python3 -m venv .venv source .venv/bin/activate ################## PACKAGES ######################## # requirement.txt method python3 -m pip install -r requirements.txt # command method python3 -m pip install bluepy python3 -m pip install pybluez ################## PACKAGES ######################## deactivate ``` bash wof.sh # 启动时您应该会看到一个关于设置托管环境的提示,您可以放心让它为您完成。然后,一旦环境准备就绪,再次运行 `wof.sh` and use the auto install option to install the dependencies. ``` ### 第五步:运行 Wall of Flippers ``` bash wof.sh ``` ``` sudo chmod +x WallofFlippers.py ./WallofFlippers.py ```
Fedora Linux 安装指南 ### Fedora 安装指南 ### 第一步:完整的系统升级/更新 ``` sudo dnf update && sudo dnf upgrade -y ``` ### 第二步:Git Clone 和 Git 安装 ``` sudo dnf install git cd /path/to/Wall-of-Flippers ``` ### 第三步:安装 python (python3) ``` sudo dnf install python3 ``` sudo dnf install python3-dev ### 第四步:设置并安装所需的包(多种方式) ``` sudo dnf install glib2-devel ``` sudo dnf install python3-bluez python3 -m venv .venv source .venv/bin/activate ################## PACKAGES ######################## # requirement.txt method python3 -m pip install -r requirements.txt # command method python3 -m pip install bluepy python3 -m pip install pybluez ################## PACKAGES ######################## deactivate ``` bash wof.sh # 启动时您应该会看到一个关于设置托管环境的提示,您可以放心让它为您完成。然后,一旦环境准备就绪,再次运行 `wof.sh` and use the auto install option to install the dependencies. ``` ### 第五步:运行 Wall of Flippers ``` bash wof.sh ``` ``` sudo chmod +x WallofFlippers.py ./WallofFlippers.py ```
macOS 安装指南 ## macOS 安装指南 ### 第一步:创建并激活虚拟环境 ``` python3 -m venv .venv source .venv/bin/activate ``` ### 第二步:安装依赖 ``` python3 -m pip install -r requirements.txt ``` ### 第三步:运行 Wall of Flippers ``` python WallofFlippers.py --wall ```
Windows 安装指南 ## Windows 安装指南 ### 第一步:Git Clone 和 Git 安装 ``` Download Link: https://git-scm.com/downloads ``` ``` cd /path/to/Wall-of-Flippers ``` ### 第二步:安装 python 和 pip (python / pip) ``` Download Link: https://www.python.org/downloads/ ``` ``` pip install bleak ``` ``` pip install -r requirements.txt ``` ``` python WallofFlippers.py # 启动时您应该会看到一个提示,使用自动安装选项来安装依赖项。选择 easy install,并按照安装的指示和提示进行操作。 ``` ### 第三步:运行 Wall of Flippers ``` python WallofFlippers.py ```
# 无头模式使用 ``` usage: WalloFlippers.py [-h] [-w] [i] [-d DEVICE] options: -h, --help Help Message -w, --wall Wall of Flippers -i, --install Install Dependencies -b, --badgemode Toggle Badge Mode -a, --advertise Advertise WoF Exsistance (OFF=Default) -d DEVICE, --device DEVICE A bluetooth device (External/Internal) ``` # 问题与修复 # 常见错误与修复 ### 没有那个文件或目录 /sys/class/bluetooth ``` sudo service bluetooth status ``` ``` sudo service bluetooth restart ``` ### pybluez 未能正确安装 # 相关项目 **Pwnagotchi 插件**\ _作者: cyberartemio_\ wof-pwnagotchi-plugin **Evil-M5Core2**\ _作者: 7h30th3r0n3_\ Evil-M5Core2 # 通知 # 🐬 运行时配置 现在可以从以下位置调整运行时设置: `config/wof.defaults.json` 或者使用自定义文件: ``` python WallofFlippers.py --wall --config /path/to/custom.json ``` 可以修改的参数示例: - `bleak_scan_timeout` - `offline_miss_threshold` - `offline_hold_seconds` - `ble_tx_power_dbm` - `ble_path_loss_n` - `rssi_history_max_points` - `rssi_history_max_devices` - `max_online` - `max_offline` - `ble_threshold` 用于自动化/调试的结构化事件也可以启用: ``` python WallofFlippers.py --wall --jsonl ``` 事件示例: - `startup` - `scan_started` - `scan_completed` - `device_seen_strong` - `device_seen_soft` - `device_online` - `device_offline` # 🐬 架构 此工作区中自定义的项目结构现在更加模块化: - `WallofFlippers.py` CLI 入口点和应用程序主循环。 - `utils/wof_engine.py` 一个实时扫描周期的编排。 - `utils/wof_scanner.py` macOS/Linux 的 BLE 扫描抽象。 - `utils/wof_detection.py` 数据包解析和 Flipper 分类。 - `utils/wof_presence.py` 在线/离线状态机以及 `missed_scans`。 - `utils/wof_storage.py` SQLite 存储和本地扫描器的位置元数据。 - `utils/wof_library.py` 用于 ASCII 渲染、终端选择和轻量级持久化日志记录的辅助/UI 层。 - `utils/wof_display.py` 实时渲染终端仪表盘。 - `utils/wof_trust.py` 检测信任评分。 - `utils/wof_rssi_geo.py` 根据 RSSI 进行粗略的距离估算。 - `utils/wof_rssi_history.py` 每个设备的 RSSI 趋势历史。 - `utils/wof_config.py` 加载 JSON 运行时配置。 - `utils/wof_events.py` 用于自动化/调试的结构化事件发送。 - `utils/wof_logging.py` 记录文件日志到 `logs/wof.log`。 主要的运行时存储现在使用: `data/flippers.db`
标签:BLE攻击, Flipper Zero, 主机安全, 密码管理, 数据可视化, 暗色界面, 流量监控, 蓝牙, 设备发现, 逆向工具