Bot.js Pro无线调试全攻略：从ADB环境配置到稳定连接实战

这类工具最值得先看的不是功能列表，而是能不能在普通环境里稳定跑起来。Bot.js Pro 这类自动化工具，如果每次测试都要插着 USB 线，效率会大打折扣。通过开启 WiFi 无线调试，让手机通过 TCP/IP 连接电脑，是提升脚本开发、测试和调试效率的关键一步。

很多人卡在第一步：要么不知道怎么开端口，要么配对码输不对，要么连上了不稳定。这篇文章就围绕“用 USB 开启 5555 端口 + 配对码连接”这个核心路径，拆解从环境准备、端口开启、配对连接到稳定使用的全流程。我会把每一步的“为什么”和“怎么做”讲清楚，特别是那些容易忽略的细节，比如不同安卓版本、鸿蒙系统的差异，以及如何确保连接稳定，避免脚本跑一半断线。

如果你正在用 Bot.js Pro、Auto.js 或类似工具做自动化，想摆脱 USB 线的束缚，或者之前尝试无线调试但总失败，那这篇实测梳理的经验应该能帮你把路走通。

1. 先搞清楚“无线调试”到底在解决什么问题

很多人一上来就找命令，但没想明白为什么要用无线调试。对于 Bot.js Pro 这类运行在手机上的自动化脚本工具，无线调试的核心价值就两点：解放物理连接和提升操作便利性。

插着 USB 线调试，有几个明显的痛点：

1. 线缆束缚：手机不能远离电脑，做长流程测试或需要移动设备的场景非常不便。
2. 端口冲突/驱动问题：不同电脑、不同 USB 口、不同品牌的手机驱动，可能导致 ADB 设备识别不稳定，时有时无。
3. 同时调试多台设备：如果需要用 Bot.js Pro 控制多台手机，每台都插一根线，桌面会非常混乱，管理也麻烦。

无线调试通过 TCP/IP 网络连接，完美避开这些问题。一旦设置成功，手机和电脑只要在同一个局域网内，就能像连接了 USB 一样使用 ADB 命令和 Bot.js Pro 的调试功能。你可以把手机放在任何地方运行脚本，也可以轻松切换不同的测试机。

但这里有个关键前提：首次开启无线调试，通常仍需借助一次 USB 连接。这就是“USB 开启 5555 端口”的由来。它是一个“引导”步骤，目的是在手机上打开一个网络调试端口（默认 5555），让电脑能通过网络找到并连接它。后续只要手机不重启且 IP 不变，就可以完全脱离 USB 线。

所以，整个流程的逻辑是：USB 线（第一次） -> 开启网络端口 -> 无线连接（后续无数次）。理解了这个，就不会再困惑为什么教程总说“先用 USB 连一次”。

2. 环境准备：别在驱动和 ADB 工具上栽跟头

无线调试的失败，十有八九出在环境准备阶段。很多人电脑上的 ADB 环境是残缺的，或者手机驱动没装对。下面这个清单，建议你逐一核对。

2.1 电脑端：ADB 工具与路径

ADB（Android Debug Bridge）是连接电脑和安卓/鸿蒙设备的桥梁。Bot.js Pro 底层也是通过 ADB 与手机通信的。

1. 获取 ADB 工具包：最简单的方法是下载 Android SDK Platform-Tools。你可以从安卓开发者官网或可靠的镜像站获取。解压后，你会得到 adb.exe、fastboot.exe 等文件。
2. 配置系统环境变量（关键步骤）：为了让命令行在任何目录都能调用 adb，需要将 ADB 工具所在目录添加到系统的 PATH 环境变量中。
   • Windows：右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。在“系统变量”中找到 Path，编辑，新建一条，填入你的 ADB 工具目录（例如 C:\platform-tools）。
   • macOS/Linux：将工具包解压到某个目录（如 ~/Library/Android/sdk/platform-tools），然后在 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）末尾添加一行：export PATH=$PATH:~/Library/Android/sdk/platform-tools，然后执行 source ~/.bashrc。
3. 验证 ADB 安装：打开命令行（Windows 用 CMD 或 PowerShell，macOS/Linux 用 Terminal），输入 adb version。如果显示出版本号（如 Android Debug Bridge version 1.0.41），说明配置成功。

注意：有些 Bot.js Pro 的集成环境自带 ADB，但版本可能较旧或与你的系统不兼容。我建议使用独立的、较新版本的 Platform-Tools，并在系统环境变量中配置，这样最可靠。

2.2 手机端：开发者选项与 USB 调试

这是让手机接受调试指令的前提。

