iOS 设备接入
将 iOS 设备连接到 PandaTest Agent。
安装 usbmuxd relay
使用 Docker Desktop 时，推荐安装 Mobile Docker Extension (opens in a new tab)，它会自动提供 usbmuxd。
或在宿主机手动转发：
# macOS（系统已内置 usbmuxd）
socat TCP-LISTEN:27015,reuseaddr,fork UNIX-CONNECT:/var/run/usbmuxd配置环境变量
Agent .env 中确认：
USBMUXD_SOCKET_ADDRESS=host.docker.internal:27015iOS 17 及以上由 Agent 进程内自动建立隧道，无需额外工具。
连接设备
将 iOS 设备通过 USB 连接到宿主机，在设备上点击 信任此电脑。
环境变量参考
| 变量 | 说明 | 默认值 |
|---|---|---|
USBMUXD_SOCKET_ADDRESS | iOS usbmuxd 地址 | host.docker.internal:27015 |
常见问题
设备未识别
- 确认 usbmuxd relay 正在运行
- 确认设备已信任此电脑
- 查看 Agent 日志：
docker compose logs -f panda-agent