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

설치

의존성 설치:

npm install

(선택 사항) 향상된 지도 타일을 위한 Mapbox 토큰 추가:
- Mapbox에서 토큰을 발급받습니다
- .env.local에 추가합니다:
```
NEXT_PUBLIC_MAPBOX_TOKEN=your_token_here
```

개발 서버 실행

npm run dev

http://localhost:3000을 열어 애플리케이션을 확인합니다.

기술 세부 사항

아키텍처

프론트엔드: TypeScript를 사용한 Next.js 15
지도 시각화: react-map-gl을 사용한 deck.gl
스타일링: Tailwind CSS
API: Next.js API 라우트

실제 Apple WLOC API

이 애플리케이션은 Apple의 실제 WLOC API를 사용하여 BSSID 위치를 조회합니다. 이 구현은 apple-corelocation-experiments 프로젝트의 연구와 protobuf 정의를 기반으로 합니다.

API 구현:

Apple 서버와의 통신에 protobuf를 사용합니다
https://gs-loc.apple.com/clls/wloc로 요청을 보냅니다
좌표 변환을 처리합니다 (Apple은 소수점 8자리의 int64를 사용)
기본 및 중국 리전 엔드포인트를 모두 지원합니다

실제 BSSID로 테스트하기

앱을 테스트하려면:

라우터나 액세스 포인트에서 실제 Wi-Fi BSSID(MAC 주소)를 찾습니다
지원되는 형식 중 하나로 입력합니다
앱이 Apple의 데이터베이스를 조회하고 발견되면 위치를 표시합니다

참고: 모든 BSSID가 Apple의 데이터베이스에 있는 것은 아닙니다. 새로 배포되었거나 사설 액세스 포인트는 위치 데이터가 없을 수 있습니다.

기능 로드맵

결과 내보내기: 검색 결과를 JSON/CSV로 다운로드
TAC 클러스터 보기: 특정 Cell ID나 NCI 없이도 TAC 내 모든 타워를 탐색

라이선스

WaveDigger는 GNU Affero General Public License v3.0에 따라 라이선스가 부여됩니다. 이 소프트웨어의 수정된 버전을 네트워크 서비스로 운영하는 경우, AGPL은 해당 서비스 사용자에게 수정된 소스 코드를 제공할 것을 요구합니다.

wavedigger

인기