WaveDigger

Исследуйте беспроводные сигналы, чтобы определить их физическое местоположение. WaveDigger помогает находить точки доступа Wi-Fi по их BSSID (MAC-адресу) и сотовые вышки (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 построен на их исследованиях и обратной разработке API служб геолокации Apple. В частности, мы используем:

• Их определения protobuf для WLOC API Apple
• Документацию конечных точек API и форматов запросов/ответов
• Понимание кодирования координат и поведения API
• Префикс начальных байтов, необходимый для корректных запросов

Их работа по изучению и документированию недокументированных служб геолокации Apple сделала возможным существование таких проектов, как WaveDigger. Пожалуйста, ознакомьтесь с их репозиторием для оригинального исследования и дополнительных инструментов для работы со службами геолокации Apple.

Начало работы

Предварительные требования

• Node.js 24+ и npm

Установка

1. Установите зависимости:

npm install

1. (Необязательно) Добавьте токен Mapbox для улучшенных картографических тайлов:
   • Получите токен на Mapbox
   • Добавьте его в .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: Маршруты API Next.js

Настоящий Apple WLOC API

Приложение использует настоящий Apple WLOC API для запроса местоположений по BSSID. Эта реализация основана на исследованиях и определениях protobuf из проекта apple-corelocation-experiments.

Реализация API:

• Использует protobuf для связи с серверами Apple
• Отправляет запросы на https://gs-loc.apple.com/clls/wloc
• Обрабатывает преобразование координат (Apple использует int64 с 8 знаками после запятой)
• Поддерживает как стандартные конечные точки, так и конечные точки для региона Китая

Тестирование с реальными BSSID

Чтобы протестировать приложение:

1. Найдите реальный BSSID Wi-Fi (MAC-адрес) вашего роутера или точки доступа
2. Введите его в любом поддерживаемом формате
3. Приложение запросит базу данных Apple и покажет местоположение, если оно найдено

Примечание: Не все BSSID присутствуют в базе данных Apple. Недавно развёрнутые или частные точки доступа могут не иметь данных о местоположении.

План развития возможностей

• Экспорт результатов: Скачивание результатов поиска в формате JSON/CSV
• Просмотр кластера TAC: Просмотр всех вышек в TAC без необходимости указывать конкретный Cell ID или NCI

Лицензия

WaveDigger распространяется под лицензией GNU Affero General Public License v3.0. Если вы запускаете модифицированную версию этого программного обеспечения в качестве сетевого сервиса, AGPL требует, чтобы вы предоставили пользователям этого сервиса доступ к вашему модифицированному исходному коду.