Wi-Fi-Phantom - Defensive ESP32-C3 wireless security monitor with

项目说明

Wi-Fi Phantom — ESP32-C3 Wireless Security Monitor

![Firmware Build]()
![Li]()
![Firmware]()

Wi-Fi Phantom is a defensi wireless project. It passively scans nearby 2.4 GHz Wi-Fi networks and presents re obser through a responsi hosted by the board.

> Defensi: the maintained firmware does not disconnect clients, impersonate third-party access points, or collect Wi-Fi credentials.

Quick Links

Features

> A duplicate SSID is not automatically a rogue access point. Mesh systems, extenders and enterprise deployments commonly ad one SSID from multiple BSSIDs. Wi-Fi Phantom reports obser that require context.

Browser Installation

Use Install Wi-Fi Phantom.

1. Connect a compatible ESP32-C3 using a data-capable USB cable.
2. Open the installer in desktop Chrome or Microsoft Edge.
3. Approve the serial device requested by the browser.
4. Install the current firmware and wait for flashing to complete.
5. Restart the board.

After Installation

1. Connect to Wi-Fi-Phantom-Monitor.
2. Use password phantomsecure.
3. Open Device Dashboard.
4. Press Scan now for a fresh obser.

Dashboard Data

| Field | Meaning |
| --- | --- |
| SSID | Ad network name |
| BSSID | Access-point MAC address |
| Channel | Observed 2.4 GHz channel |
| RSSI | Obser strength |
| Security | Ad Wi-Fi security mode |
| Obser | Open, duplicate SSID, changed properties, or normal obser |

Build from Source

Requirements: Python 3, PlatformIO and a compatible ESP32-C3 board.

Upload through PlatformIO:

Project Structure

Architecture

Automated Firmware Pipeline

Each relevant push to main compiles the ESP32-C3 project, creates a browser-installable merged firmware image, uploads a build artifact, updates the firmware used by the li, and publishes the current GitHub Release.

Safety and Scope

Use Wi-Fi Phantom only with hardware and wireless en you own or are explicitly authorized to assess. The maintained project focuses on , learning and defensi rather than disruption or credential collection.

See SECURITY.md for responsible-use guidance.

USB Driver Note

USB-UART support depends on the bridge used by your board. Install the official dri by the board or USB-bridge manufacturer instead of keeping third-party dri in this repository.

Roadmap

License

Released under the MIT License.

Maintainer

Tanzeel Hussain · GitHub Profile

项目信息

开发语言：C++

Star 数：1

技术要点

该项目属于防护思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Defensive ESP32-C3 wireless security monitor with passive Wi-Fi scanning, network observations, local dashboard, browser firmware installer and automated builds.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。