⬇ 下载安装包 · 解压后双击「安装 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 16 起模拟定位必须有开发者模式,而这台手机现在是关的(dev_mode = false)。
GUI 会自动弹出一张引导卡片,三条路任选:
- 点卡片里的「在手机上显示开关」(等价
pymobiledevice3 amfi reveal-developer-mode), 然后手机:设置 → 隐私与安全性 → 拉到底 → 开发者模式 → 打开 → 重启 → 回来点「重新检测」。 - 命令行:
pymobiledevice3 amfi enable-developer-mode --udid <UDID>(手机会自动重启; 设了锁屏密码时会拒绝,得走第 1 条手动开)。 - 真机验证过的部分:
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)。
- 只改系统 CoreLocation;小程序若额外校验 WiFi / 基站 / IP / 时间戳,仍会识破。
- 重启手机后模拟失效,需要重新传送;开发者模式开着时手机上有提示条。
- 底图:亮色
tile.openstreetmap.de、暗色 EsriWorld_Dark_Gray_Base、另带一份 Esri 卫星图, 均为 WGS-84,坐标不偏。CARTO 已弃用——它的 basemaps 现在返回 “API key required” 占位图。 底图加载失败不影响传送(可直接手填经纬度,地图右下角可切底图)。 - 地名搜索 Photon → 回退 Nominatim,都不通时手填坐标。
- 只监听
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。
安装脚本做的事:
- 检查 macOS ≥ 12、CPU 架构;
- 把 Python 运行时装到
~/Library/Application Support/ios-locator/python(放这里是因为 「文稿/桌面」会被 TCC 拦,后台进程读不到自己的代码); - 建
.venv,pip install --no-index --find-links payload/wheels pymobiledevice3(离线失败自动回退阿里云镜像); - 复制程序到
.../ios-locator/app; - 生成
~/Applications/iOS 定位.app(ad-hoc 签名 + 去 quarantine); - 自检:真起一次服务、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