云手机ADB调试入门，星界白名单安全连接指南
——远程调试、日志抓取、CI 自动化，一台星界云手机全搞定

“远程调试连不上”“日志一抓就断”“CI 机房里堆了一百根数据线”——这是过去三年里，某出海社交 App 测试组在 Jenkins 日报里出现频率最高的三句吐槽。云真机方案迭代到第三代，他们终于把最后一根数据线拔掉：全部迁移到星界云手机，用 ADB over IP 完成 7×24 小时无人值守测试。今天这篇入门指南，把踩坑笔记一次性公开，让你 10 分钟复制同款流程。

一、开发者到底需要怎样的“云真机”

1. 远程调试：本地 Android Studio 一键 attach，断点、性能剖析、内存 Dump 全部生效，就像 USB 线插在机房里。
2. 日志抓取：Logcat 实时回传，支持按 TAG/Level 过滤，Crash 瞬间自动归档到 ELK。
3. 自动化测试：Airtest、UiAutomator、Appium 脚本零改造，直接瞄准云手机 IP；Jenkins Pipeline 里加一行 adb connect 就能并行 50 台。

市面上不少“云真机”把 ADB 端口锁在私有网段，开发者只能隔着 Web 鼠标点点点；星界云手机则把 5555 端口完全开放，并配上“IP 白名单 + 密钥签名”双因子，既给足自由度，又把攻击面缩到最小。

二、星界云手机的 ADB 安全模型

• 开放端口：每台云手机独立 5555 端口，默认关闭，由用户主动开启。
• IP 白名单：支持 30 条 IPv4/IPv6 地址或 CIDR 段，跨账号共享同一数据中心，改一次全局生效。
• 密钥签名：开启时自动生成 2048-bit RSA 密钥，本地 adb connect 需匹配公私钥，杜绝中间人伪造。

一句话总结：只有“你指定的电脑 + 你手里的密钥”才能摸到云手机的 ADB，公网扫描器再勤快也只能对着 5555 端口干瞪眼。

三、三步完成首次连接

1. 控制台一键开门
   登录星界云手机官网→【云手机】→勾选设备→【更多操作】→【ADB 连接】→【开启】。在弹出框里填入本机公网 IP（访问 ip138 即可查看），保存后系统会自动下发密钥到“下载中心”。

2. 本地密钥签名
   把下载的 star_adb_key 放入 ~/.android/ 目录，执行
   adb kill-server adb start-server adb connect <云手机IP>:5555
   首次握手会提示 * daemon started successfully *，随后设备列表里出现 emulator-5555 device，代表通道已加密打通。

3. 验证速度与稳定性
   adb shell getprop ro.product.model adb logcat -c && adb logcat -s Unity | head
   日志秒级回传，延迟稳定在 30-50 ms（北京联通 → 星界华北三机房），已经媲美本地 USB 3.0。

四、直接嵌入现有 CI/CD

星界云手机提供固定内网 IP 与端口映射，Jenkins 侧只需在 Pipeline 里加两行：

stage('Connect StarCloud') {
    sh "adb connect ${params.STAR_IP}:5555"
}
stage('Airtest Run') {
    sh "airtest run case.air --device Android://${params.STAR_IP}:5555"
}

测试报告、截图、日志通过 adb pull 回传到工作区，再归档到 Artifactory，全程无需人工插拔。

如果你用 GitHub Actions，可以把密钥存成 Secret，配合 matrix 策略一次性并行 20 台云手机，i9 本地编译机都省下了。

五、32 GB 大容量，大型调试包随便推

很多云真机为了“省存储”只给 8 GB，一装《原神》+ SDK 就爆红。星界全系列标配 32 GB eMMC，GPU 加速版更支持 400 MB/s 顺序写，把 2 GB 的调试 SO 包 adb push 进去只需 7 秒，Profile 时再也不用担心“No space left on device”。

六、型号怎么选？一张表看懂

七、免费体验通道

注册账号后，在星界云手机官网联系在线客服，报暗号“ADB 试玩”，即可获得 1 天普通版使用权，足够跑完一条自动化脚本。如果想直接上尊享版，销售也支持按小时计费，最低 0.5 元起，CI 验证成本几乎忽略不计。

八、结语

当“云真机”还在纠结要不要给你 ADB 权限时，星界云手机已经把端口、白名单、密钥、32 GB 存储一次性配齐；当本地 USB hub 插到第 16 口开始供电不稳时，星界的云手机还在机房 7×24 为你跑 Monkey。
拔掉最后一根数据线，从 adb connect 开始，让测试回归代码，让开发者回归创意——下一条崩溃日志，也许就在你读完这篇指南时，已经被星界云手机自动归档、分析、告警，并生成了修复建议。