README.md

iosbridge

用于iOS设备的远程调试支持

已测试通过的工具链

• Xcode (iOS < 17) (其中Xcode对于iOS 17+的设备调试绕过了usbmuxd，所以目前不支持)
• libimobiledevice
• go-ios
• tidevice

Usage

设备侧的使用方法

# 使用前需要确保29123端口没有在使用 (29123是随机的）
iosbridge usbtotcp -u <udid> -p 29123

终端用户侧的使用方法

# 首次启动需要root权限
sudo iosbridge start-server
# 实现过程
# mv /var/run/usbmuxd /var/run/usbmuxd.bak
# listen /var/run/usbmuxd
# listen HTTP server (port:55933)

# 连接远程设备
iosbridge connect <remote-ip>:29123

# 断开远程设备
iosbridge disconnect <remote-ip>:29123

# 查看已连接的设备
iosbridge devices

# 停止服务
iosbridge kill-server

Links

• https://github.com/libimobiledevice/usbmuxd
• https://github.com/pwmb/go-usbmuxd
• https://github.com/doronz88/pymobiledevice3/blob/master/pymobiledevice3/usbmux.py
• https://github.com/danielpaulus/go-ios/blob/main/ios/usbmuxconnection.go#L91

Author

• [email protected] 2025/4/24