1. 开启开发者选项：
   • 安卓/鸿蒙通用：进入手机“设置” -> “关于手机”，连续点击“版本号”7次，直到出现“您已处于开发者模式”的提示。
2. 开启 USB 调试：
   • 返回“设置”，找到新出现的“系统和更新” -> “开发人员选项”（或直接在设置搜索“开发者”）。
   • 找到“USB 调试”选项，打开它。手机会提示“允许USB调试吗？”，这是安全警告，正常。
3. 连接电脑并授权：
   • 用 USB 数据线连接手机和电脑。务必使用能传输数据的数据线，有些充电线只能充电。
   • 手机端会再次弹出“允许USB调试吗？”的对话框，勾选“始终允许使用这台计算机进行调试”，然后点击“确定”。这一步至关重要，它建立了电脑对手机的调试信任。

2.3 验证基础 USB 连接

在命令行中，输入 adb devices。你应该能看到类似以下的输出：

这表示你的手机已经被 ADB 识别。如果显示 unauthorized，说明你没在手机上点击“确定”授权。如果什么都没显示，检查数据线、USB 口、手机驱动（Windows 可能需要安装对应品牌的手机驱动）。

只有 adb devices 能稳定列出你的设备，才能进行下一步。 这是所有无线调试的基石。

3. 核心操作：通过 USB 开启 5555 端口并连接

现在来到了最核心的环节。我们的目标是：通过现有的 USB 连接，在手机上启动一个网络服务（监听 5555 端口），然后让 ADB 通过网络连接到这个服务，最后拔掉 USB 线。

3.1 步骤一：查询手机 IP 地址

手机和电脑需要在同一个局域网（连接同一个路由器或热点）。先获取手机的局域网 IP。

• 方法 A（通过 ADB 命令）：在电脑命令行输入：
  BASH 复制

  1

  adb shell ip addr show wlan0
  在输出信息中，找到 inet 后面跟着的 IP 地址，通常是 192.168.x.x 或 10.x.x.x 的格式。如果 wlan0 没信息，可以试试 adb shell ip addr show rmnet0（数据网络）或 adb shell ifconfig。
• 方法 B（在手机设置中查看）：进入手机“设置” -> “WLAN”，点击当前连接的 Wi-Fi 网络，详情里会显示 IP 地址。

记下这个 IP 地址，假设它是 192.168.1.100。

3.2 步骤二：通过 USB 设置手机监听 TCP/IP 端口

这是最关键的一步。在电脑命令行执行：

这条命令通过当前的 USB 连接，告诉手机：“请重启 ADB 守护进程，并切换到 TCP/IP 模式，监听 5555 端口”。

如果成功，命令行会显示 restarting in TCP mode port: 5555。这意味着手机上的 ADB 服务已经准备好接受网络连接了。

常见问题：

• 命令没反应或报错：回到上一步，再次确认 adb devices 是否列出了你的设备且状态为 device。确保 USB 调试授权已完成。
• 端口占用：5555 是默认端口，极少被占用。如果冲突，可以换成其他端口，如 adb tcpip 5566，但后续连接命令也要对应修改。

3.3 步骤三：拔掉 USB 线，尝试无线连接

现在可以物理上拔掉 USB 数据线了。在电脑命令行，使用刚才记下的手机 IP 地址和端口进行连接：

如果连接成功，你会看到 connected to 192.168.1.100:5555。

再次输入 adb devices 验证，你应该会看到两个设备条目（如果之前 USB 没拔，可能会看到一个 USB 和一个网络设备）：

状态为 device 就表示无线连接已建立。

3.4 步骤四：配对码连接（Android 11/鸿蒙及更高版本的安全机制）

从 Android 11 开始，谷歌引入了更安全的无线调试配对机制。鸿蒙系统也继承了这一机制。如果你的手机系统较新，直接执行 adb connect 可能会失败，提示需要配对。

这时流程略有不同：

1. 启用无线调试：在手机“开发者选项”中，找到“无线调试”选项，打开它。
2. 使用配对码配对：打开“无线调试”后，手机会显示一个 IP 地址、端口号和六位数的配对码（Pairing code）。例如：192.168.1.100:37173，配对码 123456。
3. 在电脑端进行配对：在电脑命令行，使用 adb pair 命令：
   BASH 复制

   1

   adb pair 192.168.1.100:37173
   执行后，命令行会提示 Enter pairing code:，输入手机上显示的六位数配对码（如 123456）。
4. 配对成功：如果配对码正确，会显示 Successfully paired to 192.168.1.100:37173。
5. 进行连接：配对成功后，“无线调试”页面会刷新，显示一个用于连接的端口号（通常与配对端口不同），例如 192.168.1.100:41237。使用这个地址进行连接：
   BASH 复制

   1

   adb connect 192.168.1.100:41237

