iOS 设备接入
将 iOS 设备连接到 PandaTest Agent。
💡
iOS 设备支持需要额外配置。
安装 usbmuxd relay
如果你使用 Docker Desktop，推荐安装 Mobile Docker Extension (opens in a new tab)，它会自动提供 usbmuxd socket。
或者手动在宿主机运行 relay：
# macOS（usbmuxd 已内置）
socat TCP-LISTEN:27015,reuseaddr,fork UNIX-CONNECT:/var/run/usbmuxd配置环境变量
在 .env 中添加：
USBMUXD_SOCKET_ADDRESS=host.docker.internal:27015iOS 17+ 额外配置
iOS 17 及以上版本需要 go-ios tunnel：
# 宿主机运行
go ios tunnel start在 .env 中添加：
GO_IOS_AGENT_HOST=host.docker.internal
GO_IOS_AGENT_PORT=60105连接设备
将 iOS 设备通过 USB 连接到宿主机，在设备上点击 信任此电脑。
环境变量参考
| 变量 | 说明 | 默认值 |
|---|---|---|
USBMUXD_SOCKET_ADDRESS | iOS usbmuxd 地址 | host.docker.internal:27015 |
GO_IOS_AGENT_HOST | go-ios tunnel 地址 | host.docker.internal |
GO_IOS_AGENT_PORT | go-ios tunnel 端口 | 60105 |
常见问题
设备未识别
- 确认 usbmuxd relay 正在运行
- 确认 iOS 设备已信任此电脑
- 检查 Agent 日志：
docker compose logs -f panda-agent
iOS 17+ 设备无法连接
- 确认
go ios tunnel start已在宿主机运行 - 确认
.env中配置了GO_IOS_AGENT_HOST和GO_IOS_AGENT_PORT - 重启 Agent：
docker compose restart panda-agent