# pymobiledevice3 iOS 设备协议库与命令行工具

> 纯 Python 3 实现的库和命令行工具，可在 Windows、Linux 或 macOS 上与 iPhone、iPad 等 iOS 设备通信，实现了 usbmux、lockdown 及其服务、基于 DTX 的开发者（DVT）服务，以及 iOS 17+ 开发者访问所用的 RemoteXPC 隧道。命令涵盖设备发现与端口转发、syslog 和崩溃报告收集、AFC 文件访问、应用与描述文件管理、设备流量 PCAP 抓包、蓝牙 HCI 日志、借助 Chrome DevTools 协议桥调试 Safari 和 WebView 的 WebInspector 自动化，以及进程监控、截图等 DVT 工具；也支持固件更新、恢复／DFU 模式和备份。其协议内部文档逐层讲解 usbmux、lockdown、DTX 和 RemoteXPC，misc/ 中的辅助脚本可嗅探 plist 和 RemoteXPC 流量。

- 类型：工具
- 目标：应用 · 协议
- 类别：调试与动态分析
- 关联：基础工具
- 来源复核于：2026-10-19
- 收录于：2026-11-09
- 原始资源：<https://github.com/doronz88/pymobiledevice3>
- 一手来源：<https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/pymobiledevice3/>
- 记录 JSON：<https://awesomerea.org/resources/pymobiledevice3/record.json>
- 英文版：[English](https://awesomerea.org/resources/pymobiledevice3/index.md)

## 使用条件与局限

- v11.38.0 于 2026-10-19 发布到 GitHub 和 PyPI。README 称 PyPI 是唯一官方发布渠道，AUR 等第三方软件包可能已过时。需要 Python 3.9+。
- 需要一台使用者自己控制、已连接或位于网络中的 iOS 设备。Windows 需安装 iTunes 以获得 Apple Mobile Device Service，Linux 需要 usbmuxd，macOS 使用系统自带的 usbmuxd。iOS 13 之前的版本需要 OpenSSL，恢复／DFU 模式需要 libusb。隧道指南称，iOS 17.4+ 的开发者命令会在进程内建立无需 root 的隧道；iOS 17.0–17.3.1 在 Linux 或 Windows 上则需要以 root 运行的 tunneld。
- 开发者服务需要开启开发者模式并挂载 Apple 的 Developer Disk Image。自动挂载器的 developer_disk_image 依赖会从另一个转存仓库下载 Apple 镜像文件；Apple 文件保留 Apple 的权利。
- 采用 GPL-3.0-or-later 许可。仓库还提供通过命令行驱动设备的设备操作代理技能。

## 一手来源

1. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/README.md>
2. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/docs/installation.md>
3. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/docs/guides/cli-recipes.md>
4. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/docs/guides/ios17-tunnels.md>
5. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/misc/understanding_idevice_protocol_layers.md>
6. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/misc/RemoteXPC.md>
7. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/pymobiledevice3/dtx/README.md>
8. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/misc/remotexpc_sniffer.py>
9. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/pymobiledevice3/services/mobile_image_mounter.py>
10. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/pyproject.toml>
11. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/docs/guides/codex-device-operator-skill.md>
12. <https://github.com/doronz88/pymobiledevice3/blob/9ea94919e4740256ddd4fa13e3e5872d43851ff0/LICENSE>
13. <https://github.com/doronz88/pymobiledevice3/releases/tag/v11.38.0>
14. <https://pypi.org/project/pymobiledevice3/11.38.0/>

## 同分区更多条目：原生二进制

- [dumpulator 内存转储模拟库](https://awesomerea.org/zh/resources/dumpulator/index.md) · 工具
- [McSema 二进制到 LLVM bitcode 提升器](https://awesomerea.org/zh/resources/mcsema/index.md) · 工具
- [retoolkit 逆向工程工具集安装程序](https://awesomerea.org/zh/resources/retoolkit/index.md) · 工具
- [D-810 ng IDA 反混淆插件](https://awesomerea.org/zh/resources/d810-ng/index.md) · 工具
- [Anvill 机器码到 LLVM bitcode 提升器](https://awesomerea.org/zh/resources/anvill/index.md) · 工具
- [XRefer 二进制导航插件](https://awesomerea.org/zh/resources/xrefer/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。