文档

这一页写的是"真上手会遇到什么"。都是现场踩过的坑,照做能省掉大半排障时间。

一、部署(约 30 分钟)

  1. 主机:Windows 10/11,建议 16GB 内存;一台主机同时带 30 台以上时,建议插一块独立 USB 扩展卡(不同控制器分担带宽)。
  2. 关掉 USB 节能:设备管理器 → 每个 USB 根集线器 → 电源管理 → 取消"允许计算机关闭此设备以节约电源"。否则手机隔一会儿就掉线。
  3. 接线:8~10 台以内可用普通 USB 集线器;再多就必须用带独立供电的多口集线器(供电不足表现是设备反复掉线、投屏花屏)。
  4. 手机侧:设置 → 关于手机 → 连点版本号进开发者选项 → 打开 USB 调试;连接时选"文件传输"而不是"仅充电"。
  5. 启动:双击启动程序,浏览器打开 http://127.0.0.1:5001,默认管理员账号见交付说明(首次登录请改密码)。
  6. 激活:填卡密 → 客户端与授权服务器握手 → 绑定本机机器码。换电脑需要在后台解绑。

二、OTG 集线器接入

机阵会区分"直连"和"经 OTG 集线器接入":从 adb devices -l 的 USB 拓扑深度判断 (形如 usb:1-4.2 说明设备挂在集线器后面)。系统会把 USB 端口 ↔ 设备序列号 绑定起来,出现下面三种情况会分别提示:

重连只做单设备重连(adb -s 序列号 reconnect device),不会重启 adb 服务——46 台同时在线时重启服务等于整队掉线。

三、常见故障(都是真机上付过代价的)

缩略图 / 画廊一直 503(红米、Android 15 等)

某些系统在 screencap -p 时会在 PNG 前面先输出一段警告文字 ([Warning] Multiple displays were found…),导致图片解析失败。 机阵会按 PNG 文件头定位真实数据并裁掉多余字节,遇到这类机型请升级到最新版本。

投屏黑屏 / 花屏

先看供电:换一个带独立供电的集线器或换个 USB 口。再看带宽:同一控制器上的设备太多时, 系统会自动降档(分辨率/帧率/码率);也可以在设备卡上手动降低画质。

提示"授权已失效"/ 突然不能操作

机阵是在线授权:连续 150 秒连不上授权服务器就会暂停。检查这台电脑能否访问 https://授权服务器/v1/health;如果是刚续费,点一下界面上的"重新校验"。

手机自己亮屏了

真关屏靠的是"设备端面板断电",这个状态只活在当前投屏会话里。开声音、换画质档位、掉线自愈都会 换会话,系统会自动补发一次关屏;如果还是亮了,点一下"切屏"手动补发。

手机重启后就从列表里消失了

这是 Android 的 USB 调试授权在重启后失效:手机重新插上时会弹"允许 USB 调试吗",必须点允许并勾选 "一律允许此计算机"。没点就不会出现,也不会自动重连 —— 这不是掉线,是授权没给。 需要批量重启设备时,建议在重启脚本之后统一处理一次授权弹窗。

个别手机总是掉线,其他都正常

先换机、换线,再看那台的型号:老机型或低端 SoC 在长时间投屏下会发热降频,adb 连接被系统断掉。 对这类机器可以单独把画质档位调低,或把它从关键任务里摘出去。 一次掉一片才是环境问题(集线器电源/线材/控制器抢带宽)。

只有一台电脑能操作,同事的电脑点不动

这是设计如此:输入通道带签名证明,密钥由授权服务器下发。同事要在自己电脑上用,需要单独的授权卡 与自己的浏览器会话,或者由你在这台电脑上代为操作。

四、联系与试用

试用授权(3 天 / 3 台)与报价:请通过购买渠道的客服联系方式索取,或发送邮件到 hi@deckfleet.cn(这个邮箱开通后启用)。

说明:本页不承诺任何业务收益,仅说明工具能力与部署方式;使用本工具从事的业务由使用者自行负责。