配对机制的核心：adb pair 是一次性的信任建立，类似于 USB 连接时的“允许调试”弹窗。配对成功后，只要不重置手机的网络设置或开发者选项，后续连接只需要 adb connect 即可，无需再次配对。

重要提示：对于较新的系统，我建议始终先走配对流程。即使 adb tcpip 5555 的方式有时也能用，但配对方式更标准、更稳定，是官方推荐的做法。

4. 连接 Bot.js Pro 并进行稳定化设置

无线 ADB 连接成功后，Bot.js Pro 就可以像使用 USB 连接一样使用了。但为了让体验更稳定，还需要注意以下几点。

4.1 在 Bot.js Pro 中连接设备

1. 确保 Bot.js Pro 已启动，并且其使用的 ADB 路径与你配置的系统 ADB 是同一个（或者 Bot.js Pro 能自动发现系统 ADB）。
2. 在 Bot.js Pro 的设备连接界面，你应该能看到一个以 IP 地址和端口号命名的设备（如 192.168.1.100:5555），选择它进行连接。
3. 连接成功后，你就可以像往常一样部署、运行和调试你的自动化脚本了，完全无需 USB 线。

4.2 确保连接稳定的几个关键点

无线连接最怕不稳定，脚本跑到一半断连就前功尽弃。

1. 网络环境：确保手机和电脑连接的 Wi-Fi 信号稳定。尽量避免使用公共 Wi-Fi 或信号很弱的网络。如果条件允许，让手机和电脑连接同一个 5GHz Wi-Fi 频段，延迟更低。
2. 手机 IP 地址变化：大多数家庭路由器默认会给设备分配动态 IP（DHCP）。如果手机重启或长时间离线，IP 地址可能会变。一旦 IP 变了，之前的 adb connect 地址就失效了。
   • 解决方案：在路由器后台，为你手机的 MAC 地址设置静态 IP 绑定（也叫 IP 与 MAC 地址绑定）。这样手机每次连接 Wi-Fi 都会获得同一个 IP 地址，一劳永逸。
3. ADB 连接超时与保持：无线 ADB 连接可能因网络波动或系统休眠而断开。
   • 解决方案：可以写一个简单的守护脚本，定时检查连接状态，如果断开则自动重连。或者，在 Bot.js Pro 运行重要长脚本前，手动执行一次 adb devices 确认连接状态。
4. 手机休眠：手机锁屏进入深度休眠后，Wi-Fi 和调试服务可能被系统限制。
   • 解决方案：在手机“开发者选项”中，开启“保持唤醒状态”（充电时屏幕常亮）和“不锁定屏幕”。对于自动化测试，可以确保手机在测试期间不会熄屏休眠。

4.3 编写自动化连接脚本（进阶）

如果你经常需要连接多台设备，手动输入命令很麻烦。可以编写一个简单的批处理脚本（Windows）或 Shell 脚本（macOS/Linux）来自动化这个过程。

例如，一个简单的 Windows 批处理脚本 connect_wifi.bat：

对于配对模式，脚本可以稍作修改，将配对和连接步骤串联起来。这能极大提升效率，尤其是在需要管理多个测试机时。

5. 故障排查：当连接失败时应该按什么顺序检查

即使按照步骤操作，也可能遇到问题。不要慌，按以下顺序排查，大部分问题都能解决。

5.1 排查顺序清单

1. 基础 USB 连接是否正常？

   • 执行 adb devices，确认设备列表中存在且状态为 device。如果不是，检查 USB 线、驱动、手机授权。

2. 手机和电脑是否在同一网络？

   • 分别检查手机和电脑的 Wi-Fi 连接，确认它们连接到同一个路由器/热点，并且子网掩码一致（例如都是 192.168.1.x）。

3. 防火墙是否阻止了连接？

   • 电脑防火墙：临时关闭电脑的防火墙（包括 Windows Defender 防火墙或第三方安全软件），测试连接。如果成功，则需要为 ADB（adb.exe）或相关端口（5555）添加防火墙入站规则。
   • 手机/路由器防火墙：一般家庭网络无需设置，但某些企业网络或特殊路由器可能屏蔽内部设备间的某些端口连接。

4. 端口是否正确开启？

   • 对于 adb tcpip 方式，确保执行了 adb tcpip 5555 并看到成功提示。
   • 对于配对方式，确保在手机“开发者选项”中打开了“无线调试”，并且使用的是正确的配对端口和连接端口。

5. IP 地址是否正确？

   • 确认你使用的 IP 地址是手机在当前 Wi-Fi 下的局域网 IP，而不是公网 IP 或蓝牙 IP。用 adb shell ip addr show wlan0 或手机设置里查看最准确。

