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 编写的内核，高效处理位置服务请求。