一个用于 Android 的被动式 Wi-Fi + 蓝牙低功耗(BLE)观察器。 TrackEm 监听附近设备已经在广播的内容——Wi-Fi 探测请求、 BLE 广播以及可见的接入点——并将其转化为对你周围无线电信号的实时、可筛选的 清单。专为无线研究、射频现场勘测、 红队侦察以及 OSINT 工作而构建,在这些场景中你希望的是观察而非干扰。
TrackEm 从不发送 Wi-Fi 或蓝牙帧。 它是一个观察者:不发送探测 请求,不发送关联帧,不发送解除认证帧,不进行帧注入。参见 TrackEm 不做什么。
包名:com.veteranop.trackem · 许可证:MIT · Android 7.0+(API 24)
TrackEm 从主屏幕运行三种扫描模式:
| 模式 | 观察内容 | 典型用途 |
|---|---|---|
| 移动设备 | 来自手机、笔记本电脑、手表、IoT 设备的 Wi-Fi 探测请求以及 BLE 广播 | 存在检测、设备计数、探测请求研究 |
| 蓝牙低功耗 | 仅 BLE 广播者(无需 Wi-Fi 无线电) | 信标 / 追踪器 / BLE 设备勘测 |
| Wi-Fi 接入点 | 可见的 AP(SSID、BSSID、RSSI),以及平台报告的相关联客户端 | 现场勘测、流氓 AP 搜寻 |
api.maclookup.app)
以及可选的 WiGLE 查询——两者都只发送 MAC/BSSID,别无其他。关于分析,如实说明: 如果你提供自己的
app/google-services.json, Firebase Analytics 会记录三个应用级事件——app_opened、start_scan(附带 扫描模式)以及device_renamed(仅附带一个布尔值,绝不包含 MAC)。不会发送任何 被观察设备的标识符。没有该文件时,应用会在禁用分析的情况下构建并运行: 这些调用是可空的,因此缺失 Firebase 配置绝不会导致启动崩溃。
这一点对许可和预期都很重要,因此明确说明:
WifiManager.startScan()),这给了安静
设备另一次出现在下一个扫描窗口中的机会。该按钮标记为
FORCE WI-FI RESCAN (10x),它所做的仅此而已——十次重新扫描。api.maclookup.app 发起外部 HTTPS 调用。
关于它所观察的设备,任何信息都不会被发送到任何地方。如果你需要进行主动无线测试,请使用专用硬件和工具(并先获得该网络的书面授权)。
| 权限 | 用途 |
|---|---|
ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION | Android 要求应用在获取 Wi-Fi 扫描结果或 BLE 扫描结果之前必须拥有位置权限。这是操作系统的要求,而非 TrackEm 的偏好。 |
ACCESS_BACKGROUND_LOCATION | 可选——仅当你希望应用在后台运行时继续扫描时才需要。 |
BLUETOOTH_SCAN(neverForLocation)/ BLUETOOTH_CONNECT | BLE 扫描以及连接外设。 |
ACCESS_WIFI_STATE / CHANGE_WIFI_STATE | 读取扫描结果;触发 Wi-Fi 重新扫描。 |
INTERNET / ACCESS_NETWORK_STATE | 厂商查询(maclookup.app)以及可选的 WiGLE 查询。 |
位置信息用于解析扫描结果,以及(如果你使用狩猎/地图模式)将采样点放置在地图上。TrackEm 不会在设备之外的任何地方存储位置历史记录。
要求:Android Studio(或仅需 SDK + JDK 17)、Android SDK 平台 34。
git clone https://github.com/veteranop/trackem.git
cd trackem
maclookup.app 的 API 密钥不在本仓库中(它曾在早期提交中被硬编码,
此后已被轮换并从历史记录中清除)。请提供你自己的密钥——可以放在
local.properties 中(已被 gitignore 忽略):
sdk.dir=/path/to/Android/Sdk
MACLOOKUP_API_KEY=your-key-from-maclookup.app
…或在 CI 环境中:
export MACLOOKUP_API_KEY=...
该值通过 BuildConfig.MACLOOKUP_API_KEY 注入。即使未设置密钥,应用仍可构建并运行——只是会跳过厂商查询。
app/google-services.json 已被 gitignore,因为它包含 Firebase API 密钥。如果你需要 Firebase Analytics,请在 Firebase 控制台中为包名 com.veteranop.trackem 创建你自己的 Android 应用条目,并将生成的 google-services.json 放入 app/。如果没有该文件,则不会应用 Google Services Gradle 插件,应用将在没有 Firebase 的情况下构建。
./gradlew :app:assembleDebug # debug APK
./gradlew :app:test # JVM unit tests
使用 adb install -r app/build/outputs/apk/debug/app-debug.apk 安装调试版本。
要安装旧版本? 应用 ID 现在是
com.veteranop.trackem(之前是com.example.trackemmobile),因此它会与旧副本并存安装,而不是 替换它。请卸载旧版本以避免混淆。
本仓库历史上有两个凭据曾引发问题;现在两者都采用相同方式处理:
| 密钥 | 现在所在位置 |
|---|---|
MACLOOKUP_API_KEY | local.properties / CI secret → BuildConfig.MACLOOKUP_API_KEY |
| Firebase API key | app/google-services.json,已被 gitignore,按开发者/CI 生成 |
.gitignore 会阻止 google-services.json、.kotlin/、.gradle/、*.apk/*.aab 以及
密钥库。如果你 fork 此仓库,请为你自己的使用轮换这两个密钥——旧值
曾公开,必须视为已泄露。
请注意,BuildConfig 字段并不是保险库:它会被编译进 APK,并且可以被
提取。对于有速率限制的 MAC 查询密钥来说,这是可接受的权衡;不要在那里放置
任何高价值内容。
app/src/main/java/com/veteranop/trackem/
├── MainActivity.kt scan modes, device lists, API-key menu
├── DeviceScanner.kt Wi-Fi + BLE scanning, fingerprinting, vendor lookup
├── DetailActivity.kt single-device view, rescan, BLE connect
├── MapActivity.kt Wi-Fi AP map (WiGLE)
├── DeviceFingerprint.kt device model + RHID grouping
├── ui/hunting/ hunting mode (Compose + Maps)
└── utils/, data/ location helper, RSSI samples
监听无线电通信的监管因地区而异,在未经他人同意的情况下对他人使用此类工具,即使你只是被动监听,也可能构成违法。TrackEm 的发布用途为研究、教育、站点勘察以及经授权的安全测试。你有责任确保自己拥有从事相关行为的权限。作者对任何滥用行为不承担任何责任——详见 LICENSE。
MIT——详见 LICENSE。