QtScrcpy 无线连接：从 USB 到 WiFi 的完整步骤
无线连接不是“打开开关”那么简单：第一次必须先通过 USB 建立授权，再让手机在局域网上监听调试端口。本文给出界面操作与命令行两种做法，并把常见的连不上、频繁断连逐条拆开。
先确认四个前提
- 同一局域网：手机与电脑连的是同一个路由器，且处于同一网段（例如都是 192.168.1.x）。
- 关闭 AP 隔离：部分路由器默认开启“客户端隔离”，设备之间无法互访，表现为能上网但连不上手机。
- 首次需要 USB：Android 10 及以下必须先用数据线完成 RSA 授权，之后才能切无线。
- 设备已开启 USB 调试：路径为“设置 → 关于手机 → 连点版本号 → 开发者选项 → USB 调试”。
为什么不直接无线？adb 的无线模式依赖手机端的 adbd 守护进程监听 TCP 端口，而这个切换动作本身需要通过已有的调试通道下发。所以第一次总要先插线。
方法一：界面三步操作
QtScrcpy 把常用命令做成了按钮，适合不想碰命令行的人。先用数据线连接并成功启动一次画面，确认授权已完成，然后按顺序操作：
-
获取设备 IP
在设备信息区点击“获取设备 IP”，软件会读取手机在当前局域网中的地址，通常是 192.168.x.x。
-
启动 adbd
点击“启动 adbd”，等价于执行
adb tcpip 5555，让手机开始在 5555 端口监听无线调试连接。 -
无线连接并拔线
点击“无线连接”，设备列表会出现一条以 IP 和端口标识的记录。确认画面正常后再拔掉数据线。
不同版本的按钮文案可能略有差异，但逻辑一致：取 IP → 开端口 → 连过去。如果界面里没有对应按钮，用下面的命令行做法同样可以完成。
方法二：命令行 adb
QtScrcpy 自带 adb，也可以使用系统里已安装的 adb。核心只有三条命令：
# 1. 确认设备已通过 USB 连上
adb devices
# 2. 让手机在 5555 端口监听无线调试
adb tcpip 5555
# 3. 连接手机 IP（把地址换成你自己的）
adb connect 192.168.1.23:5555看到 connected to 192.168.1.23:5555 即表示成功。此时可以拔掉数据线，再次执行 adb devices，列表中应出现 192.168.1.23:5555 device。
需要断开时执行 adb disconnect 192.168.1.23:5555。想让手机恢复正常 USB 模式，执行 adb usb。
电脑上如果装了多个 adb（Android Studio、手机助手、模拟器各带一份），命令可能作用到不同版本的服务上。优先使用 QtScrcpy 目录内自带的 adb，或在 config.ini 里把 AdbPath 指向同一个可执行文件。
Android 11 及以上：无线调试配对
从 Android 11 开始，系统提供了原生的“无线调试”，可以在完全不用数据线的情况下完成配对。步骤是：
- 进入“开发者选项 → 无线调试”，打开开关。
- 点击“使用配对码配对设备”，系统会显示一个 IP、一个配对端口和六位配对码。
- 在电脑上执行
adb pair 192.168.1.23:37105，按提示输入配对码。 - 配对成功后，用无线调试页面上显示的连接端口执行
adb connect 192.168.1.23:5555。
注意配对端口和连接端口通常不是同一个，配对窗口关闭后端口会变化。手机重启后一般需要重新配对。
怎么确认连上了
| 检查项 | 正常表现 | 异常时说明 |
|---|---|---|
| adb devices | 出现 IP:5555 device | 显示 offline 或为空，见下一节 |
| QtScrcpy 设备列表 | 出现以 IP 标识的设备 | 只有 USB 设备，说明无线连接未建立 |
| 画面与操作 | 画面流动，点击有响应 | 能连上但画面卡住，多为带宽或编码问题 |
连不上、频繁断开的排查
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 提示 connection refused | 手机未监听端口，或 adbd 已退出 | 重新插线执行一次“启动 adbd”；手机重启后必须重做 |
| 提示 timed out | 不在同一网段、AP 隔离、防火墙拦截 | 核对 IP 前三段是否一致；关闭路由器客户端隔离；放行 adb 或临时关闭防火墙测试 |
| 能连上但很快掉线 | 手机休眠、Wi-Fi 省电策略、IP 变化 | 开发者选项开启“保持唤醒”；给手机固定 IP 或 DHCP 保留；关闭电池优化 |
| 列表里出现多台同名设备 | USB 与无线各注册了一次 | 拔线后刷新；必要时 adb disconnect 清掉旧连接 |
| 画面卡顿、马赛克 | 带宽不足或干扰 | 改用 5 GHz；降低分辨率与比特率；缩短与路由器距离 |
| adb 报版本不匹配 | 多个 adb 版本并存 | 结束所有 adb 进程，统一使用同一份 adb |
还有一个容易忽略的点：部分手机在“开发者选项”里提供了“默认 USB 配置”，如果被设为“仅充电”，插线后 adb 可能拿不到设备。改成“传输文件（MTP）”再试。
安全边界
“启动 adbd”之后，手机在一个 TCP 端口上接受调试连接，同一局域网内任何知道地址的设备都可能尝试接入。因此：
- 只在可信网络（家里、自己的办公网络）使用，不要在咖啡厅、酒店等公共 Wi-Fi 下开启。
- 绝对不要在路由器上为 5555 端口做端口映射，那等于把设备暴露到公网。
- 用完执行
adb usb恢复，或直接重启手机，让 adbd 退出无线监听。 - 定期在开发者选项里撤销已授权的调试设备。
常见问题
QtScrcpy 无线连接需要每次重启都重做吗？
是的。adb 的 tcpip 模式在手机重启后失效，需要重新用 USB 执行一次“启动 adbd”，或使用 Android 11 以上的无线调试重新配对。
可以不用数据线，第一次就无线连接吗？
Android 11 及以上可以，通过“无线调试 → 使用配对码配对”完成；Android 10 及以下首次必须用 USB 授权并切换 adbd。
无线连接延迟比 USB 高多少？
同一台路由器、5 GHz 频段下，无线通常比 USB 多出十几到几十毫秒，具体取决于信号质量与干扰。对延迟敏感的操作建议仍用 USB。
为什么手机换了 Wi-Fi 后就连不上了？
连接记录绑定的是旧 IP。手机重新联网后地址可能变化，需要重新获取 IP 并执行 adb connect；给手机设置 DHCP 静态地址可以避免反复操作。
