部署方案
安卓设备接入

Android 设备接入

将 Android 设备连接到 PandaTest Agent。

确保 ADB 可用

宿主机需要运行 ADB server:

adb start-server
adb devices

确认设备列表中显示你的设备。

开启 USB 调试

在手机 设置 → 开发者选项 中开启 USB 调试,连接 USB 后在手机上确认授权。

自动发现

Agent 启动后会自动检测连接到宿主机的 Android 设备,无需额外配置。

各品牌手机开启 USB 调试的详细步骤,请参考文档站 各品牌USB调试(侧栏可切换其他品牌)。

常见问题

设备未识别

  1. 确认 ADB server 正在运行:adb devices
  2. 确认 USB 调试已开启并已授权
  3. 检查 Agent 日志中是否有设备发现记录:
    docker compose logs -f panda-agent

投屏连接失败

  1. 确认 .envAGENT_HOST 填写的是正确的局域网 IP
  2. 确认浏览器和 Agent 在同一局域网,或均可访问公网
  3. 检查防火墙是否放行了 Agent 端口(默认 3011)