MozStumbler完整指南：Mozilla开源WiFi嗅探工具如何众包构建全球定位数据库

MozStumbler完整指南：Mozilla开源WiFi嗅探工具如何众包构建全球定位数据库

【免费下载链接】MozStumblerAndroid Stumbler for Mozilla项目地址: https://gitcode.com/gh_mirrors/mo/MozStumbler

MozStumbler 是 Mozilla 开发的开源 AndroidWiFi嗅探工具，它会持续扫描周围的 WiFi 网络、蜂窝基站与 GPS 位置，把这份"位置指纹"数据众包上传到Mozilla 定位服务（MLS），最终汇聚成全球开放定位数据库。本文将从工作原理、项目架构到源码构建，带你 5 分钟完整上手这款经典的 WiFi 扫描神器。

⚠️状态提示：Mozilla 已于 2021 年 2 月 8 日正式停止运营 MozStumbler，代码仍可在 Android 9 上运行，但不支持 Android 10 及以上。相关说明见 README.md。

📡 什么是MozStumbler：WiFi定位众包原理

定位 App 想精准找到你，除了 GPS 还需要 WiFi 定位——原理很简单：

1. 你的手机被动嗅探周围的 WiFi 热点（BSSID）、蜂窝基站和 GPS 坐标；
2. 这些数据被打包上传到 Mozilla 定位服务；
3. 全球用户贡献的数据不断累积，形成一张"哪个位置附近有哪些 WiFi"的指纹地图；
4. 当新设备出现在某处时，通过匹配附近 WiFi 即可快速推算位置——无需等待缓慢的 GPS 冷启动。

这就是众包的力量：每个普通用户随手贡献的数据，都在让全球定位数据库变得更精准。

🔍 核心工作机理：4类扫描器 + 运动感应

MozStumbler 的核心是一个常驻后台服务，由以下组件协同工作：

💡 一个巧妙的设计是 ScanManager.java#L36 中定义的三种状态：STOPPED（已停止）、STARTED（扫描中）、STARTED_BUT_PAUSED_MOTIONLESS（已启动但检测到用户静止而暂停）——扫描器知道"人没动就不用重复扫"，大幅降低电量消耗。

🏗️ 项目架构：一图看懂代码组织

MozStumbler/ ├── android/ # Android 应用层（地图界面、设置、日志） ├── libraries/stumbler/ # 核心扫描引擎（本文重点） │ └── src/main/java/org/mozilla/mozstumbler/service/ │ ├── stumblerthread/ # 扫描线程：扫描器、数据存储、运动检测 │ ├── uploadthread/ # 上传线程：异步批量上报 │ └── core/http/ # 与 Mozilla 定位服务通信的 HTTP 客户端 ├── Makefile # 一键构建入口 └── test.sh # 单元测试脚本

数据存储由 DataStorageManager.java 负责，把每次观测（Observation）持久化为 JSON 行；而WiFi 黑名单（blocklist 目录）则用来过滤掉无意义的热点（比如运营商公共 AP）。

🛠️ 构建与运行：Android Studio最快配置方法

第 1 步：获取源码

git clone https://gitcode.com/gh_mirrors/mo/MozStumbler

第 2 步：命令行构建（构建系统会自动下载所需的 Android SDK 组件）

make

第 3 步：用 Android Studio 配置运行，共三步：

① 打开顶部菜单栏Run → Edit Configurations...：

② 在弹窗中点击+，选择Android Application新建配置：

③ 关键设置（这是最容易踩坑的一步）：

• 将Installation Options中的 Deploy 设为Nothing；
• 添加两个Gradle-Aware Make任务：:android:assembleGithubDebug和:android:installGithubDebug。

配置完成后，直接点 Run，即可在真机/模拟器上跑起这个 WiFi 嗅探工具。

☁️ 数据上传：嗅探数据如何汇入全球定位数据库

扫描产生的观测点并非实时发送，而是走一套高效的异步批量上传流程：

1. 观测数据先落盘（DataStorageManager.java）；
2. AsyncUploader.java 在独立上传线程中分批压缩并发送；
3. 上报目标由 MLSLocationService.java 完成与 Mozilla 定位服务的 HTTPS 通信。

上报节奏在 StumblerService.java#L50 中有明确定义：主动模式每 5 分钟上报一次，被动模式则设有 5 分钟的频率保护，避免频繁唤醒网络模块。

📚 开发者进阶：测试与模拟模式

• 单元测试基于Robolectric在 JVM 中高速运行（秒级而非分钟级），详细机制见 docs/testing.md；
• 一行脚本跑测试：test.sh，例如./test.sh UpdaterTest.testUpdater；
• 模拟模式（Simulation Mode）：在开发者选项中开启后，会看到 1 个蜂窝、2 个 WiFi 固定不变，位置缓慢向东北移动——无需真机走街串巷即可观察整个流水线。

📝 总结

MozStumbler 虽已退役，但它展示的"手机众包 + WiFi 嗅探 + 运动感应省电 + 批量异步上传"架构，依然是理解 WiFi 定位数据库工作原理的最佳教材。如果你正在学习 Android 后台服务、定位与数据上报，这份完整源码值得精读。

【免费下载链接】MozStumblerAndroid Stumbler for Mozilla项目地址: https://gitcode.com/gh_mirrors/mo/MozStumbler