LocationSpoofer

基于 KernelSU + LSPosed 的 Android 系统级虚拟定位与无线环境伪装框架

Android system-level location spoofing and wireless environment simulation framework based on KernelSU + LSPosed

[![License: GPL-3.0](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](LICENSE) [![Android](https://img.shields.io/badge/Android-8.0%2B-green.svg)](https://developer.android.com) [![Kotlin](https://img.shields.io/badge/Kotlin-2.0%2B-purple.svg)](https://kotlinlang.org) [![Compose](https://img.shields.io/badge/Jetpack-Compose-4285F4.svg)](https://developer.android.com/jetpack/compose) [![KernelSU](https://img.shields.io/badge/Root-KernelSU-orange.svg)](https://kernelsu.org) [![LSPosed](https://img.shields.io/badge/LSPosed-API%20101%2B-purple.svg)](https://github.com/LSPosed/LSPosed) [![Telegram](https://img.shields.io/badge/Telegram-交流群-blue.svg)](https://t.me/+CsxZGItXdW40ZWVl) [简体中文](README.md) | [English](README_EN.md)

--- > **📢 加入我们的 [Telegram 交流群](https://t.me/+CsxZGItXdW40ZWVl) 进行**~~技术探讨、催更、~~**吹牛逼、搞抽象。** > > **📖 查看 [LocationSpoofer 详细使用教程](https://docs.google.com/document/d/1fFEz3k7ATdN2dwY1L3RJn1QuzgokIsslNa88-vUPxPk/edit?usp=sharing)** --- ## 项目简介在现代 Android 系统的风控与反作弊环境中，传统的“模拟位置（Mock Location）”开发者选项已被商业 SDK（如高德风控、腾讯安全、百度定位、网易易盾、各类考勤及打卡风控系统）列为高风险特征。这类检测机制不仅验证 `isFromMockProvider` / `isMock` 标志位，还会主动采集并交叉比对设备所处的周围物理环境： * **Wi-Fi 接入点与 BSSID 列表**（比对 Wi-Fi 信号指纹库） * **移动蜂窝基站数据**（GSM / WCDMA / LTE / 5G NR 小区指纹与运营商信息） * **周围 BLE 蓝牙信标** * **底层 GNSS 卫星分布与可见卫星星历** * **加速度计与计步器传感器联动状态** * 对连续定位坐标序列进行傅里叶变换（FFT）或离散度分析，识别非自然的静态固定点或机械式等速直线轨迹。 **LocationSpoofer** 是专为应对深度风控检测而设计的**系统级虚拟定位与无线环境模拟方案**。项目基于 **KernelSU / APatch / Magisk** 获取底层 Root 权限，并利用 **LSPosed (libxposed API 101+)** 框架在 Zygote 阶段注入目标应用进程，以高物理契合度拦截并伪造所有与位置、卫星、基站、Wi-Fi、蓝牙、传感器相关的底层 API 响应，确保应用获取自洽且真实的虚假环境指纹。 --- ## 功能特性 ``` ┌─────────────────────────────────────────────────────────────────────────┐ │ LocationSpoofer │ │ 系统级虚拟定位与无线环境模拟 │ └─────────────────────────────────────────────────────────────────────────┘ │ │ │ ▼ ▼ ▼ 【空间定位与物理仿真】【无线电与传感器模拟】【反检测套件】 • 三地图引擎自由切换 • Wi-Fi 扫描与连接态伪装 • Xposed 堆栈调用帧清洗 • WGS-84/GCJ-02/BD-09 自适应 • 2G-5G NR 蜂窝基站小区模拟 • ClassLoader 探测隔离 • Ornstein-Uhlenbeck 抖动 • BLE 蓝牙信标扫描过滤 • isFromMockProvider 抹除 • 步态横向摇摆与高斯噪声 • WiGLE / OpenCellID 云端导入 • AppOps OP_MOCK_LOCATION 隐藏 • 真实路网拟合与红绿灯停候 • 空间反距离加权 (IDW) 插值 • Settings.Secure 开关覆写 • 悬浮窗遥控阻尼摇杆 • 步频与计步传感器联动 • MultiDex 动态 Class 拦截 ``` ### 1. 多地图引擎与坐标系适配 * **三引擎自由切换**：集成高德 3D 地图 (AMap)、百度地图 (BaiduMap) 与 Google Maps，满足境内外不同场景下的路网检索与 POI 选点需求。 * **开箱即用与全语言支持**：默认“自动匹配”在所有语言（包括中文、英文、阿拉伯语等）环境下均稳定选用高德地图，无需 Google 服务或特殊网络即可顺畅使用。 * **Google 地图自定义 Key**：App 不内置任何 Google Maps 默认密钥；如需使用 Google 地图渲染与 Places 全球搜索，只需在“设置”中填入您自行申请的 Google API Key 即可。 * **智能坐标系自适应（Smart Auto）**： * 系统原生接口统一输出标准 `WGS-84` 物理坐标与卫星数据； * 各大地图定位 SDK（高德/腾讯/百度）及视图渲染层（如百度地图蓝点 `MyLocationData`）自动映射对应坐标系（`GCJ-02` / `BD-09`），规避坐标偏移与 `(0.0, 0.0)` 兜底问题； * 支持在“配置应用坐标系”中为目标应用强制指定 `WGS-84`、`GCJ-02` 或 `BD-09`。 * **零延迟计算**：Hook 阶段直接从预计算的内存数据读取坐标，避免高频回调中的重复三角函数开销。 ### 2. GPS 物理抖动与步态模拟真实 GPS 芯片输出的坐标因电离层延迟、多径效应及接收机热噪声，天然具有高斯分布的白噪声特征。 * **Ornstein-Uhlenbeck 随机过程**：引入物理学均值回归随机过程模型来生成自然位置抖动，其状态随机微分方程定义为： $$\mathrm{d}X_t = -\alpha X_t \mathrm{d}t + \sigma \mathrm{d}W_t$$ 其中 $\sigma$ 为漂移强度，$\alpha$ 为均值回归系数（设定为 `0.05`，即每秒将当前漂移拉回 5%）。它产生符合物理规律的低频缓慢漂移，并在 3-Sigma 原则下严格有界（硬性限制在 4 米内），防止漂移发散引发异常。 * **步频横向抖动（Gait Jitter）**：步行或跑步模式下，引擎沿当前移动方向的正交横向上施加高斯横向位移： $$\Delta L_{\text{lateral}} = 0.15 \cdot \mathcal{N}(0, 1) \quad (\text{米})$$ 模拟人类真实行走时身体左右晃动的步态特征。 * **高度（Altitude）与精度（Accuracy）慢漂移**：精度值与海拔高度动态波动，模拟大气对流层延迟与卫星几何分布的自然变化。 ### 3. 反检测与 MultiDex 支持 * **调用栈深度清洗（Stack Traces Scrubbing）**：拦截 `Throwable.getStackTrace` 和 `Thread.getStackTrace`，自动过滤移除包含 `de.robv.android.xposed`、`io.github.libxposed`、`org.lsposed` 等特征调用帧，阻止反作弊 SDK 在异常堆栈回溯中嗅探 Hook 框架。 * **类加载器探测隔离**：拦截 `Class.forName` 和 `ClassLoader.loadClass`，对 Xposed 特征类名的探测统一返回 `ClassNotFoundException`。 * **MultiDex 动态感知**：拦截 `ClassLoader.loadClass` 动态捕获并安装次级 Dex（如 `classes16.dex`）中的定位组件，配合 `/proc/self/cmdline` 锁定宿主进程主包名，避免内嵌 WebView 或插件改变全局上下文。 * **Mock 属性彻底抹除**： * `Location.isFromMockProvider()` 和 `Location.isMock()` 永久覆写为 `false`； * 反射将 `Location` 内部字段 `mMock` 和 `mIsFromMockProvider` 重写为 `false`，并移除 Extra Bundle 中的 `mockLocation` 标记； * 拦截 `AppOpsManager` 的 `OP_MOCK_LOCATION (58)` 权限查询，返回 `MODE_IGNORED (1)`； * 拦截 `Settings.Secure` 中 `mock_location` 及 `allow_mock_location` 的读取，返回 `0`； * 隐藏 `LocationManager` 中的虚拟 Test Provider，将其统一伪装为系统原生 `gps` 提供者。 ### 4. Wi-Fi、基站与蓝牙环境模拟 * **实地扫街扫描器（EnvironmentScanner）**：后台自动扫描物理世界中的 Wi-Fi 接入点（SSID/BSSID/RSSI/频率/信道/Wi-Fi标准）、基站小区信息（GSM, WCDMA, CDMA, LTE, 5G NR 及 dbm 信号强度）以及附近 BLE 蓝牙信标。 * **空间反距离加权（IDW）插值**：在 Room 数据库中检索周边 50 米范围内的历史采集点，使用反距离平方比作为权重： $$w_i = \frac{1}{d_i^2}$$ 对 Wi-Fi RSSI 信号强度与蜂窝小区 dbm 信号进行平滑插值，保证移动过程中信号连续渐变。 * **无线电数据精细化管理与手动指定**： * 支持在“管理采集数据”页面中手动指定具体使用的 Wi-Fi、基站或蓝牙条目； * 支持自定义修改 Wi-Fi SSID、BSSID、RSSI 信号强度、信道频段、加密类型以及基站小区数据； * 支持在主页地图点选锁定特定环境数据，超出设定范围自动恢复环境插值计算。 * **Wi-Fi 与基站全接口模拟**： * 拦截 `WifiManager.getScanResults()`、`getConnectionInfo()`、`getConfiguredNetworks()`、`getDhcpInfo()`； * 拦截 `TelephonyManager.getAllCellInfo()`、`getCellLocation()`、`getNetworkOperator()`、`getServiceState()`、`getSignalStrength()`、`PhoneStateListener`、`TelephonyCallback`； * 采用真实品牌合法 OUI（TP-Link、Huawei、Xiaomi、Cisco 等）生成非采集区的虚拟 MAC 地址。 * **云端数据导入 (WiGLE & OpenCellID)**：支持配置 WiGLE API 与 OpenCellID API，在线拉取全球指定坐标周边的真实物理 Wi-Fi 与移动基站，自动入库缓存并离线复用。 * **海量数据空间索引**：采用空间索引与分页机制，支持高效检索与存储数千条本地与云端无线电记录，保障界面与后台运行流畅。 ### 5. 卫星矩阵与 NMEA 模拟 * **GnssStatus 矩阵注入**：Hook 系统的 `GnssStatus` 类，模拟 20+ 颗包括 GPS、北斗、GLONASS 的卫星分布矩阵，注入 PRN 标识、信噪比（CNR）、俯仰角、方位角等，并正确汇报 `usedInFix` 状态。 * **NMEA 语句流动态拼装**：劫持 `OnNmeaMessageListener` / `GpsStatus.NmeaListener`，根据当前模拟坐标、航向角、速度和卫星信息，动态拼装符合规范的原始 `$GPGGA`, `$GPRMC`, `$GPGSA`, `$GPGSV` 语句并计算校验和（Checksum）输出。 * **卫星元数据保活注入**：在向各大地图 SDK 派发 `Location` 对象时，强制在 `getExtras()` 中注入 `satellites=20`, `satellites_in_view=20`, `satellites_used_in_fix=18`，防止定位 SDK 判定无卫星搜星而丢弃 GPS 信号。 ### 6. 传感器与步频模拟 * **计步传感器联动**：Hook `SensorManager`，接管 `Sensor.TYPE_STEP_COUNTER`（总步数）和 `Sensor.TYPE_STEP_DETECTOR`（单步脉冲）。 * **步态频率计算**：当开启路线模拟且处于步行或跑步状态时，根据移动距离与步长（默认按 `0.7m/步` 换算）自动生成平滑递增的步数事件，适配运动健康与校园跑打卡软件。 ### 7. 路线规划与红绿灯模拟 * **真实路网拟合**：支持多点路径规划，调用路网搜索算法拟合实际道路轮廓，防止直线穿墙。 * **红绿灯智能识别与驻留**：路线规划自动解析红绿灯路口，行进到红绿灯点时自动停驻 15 秒再重新平滑加速起步。 * **悬浮窗遥控摇杆**：提供悬浮窗虚拟摇杆，支持 0 ~ 10 m/s 速度无级调节与航向角阻尼转向。 ### 8. 用户界面 * 基于 Jetpack Compose 构建，采用现代毛玻璃质感、内阴影与阻尼手势拖拽设计，实现完全模块化与解耦的组件架构。 --- ## 系统架构本项目采用 **MVVM + Clean Architecture**，并按职责拆分为 6 个 Gradle 模块： | 模块 | 类型 | 职责 | |---|---|---| | `app` | Android App | 宿主壳工程：`Application` / `MainActivity`、签名与打包配置、聚合各模块的 Koin DI；仅把 `xposed` 模块的产物（`LocationHooker` 类与 `META-INF/xposed/*` 元数据）打进最终 APK 供 LSPosed 扫描加载，自身**不直接调用**其代码 | | `app-ui` | Android Library | 全部 Jetpack Compose UI：页面、弹窗、自研“液态玻璃”组件（`ui/liquid`）与 ViewModel 层 | | `service` | Android Library | 前台保活服务 `SpoofingService`、悬浮摇杆 `FloatingJoystickService`、开机自启广播等后台/服务层 | | `xposed` | Android Library | LSPosed / Xposed 注入模块本体：`LocationHooker` 入口 + `hooks/`、`hooks/network/` 下的各类 Hook 实现 | | `core-data` | Android Library | `app` / `app-ui` / `service` 三端共用的数据与业务层：Room 数据库、各类 Repository，以及 `ConfigManager`、`RootManager`、`EnvironmentScanner` 等核心工具类 | | `core-geo` | 纯 Kotlin/JVM | 全项目唯一不依赖 Android 的模块：坐标系换算、路线几何与运动真实度引擎，以及 Hook 端与 App 共用的系统识别规则（`vendor/`） | 两个变体统一通过 libxposed 的远程配置通道传递 JSON，Hook 从内存缓存读取： ``` ┌─────────────────────────────────────────────────────────────────────────┐ │ LocationSpoofer 宿主进程（app / app-ui / service / core-data） │ │ ┌─────────────────────────┐ ┌──────────────────────────────────────┐ │ │ │ Triple Map Engine │ │ RouteStateMachine │ │ │ │ (AMap / Baidu / Google) │ │ (IDLE / READY / RUN / PAUSE) │ │ │ └────────────┬────────────┘ └──────────────────┬───────────────────┘ │ │ │ │ │ │ ┌────────────▼──────────────────────────────────▼───────────────────┐ │ │ │ ConfigManager（core-data） │ │ │ │ 序列化配置与坐标系映射，通过框架发布完整配置快照 │ │ │ └──────────────────────────────────┬────────────────────────────────┘ │ │ ┌──────────────────────────────────▼────────────────────────────────┐ │ │ │ SpoofingService（service） │ │ │ │ 前台保活服务、悬浮摇杆控制器与路网 / 步态计算 │ │ │ └───────────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────┬───────────────────────────────────┘ │ (ConfigManager 发布远程偏好 / 远程文件) ▼ ┌─────────────────────────────────────────────┐ │ 框架管理的远程偏好 / 配置文件 │ └──────────────────────┬──────────────────────┘ │ (框架通知 → 后台解码 → 原子更新内存缓存) ▼ LSPosed / libxposed (API 101+) 注入 ┌─────────────────────────────────────────────────────────────────────────┐ │ 目标 App 进程 │ │ ┌───────────────────────────────────────────────────────────────────┐ │ │ │ LocationHooker │ │ │ │ • Location/GNSS：BaseLocationHooker、GnssStatusHooker 等 │ │ │ │ • 地图 SDK：AMapHooker / BaiduMapHooker / TencentMapHooker │ │ │ │ • hooks/network/：Wifi* / Cellular* / Bluetooth*Hooker 等 │ │ │ │ • SensorStepHooker（计步）/ AntiDetectionHooker（反检测） │ │ │ └───────────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────────┘ ``` > [!NOTE] > **跨进程通信 (IPC) 设计**： > `ConfigManager` 使用 `XposedService.getRemotePreferences()` 发布完整 JSON 快照；UTF-8 配置超过 128 KiB 时先写入框架管理的独立远程文件，再原子发布文件指针，避免大配置占满 Binder 事务。全局与非全局版共用这一通道，无需修改 SELinux 策略或向公共临时目录写配置。 > Hook 在模块加载时获取初始快照并注册配置变化监听，由后台线程解码、归一化后替换内存缓存；Hook 调用只读缓存。后台每秒检查框架偏好的内存快照以重试启动时的失败，路线派发和服务发现仍由独立定时器执行。 > App 私有偏好保存最新期望状态，发布失败自动重试，框架重连后重新发布；停止或暂停请求不会被较早的活动配置覆盖。新通道发布成功后会清理旧配置、探针及脚本。框架仍负责配置持久化，此方案并非完全不落盘。 > 需要框架实现远程配置能力。升级后安装对应变体、启用模块并重启设备，再开始模拟；全局版可在“系统适配 → Hook 运行状态”检查配置来源为 `libxposed:remote-preferences` 或 `libxposed:remote-file`，并核对各进程的发布时间。此次通道迁移尚需真机复验。 ### 系统适配（全局方案）全局方案直接 Hook 系统服务，不同厂商 / 系统版本的内部实现不一样，需要逐个适配： * [ADAPTATION_PROGRESS.md](ADAPTATION_PROGRESS.md)：各系统、机型在两个方案下的实机验证进度（App 内"系统适配 → 完整适配进度"显示的就是这份文件）； * [vendor/README.md](xposed/src/main/java/com/vincenthzr/locationspoofer/xposed/hooks/vendor/README.md)：适配框架说明与**新增一个系统的完整检查清单**； * [xposed/ADAPTATION_GUIDE.md](xposed/ADAPTATION_GUIDE.md)：如何在真机上定位系统内部类与方法、如何根据 App 内"Hook 运行状态"页排查适配问题。 --- ## 环境要求 * **系统版本**：Android 8.0 (API 26) 及以上 * **Root 方案**：已获取 Root 权限（推荐 [**KernelSU**](https://kernelsu.org) / **APatch** / **Magisk**）。 * **Xposed 框架**：已安装并激活 **LSPosed (API 101+)** 或兼容 libxposed API 101+ 的框架环境。 --- ## 使用指南 ### 1. 编译与安装 ```bash # 1. 克隆代码仓库 git clone https://github.com/your-username/LocationSpoofer.git # 2. 编译 Debug APK 并直接安装到设备 ./gradlew installDebug ``` ### 2. 权限与激活 1. 打开 **KernelSU / APatch / Magisk** 管理器，授予 LocationSpoofer **Root 权限**。 2. 打开 **LSPosed** 管理器，在模块列表中找到 **LocationSpoofer** 并启用。 3. 在模块的作用域（Scope）中，**勾选需要进行定位伪装的目标应用**（如微信、企业微信、钉钉、超星学习通、百度地图、高德地图等）。 4. **强行停止**勾选的目标 App（或重启手机）以使其加载 Hook 逻辑。 ### 3. 常见场景 #### 定点模拟与环境锁定 1. 启动 LocationSpoofer，在主页地图上拖动准星或搜索栏搜索目标位置。 2. 在底部抽屉开启所需伪装开关：**伪造 Wi-Fi**、**模拟基站**、**模拟蓝牙**、**模拟传感器计步**、**开启随机抖动**。 3. 点击“启动模拟”接管系统 GPS。 4. 如需锁定使用具体的本地采集点，可在“管理数据”中点击对应采集点进行锁定绑定。 #### 路线模拟 1. 切换至“路线规划”标签页，在地图上依次标记多个路点。 2. 设定移动模式（循环 / 往返 / 单程）以及速度档位（步行、跑步、骑行、自驾或自定义速度）。 3. 开启 **“使用真实路线规划”**（系统将自动拉取真实道路轮廓并标记红绿灯等待节点）。 4. 点击“开始模拟”。可随时开启“悬浮窗摇杆”在前台微调坐标与速度。 #### 实地采集与数据自定义 1. 开启“设置” -> **“环境图谱与扫街”** 模式，手机将在后台记录沿途的真实 Wi-Fi、基站与蓝牙信标。 2. 进入“管理采集数据”页面，可查看列表、编辑备注，或**手动指定/修改**某条 Wi-Fi（如 SSID、BSSID、RSSI 等）或基站小区数据。 3. 支持将采集到的无线电指纹一键**导出为 JSON 文件**，用于备份或共享导入。 #### 独立应用坐标系配置 * 若遇到特定 App 存在固定坐标偏移： * 进入 LocationSpoofer “设置” -> **“配置应用坐标系”**； * 添加目标应用包名； * 将坐标系指定为 `WGS-84`、`GCJ-02` 或 `BD-09`，Hook 层将自动根据目标 App 进行转换。 --- ## 技术栈 * **编程语言**：100% Kotlin * **模块划分**：`app` / `app-ui` / `service` / `xposed` / `core-data` / `core-geo` 六个 Gradle 模块（详见[系统架构](#系统架构)） * **UI 框架**：Jetpack Compose & Material Design 3，叠加第三方 [Miuix](https://github.com/miuix-kmp/miuix)（`top.yukonga.miuix.kmp`）提供的毛玻璃模糊底层能力，并在此之上自研 `ui/liquid` 组件包（改编自开源项目 AndroidLiquidGlass / ILoveWork，Apache-2.0）实现悬浮底栏、透镜折射与阻尼拖拽等 Liquid Glass 交互效果 * **依赖注入**：Koin，按模块拆分为 `coreDataModule` / `serviceModule` / `viewModelModule` 三个子模块，由 `app` 模块的 `appModules` 统一聚合注册 * **持久化存储**：Room Database (SQLite) + 空间索引（`core-data` 模块） * **网络与序列化**：OkHttp 3 + Kotlinx Serialization * **地图组件**：AMap 3DMap SDK / BaiduMap SDK / Google Maps & Places SDK * **Xposed 框架**：LSPosed API 101+ / libxposed (Service 模式)，Hook 实现位于 `xposed` 模块的 `hooks/` 与 `hooks/network/` 子包 --- ## 免责声明本程序**仅供学习研究、技术交流以及个人合法合规测试（如开发者定位测试、设备兼容性调试）使用**。使用者请勿将本工具用于任何违法违规或违反相关平台服务协议的活动（包括但不限于虚假打卡、网络考试作弊、商业欺诈等）。使用本模块造成的任何账号封禁、数据丢失、法律纠纷或其他直接/间接损失，均由使用者自行承担，作者不对此承担任何责任。 --- ## 开源协议本项目基于 [GNU General Public License v3.0](LICENSE) 协议开源。 ``` Copyright (C) 2026 SuseOAA ```