WaveDigger

深入挖掘无线信号，发现其物理位置。WaveDigger 帮助你通过 BSSID（MAC 地址）查找 Wi-Fi 接入点，并通过网络参数查找蜂窝基站（LTE 和 5G NR）。使用 Next.js、TypeScript 和 deck.gl 构建，用于交互式地图可视化。

托管版本可在 https://wavedigger.networksurvey.app 找到。

功能

• BSSID 搜索：输入 BSSID 以查找其大致位置
• 输入验证：自动格式化和验证 BSSID 输入
  • 支持格式：AA:BB:CC:DD:EE:FF、AA-BB-CC-DD-EE-FF、AABBCCDDEEFF
• 蜂窝基站搜索：查询 LTE 基站（MCC、MNC、TAC、Cell ID）或 5G NR 基站（MCC、MNC、TAC、NCI）。NR 搜索会返回目标小区以及同一集群中的周围 NR 小区。
• 交互式地图：在 deck.gl 驱动的地图上可视化结果
• 搜索历史：跟踪最近的搜索以便快速访问
• 响应式设计：适用于桌面和移动设备

致谢

🙏 如果没有 apple-corelocation-experiments 团队所做的出色工作，这个项目就不可能实现。

WaveDigger 建立在他们对 Apple 位置服务 API 的研究和逆向工程之上。具体来说，我们使用了：

• 他们为 Apple WLOC API 定义的 protobuf 定义
• API 端点及请求/响应格式的文档
• 对坐标编码和 API 行为的理解
• 有效请求所需的初始字节前缀

他们在理解和记录 Apple 未公开的位置服务方面所做的工作，使得像 WaveDigger 这样的项目得以存在。请查看他们的仓库，了解原始研究以及用于 Apple 位置服务的其他工具。

快速开始

先决条件

• Node.js 24+ 和 npm

安装

1. 安装依赖：

npm install

1. （可选）添加 Mapbox token 以增强地图瓦片：
   • 从 Mapbox 获取 token
   • 将其添加到 .env.local：
   root@kitploit:~

   NEXT_PUBLIC_MAPBOX_TOKEN=your_token_here
   

运行开发服务器

npm run dev

打开 http://localhost:3000 查看应用程序。

技术细节

架构

• 前端：Next.js 15 与 TypeScript
• 地图可视化：deck.gl 与 react-map-gl
• 样式：Tailwind CSS
• API：Next.js API 路由

真实的 Apple WLOC API

该应用程序使用 Apple 的真实 WLOC API 来查询 BSSID 位置。此实现基于 apple-corelocation-experiments 项目的研究和 protobuf 定义。

API 实现：

• 使用 protobuf 与 Apple 服务器通信
• 向 https://gs-loc.apple.com/clls/wloc 发送请求
• 处理坐标转换（Apple 使用带 8 位小数的 int64）
• 支持默认和中国区域端点

使用真实 BSSID 进行测试

测试应用程序：

1. 从你的路由器或接入点获取一个真实的 Wi-Fi BSSID（MAC 地址）
2. 以任何支持的格式输入
3. 应用程序将查询 Apple 的数据库，如果找到则显示位置

注意：并非所有 BSSID 都在 Apple 的数据库中。新部署的或私有接入点可能没有位置数据。

功能路线图

• 导出结果：将搜索结果下载为 JSON/CSV
• TAC 集群视图：无需特定 Cell ID 或 NCI 即可浏览 TAC 中的每个基站

许可证

WaveDigger 根据 GNU Affero 通用公共许可证 v3.0 授权。如果你将修改后的软件版本作为网络服务运行，AGPL 要求你向该服务的用户提供修改后的源代码。