如何快速跑起 ESP8266 WiFi 嗅探器PlatformIO 与 Arduino IDE 双环境编译烧录完全指南【免费下载链接】esp8266-snifferAn easy experiment which uses the ESP8266 wifi module to look for near smartphones around you项目地址: https://gitcode.com/gh_mirrors/es/esp8266-snifferesp8266-sniffer 是一个基于ESP8266 WiFi 模块的轻量级 WiFi 嗅探器实验项目只需一块 nodeMCU 开发板就能监听周围手机持续广播的probe request探测请求公开数据包并在串口终端实时显示设备的 RSSI 信号强度、MAC 地址和正在搜索的 WiFi 网络名SSID。本文是面向新手的一站式部署教程带你在PlatformIO和Arduino IDE两套环境中完成编译与烧录。⚠️使用前必读本项目仅用于学习与教育目的。它只监听公开且未加密、由手机主动连续广播的探测包不涉及任何隐私通信。请务必确认所在国家/地区的法律允许此类行为后再动手。 项目结构与核心文件一览文件作用src/main.cpp唯一核心源码混杂模式监听 数据解析打印platformio.iniPlatformIO 编译配置板子 / 框架 / 串口波特率lib/readme.txt私有库目录说明doc/capture.jpg串口输出效果截图README.md项目英文说明文档 嗅探原理 60 秒速览你的手机为了更快连回以前连过的 WiFi会不断向空中发送probe request管理帧子类型 0x04其中包含你的唯一 MAC 地址和搜索过的网络名——这些信息对任何监听者都可见。本项目的做法见 src/main.cpp 中的setup()函数非常简洁通过wifi_promiscuous_enable(ENABLE)把 WiFi 芯片切到混杂监听模式注册sniffer_callback回调每收到一个 802.11 帧就过滤出 probe request通过定时器每秒在1~13 信道之间轮询跳频扩大覆盖范围将 RSSI、信道、对端 MAC、SSID 打印到串口115200 波特率。也就是说全程零代码改动就能直接跑起来。 硬件与工具准备硬件一块 ESP8266 开发板推荐nodeMCU devkit自带 USB 转串口芯片即插即烧免额外驱动板软件二选一即可PlatformIO Visual Studio Code 插件本文推荐Arduino IDE ESP8266 板卡包。 部署方式一PlatformIO 三步走最快第 1 步获取项目代码如果通过 clone 获取仓库地址为 https://gitcode.com/gh_mirrors/es/esp8266-sniffer 克隆后用 VS Code 打开项目根目录。第 2 步确认编译配置打开 platformio.ini关键配置只有 4 行[env:nodemcuv2] platform espressif8266 board nodemcuv2 framework arduino monitor_speed 115200如果你的开发板不是 nodeMCU 2.0把board改成对应的 PlatformIO 板子名即可。第 3 步一键编译 烧录点击底部状态栏的Platform: Build编译点击Platform: Upload烧录若未选对端口点下拉选择设备点击 串口监视器Platform: Monitor波特率自动读为115200。️ 部署方式二Arduino IDE 手动配置打开文件 → 首选项在「附加开发板管理器网址」中加入http://arduino.esp8266.com/stable/release/2.3.0/package_esp8266com_index.json工具 → 开发板 → 开发板管理器搜索esp8266并安装约 100 MB耐心等待工具 → 开发板选择NodeMCU 2.0新建草图将 src/main.cpp 的全部内容粘贴进去showMetadata、sniffer_callback等函数已在文件内声明无需拆分选好工具 → 端口后点击上传再打开串口监视器并把右下角波特率设为115200。 烧录成功看串口里的邻居地图当周围有手机在搜索 WiFi 时监视器会持续滚动类似这样的输出RSSI 值越大表示设备越近RSSI: -77 Peer MAC: f0:27:65:xx:xx:xx:xx SSID: RSSI: -87 Peer MAC: e4:ce:8f:xx:xx:xx:xx SSID: Cheil_Mobile RSSI: -91 Peer MAC: e4:ce:8f:xx:xx:xx:xx SSID: Badoo_Free_Wifi RSSI: -92 Peer MAC: e4:ce:8f:xx:xx:xx:xx SSID: FHR-Guestnet图中每一行就是一次被捕获的探测请求来自 doc/capture.jpg 的实测截图。 新手常见问题排查清单症状可能原因解决办法找不到串口/设备驱动未装或选错端口Linux 用dmesg \| grep tty查设备Windows 装 CH340/CP2102 驱动编译报user_interface.h找不到未正确安装 ESP8266 工具链PlatformIO 重新编译Arduino IDE 重装 2.3.0 板卡包烧录卡住 / 失败未进入下载模式烧录时按一下板子上的 RST 按钮重试监视器全是乱码波特率不对串口监视器确认设为115200一直无输出周围没有 probe request把手机 WiFi 开关快速关/开制造探测包 进阶与延伸阅读想深入看懂数据解析逻辑重点阅读 src/main.cpp 中的showMetadata()与RxControl结构体想加自己的功能如把数据转发到 MQTT在 lib/ 目录下按 lib/readme.txt 说明放置私有库PlatformIO 会自动编译链接英文原版说明与背景资料见 README.md授权条款见 LICENSE。✅ 结语只需1 个源码文件 4 行 ini 配置你就拥有了一个能看见周围手机 WiFi 行为的 ESP8266 嗅探器。先按本文完成 PlatformIO 或 Arduino IDE 双环境之一的部署跑通串口输出再回头精读源码是入门 ESP8266 底层 WiFi 功能性价比最高的路径。动手吧你的串口监视器里正藏着一张实时的数字邻居地图【免费下载链接】esp8266-snifferAn easy experiment which uses the ESP8266 wifi module to look for near smartphones around you项目地址: https://gitcode.com/gh_mirrors/es/esp8266-sniffer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考