企业官网建设流程全解析

WSABuilds 中 adb 无法连接 localhost:58526 怎么开启开发者模式并改用 IP:5555？

【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds

在 WSABuilds（基于预构建二进制在 Windows 10/11 上运行 Windows Subsystem for Android 的方案）中，用adb connect localhost:58526连不上 WSA 是文档明确收录的常见故障。仓库文档给出了两条对应的处理路径：主路径是确认 WSA 开发者模式已开启，改用 WSA 实际 IP 加 5555 端口连接；当报错是10061（目标机器主动拒绝连接）时，则按文档中的步骤处理 Hyper-V 抢占 58526 端口的问题。适用前提是 WSA 已按 安装说明 完成安装并可以启动。

先判断你遇到的是哪一种连接失败

仓库文档记录了两种不同的现象，处理方式不同：

• 一般性连接失败：adb connect localhost:58526直接连不上。FAQ 对此的官方回答是：先确认开发者模式已开启；如果问题依旧，到 WSA 的 Settings → Developer 页面查看 WSA 的 IP 地址，改用adb connect ip:5555。
• 10061 端口被拒绝：TargetMachineActivelyRefusedConnection 一文给出的报错示例为：

cannot connect to ||127.0.0.1:58526:|| No connection could be made because the target machine actively refused it. (10061)

该文档说明此问题出现在使用 WSA-Sideloader、WSAPacman 等侧载工具，或通过 Android SDK Platform Tools 中的adb.exe连接设备时，原因是 Hyper-V 无法保留 58526 端口。文档指出这是子系统自身的 bug，重启电脑通常可以解决；重启后仍然报错时，才执行下文的端口保留步骤。

主路径：开启开发者模式，改用 IP:5555 连接

1. 在 WSA 中开启开发者模式

按 ADB-Sideloading 指南：

1. 启动Windows Subsystem for Android；
2. 点击Advanced Settings，在 Developer mode 一节点击开关开启Developer mode；
3. 记下 Developer mode 区域显示的IP address and port。

其他侧载指南中的入口描述一致：WSA 设置中的Settings → Developer页面，例如 WSAPacman 指南 要求Go to Windows Subsystem for Android → Developer and turn on Developer mode，WSA-Sideloader 指南 也可以通过在浏览器地址栏输入wsa-settings://打开 WSA 设置，选择 Developer 并启用 Developer mode。

2. 用 WSA 的 IP 加 5555 端口连接

确认 ADB 已安装后（该文档以 Android SDK Platform Tools 提供adb.exe为例），在 Windows Terminal 中执行，将ip替换为 Settings → Developer 页面看到的 WSA IP 地址：

adb connect ip:5555

FAQ 给出的原命令就是adb connect ip:5555，其中 IP 取自 WSA 的 Developer 页面。

3. 验证连接

按 ADB-Sideloading 指南 的验证方式：

adb devices

该命令用于确认 WSA 是否已成功连接。

可选分支：无线调试的 pair/connect 流程

如果走的是无线调试（Wireless debugging）流程，ADB-Sideloading 指南 给出的命令是：

adb pair <IP:port>

在 Wireless debugging 窗口查看 Device name 及其下的 IP address and port，然后：

adb connect <IP:port>

这里<IP:port>是无线调试窗口中显示的配对端口，与 FAQ 中 Developer 页面的ip:5555是两种不同的连接入口，文档均原样给出，按你的实际界面取值替换。

仍然报错 10061：按文档修复端口占用

当adb connect localhost:58526报No connection could be made because the target machine actively refused it. (10061)且重启电脑无效时，按 TargetMachineActivelyRefusedConnection 依次执行：

1. 确认 WSA 已关闭，并在 Task Manager → Startup Apps 中禁用 WSA 的开机自启，再继续后续步骤。
2. 如果 Hyper-V 当前是启用状态，先禁用它：

dism.exe /Online /Disable-Feature:Microsoft-Hyper-V

3. 重启电脑。
4. 保留 58526 端口，防止 Hyper-V 重新抢占：

netsh int ipv4 add excludedportrange protocol=tcp startport=58526 numberofports=1

5. 如果第 2 步禁用过 Hyper-V，重新启用并再次重启：

dism.exe /Online /Enable-Feature:Microsoft-Hyper-V /All

注意这几步的副作用：禁用/启用 Microsoft-Hyper-V 是 Windows 系统级功能变更，两次重启都是文档明确要求的步骤；其中第 2、5 步只在 Hyper-V 原本已启用时才需要做（文档原文即为 "if it is enabled" / "if it was previously enabled"）。

结果判定与限制

• 主路径的成功判据：adb devices确认 WSA 已连接。
• 10061 路径的成功判据：端口保留完成后，原先127.0.0.1:58526的拒绝连接报错消失（文档未给出额外的成功日志格式，以连接不再报 10061 为准）。
• 如果两条路径都无效，文档给出的后续求助渠道是 FAQ 中指向的 Issues 或社区讨论，而不是在本仓库内继续改文件。

【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds