簡介這是一套面向 iOS 17 及以上系統(tǒng)的免越獄虛擬定位跑步打卡工具主要服務于需要在無法實際外出時模擬運動軌跡、完成跑步類應用打卡的用戶同時支持跨平臺運行降低了非技術用戶的使用門檻。資源包共 16 個文件以 9 個 Python 腳本為核心配合 txt 路線數(shù)據(jù)、yaml 配置、yml 工作流、md 說明文檔及 license 等整體約 15KB結(jié)構(gòu)輕量便于快速部署與二次調(diào)整。核心能力包括在線拾取真實跑步路徑、自定義距離、時間與速度等參數(shù)并借助 tunnel、location、route 等模塊完成定位模擬與路徑管理。目前已有 703 人學習下載適合希望研究虛擬定位實現(xiàn)思路、參考命令行工具組織方式或搭建模擬跑步環(huán)境的讀者可從中獲取路徑拾取、參數(shù)配置與跨平臺運行的具體實現(xiàn)參考。1. 免越獄虛擬定位跑步打卡一個 iOS 17 跨平臺工具的真實拆解有個做運動社交產(chǎn)品的朋友找我吐槽測試賬號每天要手動跑 5 公里才能點亮打卡運營同事快瘋了。他問我有沒有辦法在 iOS 17 上不越獄就模擬跑步軌跡還要能跨平臺批量操作。我翻了一圈找到了這個基于虛擬定位的 iOS 免越獄模擬跑步打卡項目。它解決的核心問題很具體不碰系統(tǒng)簽名、不裝描述文件通過外部工具鏈注入定位數(shù)據(jù)讓健康類 App 以為你真的在跑。適合兩類人一是做運動 App 測試的開發(fā)者需要批量造軌跡數(shù)據(jù)二是想研究 iOS 定位機制的安全愛好者。項目跨平臺支持 Windows 和 macOSiOS 17 以上系統(tǒng)可用下面我把整個鏈路拆開講。2. 技術選型與架構(gòu)為什么是 pymobiledevice3 DVT 而不是 Xcode 模擬器2.1 核心依賴棧pymobiledevice3 與 DVT 服務的關系這個項目沒有走 Xcode 模擬器那條路原因很簡單模擬器定位只能影響模擬器內(nèi)的 App真機上的健康 App 根本不認。它用的是 pymobiledevice3 這個 Python 庫通過 USB 連接真機調(diào)用 iOS 系統(tǒng)內(nèi)部的 DVTDeveloper Tools服務來注入定位。pymobiledevice3 本質(zhì)上是對蘋果私有協(xié)議的 Python 實現(xiàn)它封裝了 usbmuxd 通信、lockdown 握手、DVT 服務調(diào)用。項目里最關鍵的模塊是DvtLocationSimulation它負責建立到設備的 DVT 通道然后以固定頻率發(fā)送坐標點。# 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 創(chuàng)建 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): # 單點定位調(diào)用 DVT 的 simulateLocation 接口 self.location.set(lat, lon) def clear(self): # 清除模擬定位恢復真實 GPS self.location.clear()這段代碼是整個項目的入口。create_using_usbmux負責和設備握手DvtProvider建立 DVT 會話LocationSimulation才是真正發(fā)坐標的。參數(shù)udid在多設備場景下必須指定否則默認選第一臺容易翻車。set_location接收緯度和經(jīng)度內(nèi)部會轉(zhuǎn)成 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不支持的系統(tǒng): {system})ensure_usbmuxd在程序啟動時調(diào)用一次。macOS 下如果 usbmuxd 沒跑用launchctl拉起來Windows 下調(diào) pymobiledevice3 的start_usbmuxd。這里有個細節(jié)Windows 上如果裝了 iTunesusbmuxd 可能已經(jīng)在跑重復啟動會端口沖突所以實際代碼里會先探測 27015 端口。參數(shù)說明platform.system()返回Darwin、Windows、Linux。項目沒支持 Linux因為 DVT 服務在 Linux 上兼容性太差血淚經(jīng)驗是別在這上面浪費時間。2.3 軌跡生成模塊從 GPX 到實時坐標流模擬跑步不能只發(fā)一個點健康 App 會檢測位移和速度。項目用 GPX 文件作為軌跡輸入解析后按時間戳逐點發(fā)送。# 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是核心按時間戳逐點發(fā)送speed_factor控制快慢。參數(shù)real_timeFalse時直接全速發(fā)完適合快速造數(shù)據(jù)real_timeTrue模擬真實跑步節(jié)奏。注意time.sleep的最小值設了 0.1 秒因為 DVT 服務每秒處理超過 10 個請求就可能丟包。這個值是實測出來的不是拍腦袋。3. 環(huán)境搭建與運行從零到第一次模擬定位3.1 依賴安裝與設備連接檢查先把 Python 環(huán)境準備好建議 3.10 以上。項目依賴不多但 pymobiledevice3 對版本敏感。# 創(chuàng)建虛擬環(huán)境 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 線是不是只供電不傳數(shù)據(jù)再確認設備上有沒有點「信任此電腦」。提示iOS 17 需要在設備上開啟「開發(fā)者模式」設置 → 隱私與安全性 → 開發(fā)者模式重啟后生效。這個開關不打開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子命令調(diào)LocationSimulator.set_location發(fā)一個點就退出。track子命令解析 GPX 后調(diào)stream--speed對應speed_factor。clear調(diào)LocationSimulation.clear恢復真實 GPS。如果simulate報DvtProvider連接失敗八成是開發(fā)者模式?jīng)]開或者設備鎖屏了。iOS 17 在鎖屏狀態(tài)下會限制 DVT 服務保持屏幕常亮。3.3 驗證定位是否生效怎么知道定位真的注入了打開系統(tǒng)地圖 App看藍點是不是跳到了目標坐標。更可靠的方法是看健康 App 的跑步記錄但那個有延遲。我一般用pymobiledevice3的diagnostics命令讀設備日志過濾locationd關鍵字python -m pymobiledevice3 diagnostics collect --output /tmp/diag grep -i simulated location /tmp/diag/*.log如果日志里出現(xiàn)Simulated location set to說明注入成功。這個驗證步驟很關鍵別只看地圖藍點有時候地圖緩存會騙人。4. 核心模塊拆解定位注入、軌跡調(diào)度與狀態(tài)管理4.1 定位注入的底層調(diào)用鏈從set_location往下追調(diào)用鏈是這樣的LocationSimulation.set→DvtProvider.send_message→Lockdown的 SSL 通道 → usbmuxd → 設備。每一層都可能斷。# 深入 LocationSimulation 的調(diào)用 class LocationSimulation: def set(self, latitude: float, longitude: float): # 構(gòu)造 DVT 消息identifier 是固定的 message { msg: { type: location, latitude: latitude, longitude: longitude } } # 通過 DVT 通道發(fā)送等待響應 response self.dvt.send_message(message) if response.get(error): raise RuntimeError(f定位注入失敗: {response[error]})message的結(jié)構(gòu)是蘋果私有協(xié)議定的type必須是location。send_message是同步阻塞的返回里帶error字段就說明失敗。常見錯誤是DeviceLocked設備鎖屏了。參數(shù)latitude和longitude是浮點數(shù)精度到小數(shù)點后 6 位就夠了再高設備也不認。4.2 軌跡調(diào)度的并發(fā)模型如果要同時模擬多臺設備單線程逐個發(fā)點會串行阻塞。項目用concurrent.futures做并發(fā)# 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控制并發(fā)設備數(shù)一般不超過 4因為 USB 帶寬和 DVT 服務都有上限。run_track每個線程獨立創(chuàng)建LocationSimulator避免共享狀態(tài)。run_all提交任務后等所有 future 完成。注意多設備場景下每臺設備的DvtProvider必須獨立不能復用。我試過復用結(jié)果坐標串到別的設備上去了玄學得很。4.3 狀態(tài)管理與異常恢復長時間跑軌跡DVT 通道會斷。項目里有個StateManager記錄每臺設備的連接狀態(tài)斷了就重連# 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) # 指數(shù)退避 raise RuntimeError(f設備 {udid} 重連失敗)retry_connect用指數(shù)退避第一次等 1 秒第二次 2 秒第三次 4 秒。simulator_factory是個可調(diào)用對象返回新的LocationSimulator。這個模式在 USB 不穩(wěn)定的環(huán)境下能救回不少任務。5. 避坑與常見問題設備連不上、定位不生效、軌跡跳點5.1 設備列表為空usbmuxd 沒起來現(xiàn)象pymobiledevice3 usbmux list輸出空列表但設備明明插著。原因Windows 上沒裝 Apple Mobile Device Support或者 usbmuxd 服務沒啟動macOS 上 usbmuxd 進程掛了。解決Windows 裝 iTunes 或單獨裝 Apple 驅(qū)動macOS 執(zhí)行sudo launchctl load /System/Library/LaunchDaemons/com.apple.usbmuxd.plist。然后重新插拔設備。5.2 定位注入成功但地圖不動現(xiàn)象simulate命令沒報錯但地圖 App 藍點還在真實位置。原因iOS 17 對模擬定位做了緩存地圖 App 可能讀的是舊數(shù)據(jù)。另外如果設備上開了「精確位置」限制模擬定位會被忽略。解決先clear再simulate強制刷新。檢查設置 → 隱私 → 定位服務 → 系統(tǒng)服務 → 開發(fā)者模式定位確保是開的。還不行就重啟設備。5.3 軌跡回放時坐標跳變現(xiàn)象GPX 軌跡明明很平滑但設備上藍點跳來跳去。原因time.sleep間隔太短DVT 服務丟包導致部分坐標沒發(fā)出去?；蛘?GPX 文件本身時間戳有問題。解決把speed_factor降到 1.0 以下或者手動在stream里把最小間隔調(diào)到 0.2 秒。檢查 GPX 文件的時間戳是否單調(diào)遞增用gpxpy解析后打印出來看。5.4 多設備并發(fā)時坐標串臺現(xiàn)象兩臺設備同時跑軌跡A 設備的坐標出現(xiàn)在 B 設備上。原因DvtProvider被復用了或者LocationSimulator的lockdown連接指向了同一臺設備。解決確保每個線程獨立創(chuàng)建LocationSimulatorudid參數(shù)必須顯式傳。別用全局單例。5.5 iOS 17.4 以上版本 DVT 服務被限制現(xiàn)象升級到 iOS 17.4 后DvtProvider連接直接超時。原因蘋果在新版本里收緊了 DVT 服務的權限需要額外的 entitlement。解決目前可行的辦法是降級到 iOS 17.017.3或者用 Xcode 15 的devicectl工具做中轉(zhuǎn)。項目 README 里提了這個問題但沒給完美方案算是已知限制。6. 二次開發(fā)與改造從單機腳本到批量測試平臺這個項目本身是個 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直接調(diào) pymobiledevice3 的list_devices把設備列表吐給前端。這樣運營同事在網(wǎng)頁上選設備、傳 GPX、點開始就行。6.2 軌跡文件的動態(tài)生成固定 GPX 文件不夠靈活我加了個根據(jù)起點、終點、速度自動生成軌跡的模塊# 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 改造時的驗證清單改完別急著上生產(chǎn)按這個清單過一遍檢查項驗證方法預期結(jié)果設備連接usbmux list列出所有目標設備單點定位simulate后看地圖藍點跳到目標坐標軌跡回放跑 1 公里 GPX健康 App 記錄軌跡并發(fā)多設備同時跑 2 臺坐標不串臺異?；謴桶尾?USB自動重連成功接口響應POST /track/start立即返回 started這個清單我每次改完都跑一遍有次偷懶沒跑并發(fā)那項結(jié)果上線后兩臺設備坐標互串被測試同事罵了一頓。從那以后我每次改完調(diào)度模塊都強制走一遍多設備并發(fā)驗證確認udid隔離沒問題才提交。希望幫到你。本文還有配套的精品資源點擊獲取