文档
这一页写的是"真上手会遇到什么"。都是现场踩过的坑,照做能省掉大半排障时间。
一、部署(约 30 分钟)
- 主机:Windows 10/11,建议 16GB 内存;一台主机同时带 30 台以上时,建议插一块独立 USB 扩展卡(不同控制器分担带宽)。
- 关掉 USB 节能:设备管理器 → 每个 USB 根集线器 → 电源管理 → 取消"允许计算机关闭此设备以节约电源"。否则手机隔一会儿就掉线。
- 接线:8~10 台以内可用普通 USB 集线器;再多就必须用带独立供电的多口集线器(供电不足表现是设备反复掉线、投屏花屏)。
- 手机侧:设置 → 关于手机 → 连点版本号进开发者选项 → 打开 USB 调试;连接时选"文件传输"而不是"仅充电"。
- 启动:双击启动程序,浏览器打开
http://127.0.0.1:5001,默认管理员账号见交付说明(首次登录请改密码)。 - 激活:填卡密 → 客户端与授权服务器握手 → 绑定本机机器码。换电脑需要在后台解绑。
二、OTG 集线器接入
机阵会区分"直连"和"经 OTG 集线器接入":从 adb devices -l 的 USB 拓扑深度判断
(形如 usb:1-4.2 说明设备挂在集线器后面)。系统会把 USB 端口 ↔ 设备序列号
绑定起来,出现下面三种情况会分别提示:
- 换口(moved):同一台手机换了 USB 口,不算新设备。
- 换机(replaced):同一个口插了另一台手机,提示你把资产编号改过来。
- 掉线(dropped):口上没设备了;供电抖动会额外标记为"不稳定"。
重连只做单设备重连(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(这个邮箱开通后启用)。