
패시브 장치 추적기 (Android)TrackEm Mobile은 OSINT, 레드팀 작전 및 무선 연구를 위해 설계된 실시간 패시브 Wi-Fi + Bluetooth LE 프로브 요청 스캐너입니다. Wi-Fi 네트워크 이름을 능동적으로 브로드캐스트하는 클라이언트 기기(휴대폰, 노트북, IoT)를 수신합니다.
Android용 수동 Wi-Fi + Bluetooth LE 관찰기. TrackEm은 주변 기기가 이미 브로드캐스트하고 있는 것 — Wi-Fi 프로브 요청, BLE 광고, 가시적인 액세스 포인트 — 을 수신하여 주변 무선 기기의 실시간 필터링 가능한 인벤토리로 변환합니다. 간섭하기보다는 관찰하고자 하는 무선 연구, RF 사이트 서베이, 레드팀 정찰, OSINT 작업을 위해 만들어졌습니다.
TrackEm은 Wi-Fi 또는 Bluetooth 프레임을 절대 전송하지 않습니다. 이는 관찰기입니다: 프로브 요청도, 연관 프레임도, 디인증도, 프레임 주입도 없습니다. TrackEm이 하지 않는 것을 참조하세요.
패키지: com.veteranop.trackem · 라이선스: MIT · Android 7.0+ (API 24)
TrackEm은 홈 화면에서 세 가지 스캔 모드를 실행합니다:
| 모드 | 관찰 대상 | 일반적 용도 |
|---|---|---|
| 모바일 기기 | 휴대폰, 노트북, 시계, IoT 기기의 Wi-Fi 프로브 요청 및 BLE 광고 | 존재 감지, 기기 수 집계, 프로브 요청 연구 |
| Bluetooth LE | 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은 절대 아님) — 를 기록합니다. 관찰된 기기의 식별자는 전송되지 않습니다. 해당 파일이 없으면 앱은 분석이 비활성화된 상태로 빌드 및 실행됩니다: 호출이 nullable이므로 Firebase 구성이 없어도 시작 시 충돌이 발생하지 않습니다.
이는 라이선스와 기대치 모두에 중요하므로 명확히 밝힙니다:
WifiManager.startScan())으로, 조용한 기기가
다음 스캔 윈도우에 나타날 또 한 번의 기회를 줍니다. 해당 버튼은
FORCE WI-FI RESCAN (10x) 로 표시되며, 그것이 전부입니다 — 열 번의 재스캔.api.maclookup.app으로 외부 HTTPS 호출을 합니다. 관찰하는 기기에 대한 정보는 어디에도
전송되지 않습니다.능동 무선 테스트가 필요하다면 전용 하드웨어와 도구를 사용하세요(그리고 먼저 네트워크에 대한 서면 승인을 받으세요).
| 권한 | 이유 |
|---|---|
ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION | Android는 앱에 Wi-Fi 스캔 결과나 BLE 스캔 결과를 제공하기 전에 위치 권한을 요구합니다. 이는 OS 요구 사항이며 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은 Firebase API 키를 포함하고 있기 때문에 gitignore 처리되어 있습니다. 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 시크릿 → BuildConfig.MACLOOKUP_API_KEY |
| Firebase API 키 | app/google-services.json, gitignore 처리됨, 개발자/CI별로 생성 |
.gitignore는 google-services.json, .kotlin/, .gradle/, *.apk/*.aab, 그리고
키스토어를 차단합니다. 이 저장소를 포크한다면, 두 키 모두 본인 용도로 교체(rotate)하세요 — 이전 값들은
공개되었으므로 이미 유출된 것으로 간주해야 합니다.
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를 참조하십시오.