Android 无线调试端口
5555 是 Android 设备开启无线调试后 ADB 监听的默认端口。执行 adb tcpip 5555 之后,设备会在这个端口上接受网络连接,主机用 adb connect 即可操作设备,不再需要 USB 线。自动化测试机群与云真机平台普遍依赖它,前提是首次连接时通过 USB 完成了授权。
基本信息
| 服务 | Android ADB over network |
|---|---|
| 协议 | TCP |
| 启用方式 | adb tcpip 5555(需先经 USB 授权) |
| 用途 | 无线调试、自动化测试、云真机 |
| 安全等级 | 仅受控测试网段 |
典型使用场景
- 真机无线调试,摆脱 USB 线缆束缚
- 自动化测试机群批量连接设备执行用例
- 云真机平台把设备托管后供远程调用
- 排查 adb connect 失败,确认设备是否仍处于网络调试模式
- 安全评估时确认生产与办公网段没有开放的调试端口
无线连接流程
无线连接流程
adb tcpip 5555 # 先用 USB 连接,切换到网络调试
adb connect 192.168.1.20:5555 # 主机侧连接设备
adb devices # 确认设备已连接
adb usb # 用完切回 USB 模式,关闭网络监听调试方式对比
| 方式 | 前提条件 | 说明 |
|---|---|---|
| USB 调试 | 有物理接触与授权 | 默认方式,最稳妥 |
| 无线调试 5555 | 需先经 USB 授权 | 便利,但同网段可达即可能被控制 |
| 系统无线调试配对 | 配对码流程 | 较新系统提供,安全性更好 |
| 整改建议 | 用完即关 | 不要长期保持监听状态 |
5555 开放且没有访问控制时,同一网段任何人都可以连接设备:读取应用内部资料、导出数据库、安装应用甚至截取屏幕。测试手机绝不能带着开放的调试端口接入办公或公共无线网络。
版本差异:较新的 Android 版本提供了基于配对码的无线调试方式,比直接开放固定端口更安全。条件允许时优先使用系统自带的配对流程,而不是长期开着固定调试端口。
自动化提示:批量连接前建议固定设备地址或改用系统配对流程,动态地址会随网络变化导致脚本批量失败,排查时容易被误判为设备离线。