6. 系统版本与配对要求

   • 对于 Android 11 / 鸿蒙 3 或更高版本，优先使用配对模式 (adb pair)。旧版的 adb tcpip 方式可能被系统安全策略阻止。

7. ADB 版本是否过旧？

   • 执行 adb version。建议使用较新的 Platform-Tools（版本 30 以上），以更好地支持新系统的配对功能。

8. 尝试重启服务

   • 在电脑端：adb kill-server 然后 adb start-server。
   • 在手机端：关闭再重新打开“USB 调试”和“无线调试”开关。

5.2 常见错误信息与解决

• cannot connect to 192.168.1.100:5555: 由于目标计算机积极拒绝，无法连接。 (10061)

  • 原因：手机的 5555 端口服务没有启动。可能是 adb tcpip 5555 未成功执行，或者手机重启后服务未恢复。
  • 解决：重新用 USB 连接手机，执行 adb tcpip 5555。对于新系统，改用无线调试配对模式。

• failed to authenticate to 192.168.1.100:5555

  • 原因：连接认证失败。可能之前配对信息已失效。
  • 解决：在电脑上，删除旧的认证密钥。前往 C:\Users\[你的用户名]\.android（Windows）或 ~/.android（macOS/Linux），删除或重命名 adbkey 和 adbkey.pub 文件（注意：这会清除所有已保存的 ADB 密钥，需要重新授权所有设备）。然后重新进行配对或连接。

• device offline

  • 原因：设备无响应。通常是由于网络不稳定或手机端 ADB 服务异常。
  • 解决：检查网络，重启手机上的“无线调试”开关，或重启手机。在电脑端执行 adb disconnect 192.168.1.100:5555 后重连。

• more than one device/emulator

  • 原因：当前有多个设备（包括 USB 和网络）连接到 ADB，命令未指定目标设备。
  • 解决：在 adb connect 等命令中，使用 -s 参数指定具体设备序列号（即 adb devices 列出的那一串），例如 adb -s 192.168.1.100:5555 shell。

6. 无线调试的边界与长期使用建议

无线调试不是万能药，它有明确的适用边界。理解这些，能帮你决定在什么场景下用它，以及如何用好它。

6.1 适用场景与不适用场景

• 非常适合：

  • Bot.js Pro/Auto.js 脚本开发与调试：频繁修改代码、测试功能，无线连接极大提升效率。
  • 多设备并行测试：用一台电脑控制多台手机运行自动化任务，桌面整洁。
  • 需要手机移动的测试：例如测试蓝牙连接、GPS 定位等需要物理移动手机的脚本。
  • USB 口紧张或接触不良：电脑 USB 口不够用，或者数据线/接口老化。

• 不太适合或需注意：

  • 刷机、线刷等底层操作：这些操作必须依赖稳定的物理 USB 连接，无线连接风险极高。
  • 网络环境极差：Wi-Fi 信号不稳定或延迟高，会导致 ADB 命令执行超时，脚本出错。
  • 传输超大文件：通过 ADB 无线传输数百兆以上的文件，速度可能远慢于 USB 3.0，且不稳定。
  • 手机电量管理：无线调试和 Wi-Fi 持续连接会比 USB 连接更耗电，长时间测试需注意手机电量。

6.2 长期使用与维护建议

1. 固定 IP 是基石：如前所述，在路由器为测试手机分配静态 IP，这是保证长期稳定连接最重要的一步。
2. 创建快捷脚本：将连接命令（包括配对命令，如果需要）写成脚本，一键执行。可以分别为每台手机创建不同的脚本文件。
3. 定期检查连接：在开始重要的自动化任务队列前，养成执行 adb devices 检查所有设备连接状态的习惯。
4. 备用方案：始终准备好一根可用的 USB 数据线。当无线连接出现无法快速解决的故障时，能立即切换回有线模式，不耽误工作。
5. 文档记录：为每台测试机记录其无线连接信息：手机型号、系统版本、分配的静态 IP、使用的连接端口（5555 或配对后的端口）。这对于团队协作或自己日后维护非常有帮助。

我个人更建议，在初次为 Bot.js Pro 设置无线调试时，不要追求一步到位。先用一台手机、一个稳定的家庭 Wi-Fi 环境，把整个流程（USB授权 -> 开启端口/配对 -> 无线连接 -> Bot.js Pro 识别）完整走通。把这个流程摸熟后，再扩展到多台设备、固定 IP、编写自动化脚本等进阶操作。很多问题之所以复杂，是因为在基础环节没打通时就引入了太多变量。先确保单点稳定，再构建你的无线自动化网络。