Skip to content

About

Spoof your iPhone's GPS from a local web GUI on macOS — map pick, one-click teleport, route playback. Built on pymobiledevice3, ships with an offline installer.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

iOS 定位 · 模拟器

license platform ios release

⬇ 下载安装包 · 解压后双击「安装 iOS 定位.command」,内置 Python 与全部依赖,全程离线。

一个跑在本机的 iPhone 定位模拟小工具:地图选点 → 一键把连着的 iPhone 传送到那里。 后端是 pymobiledevice3,前端是纯标准库托管的单页应用 (Leaflet),界面照 macOS 26 的 Liquid Glass 风格做的,亮/暗色跟随系统。

界面预览

环境

组件 版本 / 位置
iOS 设备 iPhone 15(iPhone15,4),iOS 27.0.1
本机 macOS 15.8.3(arm64)
uv ~/.local/bin/uv 0.13.7
pymobiledevice3 ~/.local/bin/pymobiledevice3 11.52.1
项目 venv .venv(uv 托管的 CPython 3.15.2)

启动脚本不再依赖 /usr/bin/python3(那是 CommandLineTools 带的,系统升级后可能变), 一律走 .venv/bin/python;.venv 丢了会自动 uv venv --python 3.15 .venv 重建。 装依赖时用的是阿里云镜像(UV_DEFAULT_INDEX=https://mirrors.aliyun.com/pypi/simple), 官方源在这台机器上会卡死。

启动

双击 启动.command(或 iOS 定位.app,它只是调起 Terminal 跑同一脚本),浏览器打开 http://127.0.0.1:8756。

为什么走 Terminal:项目在「文稿」里,后台进程直接读 app.py 会被 macOS 的 TCC 拦掉 (Operation not permitted),Terminal 有权限。首次双击若弹窗询问,点允许。

端口被占用会自动打开已有页面;GUI 右上角「退出」停服务。

iOS 27 首次使用(关键)

iOS 16 起模拟定位必须有开发者模式,而这台手机现在是关的(dev_mode = false)。 GUI 会自动弹出一张引导卡片,三条路任选:

  1. 点卡片里的「在手机上显示开关」(等价 pymobiledevice3 amfi reveal-developer-mode), 然后手机:设置 → 隐私与安全性 → 拉到底 → 开发者模式 → 打开 → 重启 → 回来点「重新检测」。
  2. 命令行:pymobiledevice3 amfi enable-developer-mode --udid <UDID>(手机会自动重启; 设了锁屏密码时会拒绝,得走第 1 条手动开)。
  3. 真机验证过的部分:amfi reveal-developer-mode 已执行成功,开关现在应该在手机设置里。

开启并重启后,GUI 顶部的「开发者模式 未开」会变绿,传送按钮才真正可用。

能做什么

  • 定点传送:地图点选 / 手填经纬度 / 搜地名(Photon,国内可达),「传送到此位置」。
  • 收藏:坐标存 localStorage,点名字定位、点 ⚡ 直接传送。
  • 路线模拟:地图左上角切「路线」模式连点路径点,设速度与抖动 → 生成 GPX 按真实速度播放。
  • 清除模拟:simulate-location clear。
  • 高级(日志卡片里折叠):挂载 DDI、重新检测。
  • 日志:每条真实命令与输出都在左下角,排障先看它。

对应命令(iOS 27 走 dvt 分支,16 及以下自动去掉 dvt):

pymobiledevice3 developer dvt simulate-location set  --udid <UDID> -- 31.2397 121.4998
pymobiledevice3 developer dvt simulate-location play --udid <UDID> route.gpx 300
pymobiledevice3 developer dvt simulate-location clear --udid <UDID>

工作机制

simulate-location set 不是一次性命令:它建立 DVT 会话后一直挂着直到被杀。 所以每次传送 = 杀掉上一个会话 + 起新的常驻进程;「清除模拟」= 杀会话 + clear。

iOS 17+ 的 RSD 隧道由 CLI 用纯 Python 用户态协议栈自建(--userspace,默认),不需要 sudo, 新建会话有 2~6 秒握手延迟。

iOS 27 的 DDI 变成了 Cryptex1(走 cryptexd,需要 RSD 隧道)。但 developer dvt 从 iOS 17 起 就只要求开发者模式、不要求挂 DDI,所以模拟定位不需要动它;「高级 → 挂载 DDI」只是给 core-device 那类命令留的后路,本机尚未实测(首次会下载上百 MB)。

已知限制

  1. 只改系统 CoreLocation;小程序若额外校验 WiFi / 基站 / IP / 时间戳,仍会识破。
  2. 重启手机后模拟失效,需要重新传送;开发者模式开着时手机上有提示条。
  3. 底图:亮色 tile.openstreetmap.de、暗色 Esri World_Dark_Gray_Base、另带一份 Esri 卫星图, 均为 WGS-84,坐标不偏。CARTO 已弃用——它的 basemaps 现在返回 “API key required” 占位图。 底图加载失败不影响传送(可直接手填经纬度,地图右下角可切底图)。
  4. 地名搜索 Photon → 回退 Nominatim,都不通时手填坐标。
  5. 只监听 127.0.0.1。

分发给朋友(安装包)

./build_installer.sh      # → dist/iOS定位-安装包.zip(61 MB)

推 v* tag 时 GitHub Actions(.github/workflows/release.yml)会自动跑同一个脚本并把 zip 挂到 Release:

git tag v1.0 && git push origin v1.0

包里是自包含的:内置 CPython 3.15.2 + 90 个离线 wheel,对方双击 安装 iOS 定位.command 就能装完,全程不需要联网、不需要装 Xcode / CommandLineTools。

安装脚本做的事:

  1. 检查 macOS ≥ 12、CPU 架构;
  2. 把 Python 运行时装到 ~/Library/Application Support/ios-locator/python(放这里是因为 「文稿/桌面」会被 TCC 拦,后台进程读不到自己的代码);
  3. 建 .venv,pip install --no-index --find-links payload/wheels pymobiledevice3 (离线失败自动回退阿里云镜像);
  4. 复制程序到 .../ios-locator/app;
  5. 生成 ~/Applications/iOS 定位.app(ad-hoc 签名 + 去 quarantine);
  6. 自检:真起一次服务、curl /api/status,通过才报"安装完成"。

Intel Mac 上内置 Python 跑不起来,脚本会自动回退到系统 python3 + 联网安装(会提示先装 CommandLineTools)。卸载用包里的 卸载 iOS 定位.command。

未做 notarization(没有 Developer ID),对方第一次打开会撞 Gatekeeper: 右键 → 打开,或 xattr -dr com.apple.quarantine ~/Downloads/iOS定位-安装包。

卸载

uv tool uninstall pymobiledevice3
rm -rf ~/.local/share/uv/tools/pymobiledevice3
rm -rf .venv           # 项目自身的 venv

About

Spoof your iPhone's GPS from a local web GUI on macOS — map pick, one-click teleport, route playback. Built on pymobiledevice3, ships with an offline installer.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages