节点地理分布
左侧选省市 · 右侧看该地节点 · 点地图省份也能选
中枢 relay 带宽（占中枢上行 – · 实时波动）
最近使用记录
公司
刷新
📱 手机清单
🧑 员工
📦 盒子看板
⚙️ APK 与任务
手机清单（按盒子）
⚖ 均摊交换机手机
只动交换机上 的手机（USB 的线插在哪台就是哪台，软件分不了）。会先预览 ，确认后才改。
按员工看：
清空筛选
排序：
位置（OTG01-01…）
在线优先
备注
原序（盒子/序列）
批量转给… 转过去
一个公司多台 Ubuntu 机架盒子（每盒最多 19 机）。手机插盒子由 agent 自动上报，插上即出现；员工端只看/控分给自己的那几台。
盒子看板刷新
↑ 全部推送更新
装了本群控系统的 Ubuntu 盒子。是否开机看「状态」；离线=超过 120 秒没上报。IP/版本/手机数由盒子每 30 秒自动上报。
分工 ：USB 盒子只管数据线直插它集线器 的手机（物理独占，扫描段必须留空）；
OTG 盒子管挂在交换机上 的手机——那些手机的 OTG 网卡插在手机自己 那头、不在盒子上，
所以同一局域网里每台 OTG 盒子都连得到它们 ，归属靠指派而不是靠物理位置。
★带不动了想加一台分摊 ：刷好新盒子后，把它的扫描段填成和现有 OTG 盒子一样
（不用给它单独划 IP 段）。它会自动参与：新接入的手机谁先发现归谁，已有的一台都不会被抢走 ；
想把哪几台划给它，在下面「手机清单」里点接管 ，点完就定死。
哪台 OTG 盒子挂了，另一台会在 5 分钟 后自动接管它名下的手机。
扫描段留空 = 真的不扫 （不会继承全局）。USB 盒子填了纯属白费，还会去抢交换机上的手机。
盒子 备注 公司 状态 LAN IP overlay IP 分工 / 扫描段 手机 负载 agent 版本 上次上报 操作
派发脚本任务
ping · 连通自检
swipe_up · 拟人上滑一次
key · 按键(参数 code=HOME/BACK)
open_app · 打开应用(参数 pkg=com.xxx)
douyin_warmup · 打开抖音刷N条(参数 count=5)
参数
范围仅在线 全部
派发到全部机架手机
手机 APK 管理
刷新
↑ 全部升级
传一个 APK 上来就是发布:版本号(包名/versionCode)是从 APK 文件里解出来的 ,不用填、也不用改任何代码。
盒子每 30 秒对名下手机比一次版本,低于这里的就自动装。
装不上多半是厂商守卫 (荣耀/华为纯净模式、小米/OPPO 的「USB 安装」)——那要人在手机上登厂商账号关掉,adb 绕不过;
失败原因会显示在上面手机列表的 APK 列里。
把 APK 拖到这里上传 或
↑ 推给手机(批量)
撤回
未选中
发布钥匙 + 新建
给开发机/自动化用的窄权限令牌,免得为了传个 APK 交出管理员账号(还要输两步验证码)。
它只能把 APK 登记进来、推不动手机 —— 经钥匙上传的每一版都是「待批准」,
必须你在上面勾选「推给手机」才会装到几百台机器上。所以钥匙万一泄露,最坏也就是列表里多个没人批准的条目。
机架任务记录
刷新
⊟ 全部折叠
🔗 接线
＋ 加设备
✨ 美化布局
↺ 复位
－
适应
＋
★一个局域网一个分区 (上下分开的大圆角框)—— 不同网段是不同的物理空间,它们之间本来就没有线相连。
按实测数据画,不按设想画 :实线=网线/供电链路,虚线=控制通道(OTG手机的网络adb走盒子、数据走交换机,
这两条经常一通一断)。虚线圆角框 =平台看不到本体、按接法推断出来的哑设备(USB集线器/交换机),
点开抽屉可改名(如"WM-ZB-U42 机架第2层")。节点可直接拖动 ,位置存在本机浏览器、刷新不丢;
摆乱了点【美化布局】按你的顺序对齐,或【复位】回自动布局。
刷新
🔍 一键体检(从手机那条路测)
软路由 = 一台多网口主机(N300等)当分流网关:手机零 App、全流量按【交换机口固定 MAC】走各自 SK5 住宅出口。用「设备烧录器」⑦软路由档局域网一键装,装好即在下面出现。给每个口绑一条 SK5 线路 → 该口手机整机走那个住宅 IP。
软路由看板
软路由 公司 状态 overlay IP LAN IP 在线口 已绑口 agent 版本 上次上报 操作
交换机口 → SK5 线路绑定
点上面某台软路由的【看口】,这里列出它发现的所有交换机口。每口一块固定 MAC(与手机无关)=绑定键。给口选一条线路 →【保存】(或改多个口后【保存全部】),软路由下次上报(约30秒)热重载,该口手机即走该住宅出口。「出口(实测)」是软路由经该口 SK5 探到的真实住宅IP:🟢通、🔴掉线(该口手机直接断网,不会泄漏)。未绑的口无网。
🚀 一键铺满在线口
💾 保存全部改动
🎲 未绑口轮询现有出口
显示离线口
💡 按住每行最前面的 ⠿ 手柄 上下拖动 就能排口位顺序,松手即存 —— 拓扑图会跟着从左到右重排,照着序号就能到 24 口交换机上找到实体手机。
顺 ⠿ 交换机口 MAC 手机(备注/型号) 在线 固定 LAN IP 绑 SK5 线路 出口(实测) 口位/口名(可选) 操作 先在上表点某台软路由的【看口】
滥用防护 · 域名/IP 黑名单
命中的目标在独享线路 + 轮换池上都会被拒绝，护住宅IP信誉。支持 域名 / *.域名 / IP / CIDR。
加入黑名单
公共 feed 已导入 0 条恶意/钓鱼域名（立即拉取
下表为手工加入项（feed 导入项不逐条列出，避免刷屏）。
告警
机架手机掉线归因 · 近 14 天
这张账不是看"有没有掉",是看为什么掉 ：每次手机接回来会读一次它的开机时长，和"掉了多久"一比就断定它这中间到底重启过 （供电问题，该查转接头/上 UPS）还是压根没重启 （adbd 被 ROM 省电杀了，该治省电策略，或这批机型改 USB 直连——USB 根本没有 tcpip 这个失效模式）。攒够两周再看机型分布，别看单次。
机型 接法 掉线次数 其中·重启过 其中·没重启 ★还没回来 整批掉·非手机 判不了 累计离线
最近每一次（掉线期间症状：够不到 / adb没了 / 卡死）
问题复盘 · 客户端日志
员工报错时不用再让他找文件截图：到「机架手机」页员工列表点【拉日志】 ，他电脑上的云手机平台会在下次心跳（约 10 秒）自动把日志交上来，全程无需他操作。日志只含技术事件（连接/错误码/耗时），不含屏幕内容和聊天记录 ，密码令牌在客户端写日志那一层就已脱敏；每次拉取都记进操作日志。WebView2 那一列是投屏解码用的浏览器内核版本——投屏打不开时先看它。
批量远程运维 · 一键推全部节点
设备分散在员工家、够不到也不用收回：中台点一下，各节点约 5 分钟内自己拉取执行。换 setup-key、更新脚本、重连、重启，全远程搞定。
命令
reconnect · 重连 Netbird
restart-gost · 重启出口
update-scripts · 拉最新脚本重装
set-env · 改配置/换 key
reboot · 重启设备
参数 KEY=VALUE
NETBIRD_SETUP_KEY_NODE（换 setup-key）
NETBIRD_MGMT_URL（换中枢地址）
REPORT_URL（换上报地址）
REPORT_TOKEN（换通道令牌）
范围
仅在线节点
全部节点（离线的下次上线执行）
推送到全部
运维命令记录
操作日志
两步验证(Authenticator)
开启后,登录除了密码还要输 Authenticator(Google / Microsoft / 1Password 都行)里那个 30 秒一变的 6 位码。
密码泄露也进不来。 只对你自己这个账号 生效,每人各自开。
开启前先看清楚: 这个后台管着全部手机和代理线路。手机丢了/刷机了就靠备用恢复码 进来
—— 开启时会给你 10 个,务必抄下来存好 (截图存手机相册不算"存好",手机就是会丢的那个东西)。
开启两步验证
① 打开 Authenticator → 扫这个码
扫不了就手动输密钥:
② 输入 App 里显示的 6 位码,确认扫成功:
确认开启
取消
✅ 已开启 · 备用恢复码剩 ? 个
关闭两步验证
⚠️ 下面 10 个是备用恢复码 ,每个只能用一次。现在就抄下来存到安全的地方
—— 关掉这个页面就再也看不到了 (库里只存哈希)。手机丢了时,用它们代替 6 位码登录。
我已经抄好了
📲 告警推送
📱 手机 / 盒子
🔑 密钥 / 第三方
🧹 清理 / 留存
🔒 安全
💾 备份
消息哨兵（抖音 / 小红书新消息提醒）
开启后,盒子会定时把机架手机切到前台读「消息」未读数,员工端手机列表亮红角标(不用挨个切镜像)。探测时自动静音、读完恢复原音量。分时段设不同频率 :上班勤(消息及时)、下班疏(省电抗风控)。改完即时下发所有盒子。
哨兵开关
开启
关闭
上班探测间隔
秒 默认 300 秒(=5 分钟),越小消息越及时越费电
下班探测间隔
秒 默认 3600 秒(=60 分钟),越大越省电抗风控
上班起始钟点
点 0-23 整点,默认 9 点
上班结束钟点
点 0-23 整点,默认 21 点;比起始小=跨夜班
SK5 出口默认带机数
新开一个出口时,默认允许它带几台手机。★这只是规划参考 (绑口时不硬拦),用来给「🚀 一键铺满在线口」算摊法、以及在出口下拉里显示「已带/上限」。节点总览页那两个「默认每个带 N 台」改的就是这两个值 ,同一个键、同一个后端,不是两套。
🏠 自有节点
台
🛒 采购上游
台
员工上传的视频 · 位置信息
默认「不处理」＝ 视频原样传给手机，我们一个字节都不改 （从来也没有压缩过，
adb push 是逐字节拷贝）。
★关掉它并不会变快。 2026-08-11 实测：抹不抹位置，收完后的处理时间一样
（27MB 视频都是 5.2～5.3 秒，桌面端根本不抹也是 5.0～5.9 秒）——
那几秒是 adb push 进手机 + 手机自己建相册索引 ，是手机端的活。
抹位置本身只扫视频头部那几个原子，不碰码流，几乎不花时间。
开着的意义是防风控 ：员工在家用自己手机拍的视频里带着家里的 GPS ，
传进实例手机再发抖音/小红书，平台读得到那个坐标，和账号常驻地对不上。
哪天发现这类问题，改成「抹掉」即可，≤30 秒全部盒子生效 ，不用改代码发版。
这台实例机自己拍的 ——机型用它真实型号、
坐标用它 SK5 出口那个城市。）
员工上传的视频：
不处理，原样传（默认）
抹掉视频里的位置/机型
安全 / 登录
强制两步验证 :开启后,没绑定 Authenticator 的账号一律不能登录 (密码对也不行),逼员工必须绑 2FA。绑定由管理员在『账号 / 安全』里点账号后面的「绑定验证器」当场完成。⚠️ 开启前先确认你自己(管理员)已经绑好 2FA(列表里显示 🔒 已绑) ,否则会把自己也锁在外面。
强制两步验证:
关（可只用账号密码登录）
开（没绑 Authenticator 不能登录）
黑名单 feed
备份 / 恢复
这台机器上有两样东西丢了就是灾难:中台库 (手机绑定 / 口 / 线路 / 员工 / 账号)和
netbird 身份库 (丢了 34 台设备全部要重刷),外加运维私钥 (丢了就再也 SSH 不进任何设备)。
服务器加到几台都挡不住这个,只有备份能。"以为有" —— 所以下面这条状态条只认
全项校验通过且零报错 的那次;差一项就当没备成。
读取中…
📜 备份台账
「行数」是备份当时库里的 手机/口/线/分配 四个数 —— 恢复演练时拿它对得上,才算这份备份真的能用。
「外送」为空表示只有本机一份 ,这台机器一死就全没了。
🔐 外送备份的加密口令
本机那份不加密 (有 root 的人本来就什么都拿得到,而把口令只存在这台机器上,
这台机器一死所有备份就都成了废纸 —— 这是备份方案里最经典的坑);推到别处的那份才加密 。
★所以这个口令要抄到平台之外 (密码管理器 / 纸上),否则它保护的正是"这台机器没了以后"的那份备份。
👁 显示口令(会记一条审计)
保存设置
（6 个标签的改动一起保存）
