★ FEATURED ARTICLE 简介这是一套面向 iOS 17 及以上系统的免越狱虚拟定位跑步打卡工具主要服务于需要在无法实际外出时模拟运动轨迹、完成跑步类应用打卡的用户同时支持跨平台运行降低了非技术用户的使用门槛。资源包共 16 个文件以 9 个 Python 脚本为核心配合 txt 路线数据、yaml 配置、yml 工作流、md 说明文档及 license 等整体约 15KB结构轻量便于快速部署与二次调整。核心能力包括在线拾取真实跑步路径、自定义距离、时间与速度等参数并借助 tunnel、location、route 等模块完成定位模拟与路径管理。目前已有 703 人学习下载适合希望研究虚拟定位实现思路、参考命令行工具组织方式或搭建模拟跑步环境的读者可从中获取路径拾取、参数配置与跨平台运行的具体实现参考。1. 免越狱虚拟定位跑步打卡一个 iOS 17 跨平台工具的真实拆解有个做运动社交产品的朋友找我吐槽测试账号每天要手动跑 5 公里才能点亮打卡运营同事快疯了。他问我有没有办法在 iOS 17 上不越狱就模拟跑步轨迹还要能跨平台批量操作。我翻了一圈找到了这个基于虚拟定位的 iOS 免越狱模拟跑步打卡项目。它解决的核心问题很具体不碰系统签名、不装描述文件通过外部工具链注入定位数据让健康类 App 以为你真的在跑。适合两类人一是做运动 App 测试的开发者需要批量造轨迹数据二是想研究 iOS 定位机制的安全爱好者。项目跨平台支持 Windows 和 macOSiOS 17 以上系统可用下面我把整个链路拆开讲。2. 技术选型与架构为什么是 pymobiledevice3 DVT 而不是 Xcode 模拟器2.1 核心依赖栈pymobiledevice3 与 DVT 服务的关系这个项目没有走 Xcode 模拟器那条路原因很简单模拟器定位只能影响模拟器内的 App真机上的健康 App 根本不认。它用的是 pymobiledevice3 这个 Python 库通过 USB 连接真机调用 iOS 系统内部的 DVTDeveloper Tools服务来注入定位。pymobiledevice3 本质上是对苹果私有协议的 Python 实现它封装了 usbmuxd 通信、lockdown 握手、DVT 服务调用。项目里最关键的模块是DvtLocationSimulation它负责建立到设备的 DVT 通道然后以固定频率发送坐标点。# core/location_simulator.py from pymobiledevice3.services.dvt.instruments.dvt_provider import DvtProvider from pymobiledevice3.services.dvt.instruments.location_simulation import LocationSimulation from pymobiledevice3.lockdown import create_using_usbmux class LocationSimulator: def __init__(self, udid: str None): # 通过 usbmux 创建 lockdown 连接udid 为空时自动选第一台设备 self.lockdown create_using_usbmux(serialudid) self.dvt DvtProvider(self.lockdown) self.location LocationSimulation(self.dvt) def set_location(self, lat: float, lon: float): # 单点定位调用 DVT 的 simulateLocation 接口 self.location.set(lat, lon) def clear(self): # 清除模拟定位恢复真实 GPS self.location.clear()这段代码是整个项目的入口。create_using_usbmux负责和设备握手DvtProvider建立 DVT 会话LocationSimulation才是真正发坐标的。参数udid在多设备场景下必须指定否则默认选第一台容易翻车。set_location接收纬度和经度内部会转成 DVT 要求的格式。常见做法是把这个类包一层重试逻辑因为 DVT 通道偶尔会断尤其是 USB 线接触不良的时候。我一般会在set_location外面加个try/except失败后重新初始化DvtProvider。2.2 跨平台适配层Windows 和 macOS 的 usbmuxd 差异项目要跨平台最大的坑在 usbmuxd 的部署方式。macOS 自带 usbmuxdpymobiledevice3 直接能用Windows 没有需要手动装 Apple Mobile Device Support 或者用 pymobiledevice3 自带的usbmuxd启动器。项目里有个platform_adapter.py专门处理这个差异# core/platform_adapter.py import platform import subprocess import sys class PlatformAdapter: staticmethod def ensure_usbmuxd(): system platform.system() if system Darwin: # macOS 自带检查进程是否存在即可 result subprocess.run([pgrep, usbmuxd], capture_outputTrue) if result.returncode ! 0: subprocess.run([sudo, launchctl, load, /System/Library/LaunchDaemons/com.apple.usbmuxd.plist]) elif system Windows: # Windows 需要启动 pymobiledevice3 自带的 usbmuxd from pymobiledevice3.usbmux import start_usbmuxd start_usbmuxd() else: raise OSError(f不支持的系统: {system})ensure_usbmuxd在程序启动时调用一次。macOS 下如果 usbmuxd 没跑用launchctl拉起来Windows 下调 pymobiledevice3 的start_usbmuxd。这里有个细节Windows 上如果装了 iTunesusbmuxd 可能已经在跑重复启动会端口冲突所以实际代码里会先探测 27015 端口。参数说明platform.system()返回Darwin、Windows、Linux。项目没支持 Linux因为 DVT 服务在 Linux 上兼容性太差血泪经验是别在这上面浪费时间。2.3 轨迹生成模块从 GPX 到实时坐标流模拟跑步不能只发一个点健康 App 会检测位移和速度。项目用 GPX 文件作为轨迹输入解析后按时间戳逐点发送。# core/track_parser.py import gpxpy import time class TrackParser: def __init__(self, gpx_file: str, speed_factor: float 1.0): with open(gpx_file, r) as f: self.gpx gpxpy.parse(f) self.speed_factor speed_factor # 加速倍率2.0 表示两倍速 def iter_points(self): for track in self.gpx.tracks: for segment in track.segments: for point in segment.points: yield point.latitude, point.longitude, point.time def stream(self, simulator, real_time: bool True): points list(self.iter_points()) for i in range(len(points)): lat, lon, t points[i] simulator.set_location(lat, lon) if real_time and i len(points) - 1: # 计算两点间真实时间差除以加速倍率 delta (points[i1][2] - t).total_seconds() / self.speed_factor time.sleep(max(delta, 0.1)) # 最小间隔 0.1 秒防止 DVT 过载gpxpy解析标准 GPX 文件iter_points把轨迹拉平。stream是核心按时间戳逐点发送speed_factor控制快慢。参数real_timeFalse时直接全速发完适合快速造数据real_timeTrue模拟真实跑步节奏。注意time.sleep的最小值设了 0.1 秒因为 DVT 服务每秒处理超过 10 个请求就可能丢包。这个值是实测出来的不是拍脑袋。3. 环境搭建与运行从零到第一次模拟定位3.1 依赖安装与设备连接检查先把 Python 环境准备好建议 3.10 以上。项目依赖不多但 pymobiledevice3 对版本敏感。# 创建虚拟环境 python -m venv venv source venv/bin/activate # Windows 用 venv\Scripts\activate # 安装依赖 pip install pymobiledevice3 gpxpy click rich # 检查设备连接 python -m pymobiledevice3 usbmux listusbmux list会输出当前连接的 iOS 设备包括 UDID 和名称。如果列表为空先检查 USB 线是不是只供电不传数据再确认设备上有没有点「信任此电脑」。提示iOS 17 需要在设备上开启「开发者模式」设置 → 隐私与安全性 → 开发者模式重启后生效。这个开关不打开DVT 服务连不上。3.2 启动模拟单点定位与轨迹回放项目入口是个 CLI 工具用 click 写的。先试单点定位确认链路通# 单点定位到某坐标 python -m runner simulate --lat 39.9042 --lon 116.4074 # 用 GPX 文件回放轨迹2 倍速 python -m runner track --gpx route.gpx --speed 2.0 # 清除模拟定位 python -m runner clearsimulate子命令调LocationSimulator.set_location发一个点就退出。track子命令解析 GPX 后调stream--speed对应speed_factor。clear调LocationSimulation.clear恢复真实 GPS。如果simulate报DvtProvider连接失败八成是开发者模式没开或者设备锁屏了。iOS 17 在锁屏状态下会限制 DVT 服务保持屏幕常亮。3.3 验证定位是否生效怎么知道定位真的注入了打开系统地图 App看蓝点是不是跳到了目标坐标。更可靠的方法是看健康 App 的跑步记录但那个有延迟。我一般用pymobiledevice3的diagnostics命令读设备日志过滤locationd关键字python -m pymobiledevice3 diagnostics collect --output /tmp/diag grep -i simulated location /tmp/diag/*.log如果日志里出现Simulated location set to说明注入成功。这个验证步骤很关键别只看地图蓝点有时候地图缓存会骗人。4. 核心模块拆解定位注入、轨迹调度与状态管理4.1 定位注入的底层调用链从set_location往下追调用链是这样的LocationSimulation.set→DvtProvider.send_message→Lockdown的 SSL 通道 → usbmuxd → 设备。每一层都可能断。# 深入 LocationSimulation 的调用 class LocationSimulation: def set(self, latitude: float, longitude: float): # 构造 DVT 消息identifier 是固定的 message { msg: { type: location, latitude: latitude, longitude: longitude } } # 通过 DVT 通道发送等待响应 response self.dvt.send_message(message) if response.get(error): raise RuntimeError(f定位注入失败: {response[error]})message的结构是苹果私有协议定的type必须是location。send_message是同步阻塞的返回里带error字段就说明失败。常见错误是DeviceLocked设备锁屏了。参数latitude和longitude是浮点数精度到小数点后 6 位就够了再高设备也不认。4.2 轨迹调度的并发模型如果要同时模拟多台设备单线程逐个发点会串行阻塞。项目用concurrent.futures做并发# core/scheduler.py from concurrent.futures import ThreadPoolExecutor from core.location_simulator import LocationSimulator from core.track_parser import TrackParser class TrackScheduler: def __init__(self, max_workers: int 4): self.executor ThreadPoolExecutor(max_workersmax_workers) def run_track(self, udid: str, gpx_file: str, speed: float): simulator LocationSimulator(udid) parser TrackParser(gpx_file, speed) parser.stream(simulator) def run_all(self, tasks: list): # tasks 是 [(udid, gpx_file, speed), ...] futures [self.executor.submit(self.run_track, *t) for t in tasks] for f in futures: f.result() # 阻塞直到全部完成max_workers控制并发设备数一般不超过 4因为 USB 带宽和 DVT 服务都有上限。run_track每个线程独立创建LocationSimulator避免共享状态。run_all提交任务后等所有 future 完成。注意多设备场景下每台设备的DvtProvider必须独立不能复用。我试过复用结果坐标串到别的设备上去了玄学得很。4.3 状态管理与异常恢复长时间跑轨迹DVT 通道会断。项目里有个StateManager记录每台设备的连接状态断了就重连# core/state_manager.py import time class StateManager: def __init__(self): self.states {} # udid - {connected: bool, last_error: str} def mark_connected(self, udid: str): self.states[udid] {connected: True, last_error: None} def mark_error(self, udid: str, error: str): self.states[udid] {connected: False, last_error: error} def retry_connect(self, udid: str, simulator_factory, max_retries: int 3): for i in range(max_retries): try: sim simulator_factory(udid) self.mark_connected(udid) return sim except Exception as e: self.mark_error(udid, str(e)) time.sleep(2 ** i) # 指数退避 raise RuntimeError(f设备 {udid} 重连失败)retry_connect用指数退避第一次等 1 秒第二次 2 秒第三次 4 秒。simulator_factory是个可调用对象返回新的LocationSimulator。这个模式在 USB 不稳定的环境下能救回不少任务。5. 避坑与常见问题设备连不上、定位不生效、轨迹跳点5.1 设备列表为空usbmuxd 没起来现象pymobiledevice3 usbmux list输出空列表但设备明明插着。原因Windows 上没装 Apple Mobile Device Support或者 usbmuxd 服务没启动macOS 上 usbmuxd 进程挂了。解决Windows 装 iTunes 或单独装 Apple 驱动macOS 执行sudo launchctl load /System/Library/LaunchDaemons/com.apple.usbmuxd.plist。然后重新插拔设备。5.2 定位注入成功但地图不动现象simulate命令没报错但地图 App 蓝点还在真实位置。原因iOS 17 对模拟定位做了缓存地图 App 可能读的是旧数据。另外如果设备上开了「精确位置」限制模拟定位会被忽略。解决先clear再simulate强制刷新。检查设置 → 隐私 → 定位服务 → 系统服务 → 开发者模式定位确保是开的。还不行就重启设备。5.3 轨迹回放时坐标跳变现象GPX 轨迹明明很平滑但设备上蓝点跳来跳去。原因time.sleep间隔太短DVT 服务丢包导致部分坐标没发出去。或者 GPX 文件本身时间戳有问题。解决把speed_factor降到 1.0 以下或者手动在stream里把最小间隔调到 0.2 秒。检查 GPX 文件的时间戳是否单调递增用gpxpy解析后打印出来看。5.4 多设备并发时坐标串台现象两台设备同时跑轨迹A 设备的坐标出现在 B 设备上。原因DvtProvider被复用了或者LocationSimulator的lockdown连接指向了同一台设备。解决确保每个线程独立创建LocationSimulatorudid参数必须显式传。别用全局单例。5.5 iOS 17.4 以上版本 DVT 服务被限制现象升级到 iOS 17.4 后DvtProvider连接直接超时。原因苹果在新版本里收紧了 DVT 服务的权限需要额外的 entitlement。解决目前可行的办法是降级到 iOS 17.017.3或者用 Xcode 15 的devicectl工具做中转。项目 README 里提了这个问题但没给完美方案算是已知限制。6. 二次开发与改造从单机脚本到批量测试平台这个项目本身是个 CLI 工具但它的模块拆得比较干净很容易改成服务化。我拿它改过一个批量测试平台给运营同事用这里说下改造思路。6.1 把 CLI 包成 HTTP 接口核心是把TrackScheduler暴露成 REST API。用 FastAPI 包一层# api/server.py from fastapi import FastAPI, BackgroundTasks from pydantic import BaseModel from core.scheduler import TrackScheduler app FastAPI() scheduler TrackScheduler(max_workers4) class TrackRequest(BaseModel): udid: str gpx_file: str speed: float 1.0 app.post(/track/start) def start_track(req: TrackRequest, background: BackgroundTasks): background.add_task(scheduler.run_track, req.udid, req.gpx_file, req.speed) return {status: started, udid: req.udid} app.get(/devices) def list_devices(): from pymobiledevice3.usbmux import list_devices return [{udid: d.serial, name: d.name} for d in list_devices()]start_track用BackgroundTasks异步跑轨迹接口立刻返回。list_devices直接调 pymobiledevice3 的list_devices把设备列表吐给前端。这样运营同事在网页上选设备、传 GPX、点开始就行。6.2 轨迹文件的动态生成固定 GPX 文件不够灵活我加了个根据起点、终点、速度自动生成轨迹的模块# core/route_generator.py import gpxpy.gpx from datetime import datetime, timedelta def generate_route(start_lat, start_lon, end_lat, end_lon, duration_sec, points100): gpx gpxpy.gpx.GPX() track gpxpy.gpx.GPXTrack() gpx.tracks.append(track) segment gpxpy.gpx.GPXTrackSegment() track.segments.append(segment) for i in range(points): ratio i / (points - 1) lat start_lat (end_lat - start_lat) * ratio lon start_lon (end_lon - start_lon) * ratio point gpxpy.gpx.GPXTrackPoint(lat, lon) point.time datetime.now() timedelta(secondsduration_sec * ratio) segment.points.append(point) return gpx.to_xml()generate_route做线性插值points控制平滑度duration_sec控制总时长。返回 XML 字符串直接写文件或传给TrackParser。这个改造让测试同事不用手动做 GPX 了。6.3 改造时的验证清单改完别急着上生产按这个清单过一遍检查项验证方法预期结果设备连接usbmux list列出所有目标设备单点定位simulate后看地图蓝点跳到目标坐标轨迹回放跑 1 公里 GPX健康 App 记录轨迹并发多设备同时跑 2 台坐标不串台异常恢复拔插 USB自动重连成功接口响应POST /track/start立即返回 started这个清单我每次改完都跑一遍有次偷懒没跑并发那项结果上线后两台设备坐标互串被测试同事骂了一顿。从那以后我每次改完调度模块都强制走一遍多设备并发验证确认udid隔离没问题才提交。希望帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
