LocationSpoofer

Project Url: HuangZhuoRui/LocationSpoofer

Introduction: 一款虚拟定位软件，功能单一，纯定位，记得开飞行模式，然后连 WI-FI，需要 root 以及 Lsposed。

More: Author ReportBugs

Tags:

LocationSpoofer

基于 KernelSU + LSPosed 的高保真 Android 系统级虚拟定位模块

High-fidelity Android system-level location spoofing module based on KernelSU + LSPosed

简体中文 | English

📢 加入我们的 Telegram 交流群，虽然我也不知道为什么要有一个 TG 群，但是大家都想要，而且别人也有，那我也要有！

功能	说明
🌍 多语言与双地图	支持中文、English、العربية，国内自动使用高德地图，海外自动无缝切换至 Google Maps
🗺️ 地图可视化选点	集成高德 3D 地图，支持准星拖拽、搜索历史位置及收藏夹
🔀 路线规划系统	状态机驱动的多路点规划，支持撤销、重置及实时预览
🕹️ 虚拟摇杆控制	手动模拟模式下可通过浮动摇杆实时控制位置移动，支持平滑方位角过渡
🔄 自动循环模拟	支持沿预设路线自动往返，可自定义步行、跑步、骑行、驾车等多种速度
🛰️ 高保真 GPS 劫持	Hook `Location` 全层级方法，集成步频模拟与卫星漂移抖动，规避静态位置检测
📶 Wi-Fi 环境克隆	基于 WiGLE API 实时拉取目标坐标周围的真实热点指纹（BSSID/SSID）并注入
🔵 BLE 信标屏蔽	拦截蓝牙扫描，防止通过 iBeacon 等室内定位技术泄露真实位置
🏗️ 基站信息伪造	模拟 Cell Location 信息，提供完整的地理位置欺骗链路
🕵️ 深度反检测	抹除 `isMock` 标志位及高德 SDK 内部 Mock 检测，覆盖 Android 13+ 字段
🔐 安全集成与 CI/CD	API 密钥与代码完全隔离，本地通过 `local.yml` 读取，云端基于 GitHub Actions Secrets 自动注入打包发布

🏛️ 系统架构

本项目采用 MVVM 架构，配合 State-Machine 处理复杂的路线规划流程：

┌─────────────────────────────────────────┐
│            LocationSpoofer (App)         │
│  ┌──────────┐  ┌──────────────────────┐ │
│  │ Dual-Map │  │  RouteStateMachine   │ │
│  │(高德/谷歌)│  │  (IDLE/READY/RUN...) │ │
│  └────┬─────┘  └──────────┬───────────┘ │
│       │                   │             │
│  ┌────▼───────────────────▼───────────┐ │
│  │         SpooferProvider            │ │
│  │     (ContentProvider IPC 桥)       │ │
│  └────────────────────────────────────┘ │
│  ┌──────────────────────────────────┐   │
│  │        SpoofingService           │   │
│  │    (前台服务 & 轨迹计算引擎)         │   │
│  └──────────────────────────────────┘   │
└─────────────────────────────────────────┘
              ↓ LSPosed 注入
┌─────────────────────────────────────────┐
│           目标 App 进程                  │
│  ┌──────────────────────────────────┐   │
│  │         LocationHooker           │   │
│  │  • GPS/BDS/GLONASS 劫持          │   │
│  │  • Wifi/Cell/Bluetooth 注入      │   │
│  │  • Anti-Mock & SDK 检测绕过       │   │
│  └──────────────────────────────────┘   │
└─────────────────────────────────────────┘

📋 环境要求

Android 8.0 (API 26) 及以上
KernelSU / Magisk (需要 Root 权限)
LSPosed 框架
在 LSPosed 管理器中启用模块并勾选需要伪装的目标应用

🚀 快速开始

1. 编译与安装

# 克隆仓库
git clone https://github.com/your-username/LocationSpoofer.git
# 编译并安装
./gradlew installDebug

2. 配置说明

在 KernelSU 中授予 Root 权限。
在 LSPosed 中激活模块，建议勾选以下常用应用：
- 微信 (com.tencent.mm)
- 超星学习通 (com.chaoxing.mobile)
- 钉钉 (com.alibaba.android.rimet)
强制停止目标应用后重新打开。