Skip to content
zhanggenlovePublic

About

免越狱的 iPhone 虚拟定位工具(macOS):电脑选点,一键把 GPS 传送到全球任意坐标。支持摇杆漫游/路线行走/国内坐标纠偏。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

GeoSkill

GeoSkill

macOS 上的 iPhone 虚拟定位工具 · 免越狱 · 一键传送到全球任意坐标

License: MIT Platform Release

中文 · English · 日本語

GeoSkill

简介

GeoSkill 是一款运行在 macOS 上的 iPhone 虚拟定位工具。在电脑上通过地图选点或搜索地名,即可一键把 iPhone 的 GPS 定位修改到全球任意坐标——无需越狱、无需 Root。

它复用 Apple 官方给开发者的调试通道(与 Xcode 的 Simulate Location 同源),通过 USB 连接手机下发模拟定位,安全且稳定。

和 PoGoskill / iAnyGo 这类工具思路一致:电脑端选点 → 传送到手机。本项目完全开源、免费、无任何云端上传。

✨ 功能特性

  • 🚀 一键传送 —— 地图点选 / 搜索地名 / 输入经纬度,瞬间抵达目标位置
  • 🎮 摇杆漫游 —— 拖动摇杆或用键盘 W/A/S/D,让定位像真人一样持续移动(步行 / 骑行 / 驾驶三档速度)
  • 🗺 路线模式 —— 在地图上连成路线,自动沿路径行走,支持循环往返
  • 📍 地址反查 —— 实时把当前经纬度翻译成可读地址
  • 🇨🇳 国内坐标纠偏 —— 自动处理 GCJ-02 火星坐标偏移,国内地图(高德/微信)定位精准,国外自动跳过
  • ⭐ 收藏夹 —— 常用地点一键回到
  • 🩺 诊断与自愈 —— 内置日志、隧道诊断、一键清理;下发异常时自动重连
  • 🔒 纯本地 —— 所有操作在本机完成,不上传任何数据

🖥 界面展示

界面

📦 下载安装

  1. 前往 Releases 下载最新的 GeoSkill.dmg
  2. 打开 DMG → 把 GeoSkill 拖进「应用程序」→ 双击打开

安装包已用 Apple Developer ID 签名并经过公证,正常双击即可打开,不会有"身份不明开发者"警告。

🔧 首次准备(只做一次)

改定位走的是 Apple 开发者调试通道,免越狱,但 iPhone 需要两个一次性设置:

  1. 用数据线把 iPhone 连到 Mac → 手机弹「是否信任此电脑」→ 点信任、输入手机密码。
  2. 开启开发者模式:iPhone 设置 → 隐私与安全性 → 拉到底 开发者模式 → 打开 → 按提示重启手机。
    • 若设置里暂时没有「开发者模式」,先插着线打开一次 GeoSkill 让它握手,再回设置里看。

🚀 使用方法

  1. 打开 GeoSkill,左上角显示你的 iPhone → 点 建立隧道连接。
  2. 改定位(三选一):
    • 地图上点任意位置 → 点 🚀 传送
    • 搜索地名(如"东京塔")→ 点结果直接传送
    • 直接输入经纬度 → 传送
  3. 移动漫游(可选):拖右下角摇杆或按 W/A/S/D;或用路线模式自动沿路线走。
  4. 国内定位:保持「国内坐标纠偏(GCJ-02)」勾选(默认已开)。
  5. 结束:点 停止 · 恢复真实定位,或关闭 App / 拔线。

❓ 常见问题

Q:手机定位改了之后,怎么恢复真实定位? A:在 App 里点「停止 · 恢复真实定位」,或直接关闭 App / 拔掉数据线即可。 若手机端一时无法恢复真实定位,只需到 iPhone 设置 → 隐私与安全性 → 定位服务,把定位服务关闭再重新打开即可立刻恢复。

Q:连不上隧道 / 反复提示失败? A:打开右下「诊断 · 维护」→ 先点 🧹 清理缓存;还不行再点 ⚠️ 深度清理(会弹系统密码框授权),或重启一次 Mac。

Q:显示连到了 Apple Watch 或别的设备? A:本工具已自动锁定通过 USB 连接的 iPhone,不会连到配对的 Apple Watch。若设备识别异常,重插数据线即可。

Q:国内地图定位偏移几百米? A:确保「国内坐标纠偏(GCJ-02)」勾选着(默认开)。

Q:刚恢复真实定位后只定位到城市级? A:GPS 冷启动需要在户外搜星几分钟,属正常现象,等一会儿即可精准。

🛠 自行编译

关键:请使用独立版 Python(而非 Homebrew Python),否则打出的包在较旧 macOS 上会因系统库符号缺失而无法启动。

# 1) 安装 uv(用于获取为分发而生的独立版 Python)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2) 克隆并进入项目
git clone https://github.com/zhanggenlove/GeoSkill.git && cd GeoSkill

# 3) 创建独立版 Python 3.14 的虚拟环境并安装依赖
uv venv --python 3.14 .venv
uv pip install --python .venv/bin/python -r requirements.txt

# 4) 源码方式直接运行(开发调试)
./.venv/bin/python desktop.py

打包成签名 + 公证的 .app / .dmg(需要你自己的 Apple Developer ID):

# 先存好公证凭据(交互式输入 App 专用密码):
xcrun notarytool store-credentials geoskill-notary \
  --apple-id <你的 Apple ID> --team-id <你的 Team ID>

# 指定你的签名身份与凭据名,然后一键打包:
export GEOSKILL_IDENTITY="Developer ID Application: 你的名字 (TEAMID)"
export GEOSKILL_NOTARY_PROFILE="geoskill-notary"
export MACOSX_DEPLOYMENT_TARGET=11.0
bash build/make_dist.sh
# 产物:dist/GeoSkill.dmg

⚙️ 技术原理

  • 隧道:macOS 上通过 pymobiledevice3 的 remote start-tunnel 建立 RemoteXPC 隧道(Apple 原生隧道,免 root),并锁定目标 iPhone 的 UDID。
  • 定位下发:通过 DVT 的 LocationSimulation 服务(iOS 17+)持续下发坐标;连接保持常驻,定位即维持。
  • 坐标系:对中国大陆坐标做 GCJ-02 反向补偿,保证在国内地图上落点精准。
  • 界面:FastAPI 本地后端 + Leaflet 地图前端,用 pywebview 包成原生窗口。

技术栈:Python · FastAPI · pymobiledevice3 · Leaflet · pywebview · PyInstaller。

⚠️ 免责声明

  • 本项目仅供学习研究与个人合法用途。
  • 修改设备定位可能违反某些 App 或服务的用户协议,由此产生的账号封禁等后果由使用者自行承担。
  • 请勿将本工具用于任何欺诈、作弊或其它违法违规用途。
  • 软件按「现状」提供,不附带任何明示或默示担保;作者不对使用本软件造成的任何损失负责。

📄 开源协议

本项目基于 MIT License 开源,可自由使用、修改和分发。

About

免越狱的 iPhone 虚拟定位工具(macOS):电脑选点,一键把 GPS 传送到全球任意坐标。支持摇杆漫游/路线行走/国内坐标纠偏。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages