簡介這是一套面向 iOS 17 及以上系統(tǒng)的免越獄虛擬定位跑步打卡工具主要服務(wù)于需要在無法實際外出時模擬運動軌跡、完成跑步類應用打卡的用戶同時支持跨平臺運行降低了非技術(shù)用戶的使用門檻。資源包共 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. 技術(shù)選型與架構(gòu)為什么是 pymobiledevice3 DVT 而不是 Xcode 模擬器2.1 核心依賴棧pymobiledevice3 與 DVT 服務(wù)的關(guān)系這個項目沒有走 Xcode 模擬器那條路原因很簡單模擬器定位只能影響模擬器內(nèi)的 App真機上的健康 App 根本不認。它用的是 pymobiledevice3 這個 Python 庫通過 USB 連接真機調(diào)用 iOS 系統(tǒng)內(nèi)部的 DVTDeveloper Tools服務(wù)來注入定位。pymobiledevice3 本質(zhì)上是對蘋果私有協(xié)議的 Python 實現(xiàn)它封裝了 usbmuxd 通信、lockdown 握手、DVT 服務(wù)調(diào)用。項目里最關(guān)鍵的模塊是DvtLocationSimulation它負責建立到設(shè)備的 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 為空時自動選第一臺設(shè)備 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負責和設(shè)備握手DvtProvider建立 DVT 會話LocationSimulation才是真正發(fā)坐標的。參數(shù)udid在多設(shè)備場景下必須指定否則默認選第一臺容易翻車。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 服務(wù)在 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的最小值設(shè)了 0.1 秒因為 DVT 服務(wù)每秒處理超過 10 個請求就可能丟包。這個值是實測出來的不是拍腦袋。3. 環(huán)境搭建與運行從零到第一次模擬定位3.1 依賴安裝與設(shè)備連接檢查先把 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 # 檢查設(shè)備連接 python -m pymobiledevice3 usbmux listusbmux list會輸出當前連接的 iOS 設(shè)備包括 UDID 和名稱。如果列表為空先檢查 USB 線是不是只供電不傳數(shù)據(jù)再確認設(shè)備上有沒有點「信任此電腦」。提示iOS 17 需要在設(shè)備上開啟「開發(fā)者模式」設(shè)置 → 隱私與安全性 → 開發(fā)者模式重啟后生效。這個開關(guān)不打開DVT 服務(wù)連不上。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)]開或者設(shè)備鎖屏了。iOS 17 在鎖屏狀態(tài)下會限制 DVT 服務(wù)保持屏幕常亮。3.3 驗證定位是否生效怎么知道定位真的注入了打開系統(tǒng)地圖 App看藍點是不是跳到了目標坐標。更可靠的方法是看健康 App 的跑步記錄但那個有延遲。我一般用pymobiledevice3的diagnostics命令讀設(shè)備日志過濾locationd關(guān)鍵字python -m pymobiledevice3 diagnostics collect --output /tmp/diag grep -i simulated location /tmp/diag/*.log如果日志里出現(xiàn)Simulated location set to說明注入成功。這個驗證步驟很關(guān)鍵別只看地圖藍點有時候地圖緩存會騙人。4. 核心模塊拆解定位注入、軌跡調(diào)度與狀態(tài)管理4.1 定位注入的底層調(diào)用鏈從set_location往下追調(diào)用鏈是這樣的LocationSimulation.set→DvtProvider.send_message→Lockdown的 SSL 通道 → usbmuxd → 設(shè)備。每一層都可能斷。# 深入 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è)備鎖屏了。參數(shù)latitude和longitude是浮點數(shù)精度到小數(shù)點后 6 位就夠了再高設(shè)備也不認。4.2 軌跡調(diào)度的并發(fā)模型如果要同時模擬多臺設(shè)備單線程逐個發(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è)備數(shù)一般不超過 4因為 USB 帶寬和 DVT 服務(wù)都有上限。run_track每個線程獨立創(chuàng)建LocationSimulator避免共享狀態(tài)。run_all提交任務(wù)后等所有 future 完成。注意多設(shè)備場景下每臺設(shè)備的DvtProvider必須獨立不能復用。我試過復用結(jié)果坐標串到別的設(shè)備上去了玄學得很。4.3 狀態(tài)管理與異常恢復長時間跑軌跡DVT 通道會斷。項目里有個StateManager記錄每臺設(shè)備的連接狀態(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設(shè)備 {udid} 重連失敗)retry_connect用指數(shù)退避第一次等 1 秒第二次 2 秒第三次 4 秒。simulator_factory是個可調(diào)用對象返回新的LocationSimulator。這個模式在 USB 不穩(wěn)定的環(huán)境下能救回不少任務(wù)。5. 避坑與常見問題設(shè)備連不上、定位不生效、軌跡跳點5.1 設(shè)備列表為空usbmuxd 沒起來現(xiàn)象pymobiledevice3 usbmux list輸出空列表但設(shè)備明明插著。原因Windows 上沒裝 Apple Mobile Device Support或者 usbmuxd 服務(wù)沒啟動macOS 上 usbmuxd 進程掛了。解決Windows 裝 iTunes 或單獨裝 Apple 驅(qū)動macOS 執(zhí)行sudo launchctl load /System/Library/LaunchDaemons/com.apple.usbmuxd.plist。然后重新插拔設(shè)備。5.2 定位注入成功但地圖不動現(xiàn)象simulate命令沒報錯但地圖 App 藍點還在真實位置。原因iOS 17 對模擬定位做了緩存地圖 App 可能讀的是舊數(shù)據(jù)。另外如果設(shè)備上開了「精確位置」限制模擬定位會被忽略。解決先clear再simulate強制刷新。檢查設(shè)置 → 隱私 → 定位服務(wù) → 系統(tǒng)服務(wù) → 開發(fā)者模式定位確保是開的。還不行就重啟設(shè)備。5.3 軌跡回放時坐標跳變現(xiàn)象GPX 軌跡明明很平滑但設(shè)備上藍點跳來跳去。原因time.sleep間隔太短DVT 服務(wù)丟包導致部分坐標沒發(fā)出去?；蛘?GPX 文件本身時間戳有問題。解決把speed_factor降到 1.0 以下或者手動在stream里把最小間隔調(diào)到 0.2 秒。檢查 GPX 文件的時間戳是否單調(diào)遞增用gpxpy解析后打印出來看。5.4 多設(shè)備并發(fā)時坐標串臺現(xiàn)象兩臺設(shè)備同時跑軌跡A 設(shè)備的坐標出現(xiàn)在 B 設(shè)備上。原因DvtProvider被復用了或者LocationSimulator的lockdown連接指向了同一臺設(shè)備。解決確保每個線程獨立創(chuàng)建LocationSimulatorudid參數(shù)必須顯式傳。別用全局單例。5.5 iOS 17.4 以上版本 DVT 服務(wù)被限制現(xiàn)象升級到 iOS 17.4 后DvtProvider連接直接超時。原因蘋果在新版本里收緊了 DVT 服務(wù)的權(quán)限需要額外的 entitlement。解決目前可行的辦法是降級到 iOS 17.017.3或者用 Xcode 15 的devicectl工具做中轉(zhuǎn)。項目 README 里提了這個問題但沒給完美方案算是已知限制。6. 二次開發(fā)與改造從單機腳本到批量測試平臺這個項目本身是個 CLI 工具但它的模塊拆得比較干凈很容易改成服務(wù)化。我拿它改過一個批量測試平臺給運營同事用這里說下改造思路。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把設(shè)備列表吐給前端。這樣運營同事在網(wǎng)頁上選設(shè)備、傳 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é)果設(shè)備連接usbmux list列出所有目標設(shè)備單點定位simulate后看地圖藍點跳到目標坐標軌跡回放跑 1 公里 GPX健康 App 記錄軌跡并發(fā)多設(shè)備同時跑 2 臺坐標不串臺異?；謴桶尾?USB自動重連成功接口響應POST /track/start立即返回 started這個清單我每次改完都跑一遍有次偷懶沒跑并發(fā)那項結(jié)果上線后兩臺設(shè)備坐標互串被測試同事罵了一頓。從那以后我每次改完調(diào)度模塊都強制走一遍多設(shè)備并發(fā)驗證確認udid隔離沒問題才提交。希望幫到你。本文還有配套的精品資源點擊獲取