xweiba/location-spoofer

解決的問題

Location Spoofer 是一個專為 iOS 位置服務研究、軟體開發測試與 QA 驗證設計的框架。它允許開發者在不修改目標應用程式原始碼的情況下，模擬不同的地理位置與定位情境，幫助他們驗證應用程式在各種全球位置下的行為表現。

工作原理

此專案使用代理層來攔截並修改 Apple 位置服務的回應。提供兩種不同的運作模式：

• APP 模式：在裝置內部執行一個本地的 Go 編寫代理。使用者需為目前的 Wi-Fi 網路設定手動 HTTP 代理，並信任本地 CA 證書。此模式僅涵蓋 Wi-Fi 網路。
• 第三方代理模式：應用程式作為控制器，在地圖上選擇座標並同步至支援的第三方代理客戶端（如 Shadowrocket、Surge 或 Quantumult X）。第三方客戶端隨後負責執行 MITM（中間人）攔截，並將座標注入到位置服務回應中。

適用對象

此工具主要面向 iOS 開發者、QA 工程師以及研究 iOS 位置服務的研究人員。

特色亮點

• 原生地圖互動：使用 MapKit 實現直覺的座標選擇、搜尋與收藏常用位置功能。
• 座標管理：支援 WGS-84（國際標準）與 GCJ-02（中國地圖標準），防止位置偏移。
• 非侵入式：無需修改目標應用程式原始碼，且在 APP 模式下無需使用 VPN。
• 環境診斷：內建工具可偵測代理狀態、憑證信任狀態，並提供請求連結以協助排除設定問題。
• Go 基礎代理：採用 Go 編寫的核心，高效處理位置服務請求。