Abdullah-XDev/wifi-credentials-grabber

# 带 OLED 显示屏的 WiFi 凭据抓取器 一个适用于配备 SH1106 OLED 显示屏的 ESP32-S3 的 captive portal 钓鱼工具，通过伪装合法的 WiFi 网络来抓取凭据。 ## 功能 - 扫描并显示可用的 WiFi 网络 - 为选定的网络创建邪恶双子接入点 - 通过伪造的认证页面捕获 WiFi 密码 - 在 SH1106 OLED (128x64) 上实时显示 - 显示选定的网络、最后捕获的密码以及最后连接的 SSID - 基于 Web 的管理界面 - 每 15 秒自动重新扫描网络 ## 硬件要求 - ESP32-S3 开发板 - SH1106 OLED 显示屏 (128x64, I2C) - 杜邦线 ## 引脚连接 | OLED 引脚 | ESP32-S3 引脚 | |----------|--------------| | SDA | GPIO 8 | | SCL | GPIO 9 | | VCC | 3.3V | | GND | GND | ## 软件要求 - Arduino IDE 或 PlatformIO - 所需库： - WiFi.h - DNSServer.h - WebServer.h - U8g2lib.h ## 安装说明 1. 克隆此仓库： ``` git clone https://github.com/Abdullah-XDev/wifi-credentials-grabber.git ``` ``` 2 Install required libraries in Arduino IDE: ◦ Sketch → Include Library → Manage Libraries ◦ Search and install "U8g2" by Oliver 3 Select board: ESP32S3 Dev Module 4 Update I2C pins in the code if needed: ``` cpp #define OLED_SDA 8 #define OLED_SCL 9 ## 5 将代码上传到你的 ESP32-S3 ## 使用方法 ``` 1 Power up the ESP32-S3 2 Connect to the "XDev" WiFi network (password: 12345678) 3 Open browser and navigate to 192.168.4.1 4 Select target network from the list 5 Click "Start EvilTwin" to create a fake AP 6 Victims connecting to the fake AP will see a password prompt 7 Captured passwords appear on both OLED display and web interface ``` ## OLED 显示信息 ## OLED 屏幕会显示： ``` • Selected AP: Currently targeted network • Last Password: Most recently captured password • Last Connected: SSID of the last successful authentication ``` ## Web 界面功能 ``` • List of available WiFi networks • Select target network button • Start/Stop Evil Twin toggle • Real-time captured password display ``` ## 安全警告 ## ⚠️ 重要提示：此工具仅供教育目的和授权的安全测试使用。未经授权对你不拥有或未获准测试的网络使用本工具是违法行为。 ## 工作原理 ``` 1 Network Scanning: Device scans for nearby WiFi networks 2 Evil Twin Creation: Creates a fake AP with selected SSID 3 Captive Portal: Redirects victims to fake authentication page 4 Credential Capture: Saves entered passwords 5 Verification: Attempts to verify credentials with real network 6 Display Update: Shows captured data on OLED screen ``` ## 故障排除 ## OLED 无法工作： ``` • Check I2C connections • Verify correct pins (SDA=8, SCL=9) • Try different I2C addresses ``` ## 无法连接到 “XDev”： ``` • Ensure ESP32 is powered • Check serial output for debug messages • Reset the device ``` ## 没有显示网络： ``` • Ensure WiFi antenna is connected • Move closer to WiFi sources • Check serial monitor for scan results ``` ## 免责声明 本软件仅供教育目的提供。作者对任何滥用或由本程序造成的损害概不负责。在测试网络之前，请务必获得适当的授权。 ## 作者 Abdullah-XDev ## 版本 1.0.0

标签：Arduino, ESP32-S3, EvilTwin(邪恶双子), IoT安全, Object Callbacks, PlatformIO, SH1106 OLED, SSID欺骗, U8g2库, UML, Web管理界面, WiFi凭证窃取, 中间人攻击, 密码抓取, 强制网络门户, 硬件黑客, 网络钓鱼