FreeControl2 连接排查：从 adb 到设备参数

FreeControl2 连接排查：从 adb 到设备参数

FreeControl2 v1.0.1 为 scrcpy 提供图形界面，可以管理设备、组合启动参数和查看日志。用它排查连接问题时，先分清运行环境、adb 连接和 scrcpy 参数三个层次，比直接反复点击连接更容易得到有效信息。

下面依次检查依赖环境、设备识别、无线地址和启动参数。示例中的手机地址和序列号需要替换为实际值；每通过一个阶段，再继续下一层。如果同时改变连接方式和多个参数，即使问题消失，也不容易还原是哪项操作起了作用。

环境检查先于设备列表

主程序并不捆绑 scrcpy 和 adb。第一次启动后应先完成环境页面的工具下载或配置，再添加设备。如果依赖没有准备好，设备列表里的连接操作也无法替代它们。排查记录可以先写清楚三个对象：FreeControl2 版本、工具配置状态、连接方式。

官方 v1.0.1 提供 Windows EXE，以及 Linux amd64 的 AppImage、deb。Windows 适用说明为 Windows 10/11 x64，ARM 通过 x64 仿真使用，同时需要 WebView2。Linux 的两个附件是不同的交付形式，不是需要依次安装的两层组件。

Windows 版本是免安装单文件，放到可写目录后直接运行，不需要再寻找安装器。第一次打开后仍要配置 scrcpy 与 adb，这与主程序是否免安装是两件事。

主项目采用 MIT 许可。这里的使用准备指选择适用的官方附件并配置依赖，不包括自行从开发资料构建应用，也不把仓库源码压缩包当成已经打包好的桌面程序。

在调整参数之前，先确认环境页面显示的工具位置与自己准备使用的位置一致。假如电脑上原来已经配置过 adb，终端里的命令和界面调用的工具是否一致，也值得在记录中区分。本文不假定所有机器的环境变量、工具版本和目录相同。

USB：先验证识别与授权

手机开启开发者选项和 USB 调试后，通过可传输数据的连接线接入电脑，并确认手机上的调试授权。只观察到充电状态，不能证明数据链路和授权已经建立。

官方使用下面的命令查看设备：

adb devices

检查目标序列号是否出现，以及设备是否已经授权。若授权尚未完成，先回到手机处理提示；如果根本没有目标设备，则继续检查线材、连接与调试设置。此时修改画面码率没有帮助，因为还没有进入投屏参数生效的阶段。

确认设备后，在 FreeControl2 中按 USB 序列号添加，并设置便于识别的别名。别名服务于列表管理，连接对象仍由序列号确定。第一次只连接这一台，记录是否能启动基本投屏，再加入第二台设备，可以减少同时变化的条件。

遇到离线状态时，应回到对应设备的连接条件检查，而不能仅凭别名判断它仍然是上次的连接对象。可以同时记录序列号和自己给出的名称，后续比较日志或参数时按同一对象检查。多台设备同时接入时，这一步也有助于避免把另一台的正常状态当成目标设备已就绪。

无线：配对地址与连接地址分别核对

传统无线方式先通过 USB 建立连接，再切换到 TCP/IP，之后连接手机地址：

adb tcpip 5555
adb connect 手机IP:5555

电脑与手机需要位于同一局域网。这里的“手机IP”需要换成当前手机的真实地址，不能按字面直接执行。先确认 USB 链路正常，再进行切换；否则无线步骤的失败可能仍来自前面的识别或授权问题。

Android 11 及以上的无线调试采用先配对、再连接的路径。手机界面提供的配对端口与实际连接端口可能不同，应分别使用对应值。已经配对不等于已连接，在配对成功后仍要核对用于连接的当前地址。

配对使用 adb pair 手机IP:配对端口，连接使用 adb connect 手机IP:连接端口；按照手机无线调试页面提供的值分别替换，先完成配对提示，再执行连接。

FreeControl2 支持用 IP:端口保存设备信息。网络变化后，保存值可能过期；重新开启无线调试后也应核对实际端口。排查时记录“当前手机显示什么”和“应用里保存什么”，比不断重试一个旧地址更有意义。

连接方式切换之后，先确认新方式能够独立连接，再继续调整其他设置。把 USB、无线、视频编码一起改动，会让一次失败同时对应多个可能原因。

启动成功后再核对视频选项

应用把常用参数组织为六个面板，并提供自定义参数、命令预览和复制。视频页可设置编码、最大尺寸、码率、帧率、裁剪、角度及缓冲等选项。它们用于调整输出行为，不能替代前面的设备授权。

先保持默认设置建立可用起点，再按问题逐项修改。画面尺寸不合适时看尺寸选项，关心更新频率时看帧率；修改之后保留原值和新值，便于回退。本文没有设备和网络测量依据，因此不提供一个声称普遍最优的参数组合。

使用自定义参数时，应查看最终组合出来的命令。界面选项和手填参数都可能影响启动行为，命令预览可以帮助核对自己到底提交了什么。复制命令用于进一步检查时，也要保留当时的设备选择，避免比较的是两台不同设备。

多设备场景还存在全局配置与设备独立覆盖。某台设备的表现与其他设备不同，先确认它是否有单独设置，不要直接认定全局选项没有保存。反过来，准备只调整一台设备时，也应明确编辑范围，避免把全局改动误当成设备局部改动。

用日志补齐问题描述

日志可以选择保留七天、三十天或永久。一次有用的问题记录，至少应包含设备、连接方式、触发动作以及对应时间附近的日志。只有一句“连接失败”，无法区分依赖缺失、设备未授权、地址变化和启动参数问题。

日志保留时间可以按排查周期选择。如果问题刚刚出现，先保留当时的信息再改配置；否则连续修改之后，即使恢复正常，也不容易知道哪项变化起了作用。需要向他人求助时，发送前应自行检查日志里是否包含不希望公开的设备信息。

配置、日志和运行时内容在 Windows 下位于 %APPDATA%/FreeControl2，Linux 使用 XDG 目录。删除配置会重置设备列表及设置，因此不应把清空配置作为未经判断的默认步骤。先保留自己的参数和设备资料，再决定是否重置。

退出 FreeControl2 不会结束 adb server。检查后台服务状态时，要把应用窗口和 adb 服务区分开；窗口关闭只能说明应用退出，不能证明相关服务都已经结束。

v1.0.1 的更新集中在提示定位与去重、链接和目录打开卡顿、Windows 11 双边框及关于页地址。排查问题时应记录实际版本，但不能把这些修复直接写成网络连接或投屏延迟的性能结论。

下载与获取

百度网盘:https://pan.baidu.com/s/1-4ChcyKBywAFoOn7infoTA?pwd=r4zz 提取码:r4zz

夸克网盘:https://pan.quark.cn/s/86c13ec1714e

官方项目：FreeControl2。进一步核对配置时，以对应版本的说明为依据。