Shizuku如何开启ADB TCP/IP模式？

Question

**问题：如何在Shizuku环境下通过ADB启用TCP/IP模式进行无线调试？** 在使用Shizuku进行ADB调试时，部分用户希望将设备切换至ADB over TCP/IP模式，以实现无线调试目的。然而，由于Shizuku依赖于ADB授权机制，切换至TCP/IP模式后可能导致ADB连接断开，从而影响Shizuku服务的正常运行。常见的疑问包括：是否可以在Shizuku中安全启用ADB TCP/IP模式？如果可以，应如何正确配置设备和Shizuku以确保ADB连接稳定？此外，部分用户反馈在执行`adb tcpip`命令后Shizuku无法检测到ADB授权，应如何解决？请结合ADB调试原理与Shizuku工作机制，提供可行的解决方案。

Answer 1

一、背景与问题概述

Shizuku 是一个为 Android 提供免 Root 使用 ADB 权限的工具，广泛用于调试、自动化脚本等场景。ADB（Android Debug Bridge）支持通过 USB 和 TCP/IP 两种方式进行设备连接。

在使用 Shizuku 过程中，一些高级用户希望将设备切换到 ADB over TCP/IP 模式以实现无线调试。然而，切换到 TCP/IP 模式后，ADB 的连接方式发生变化，可能导致 Shizuku 无法正常获取 ADB 授权，从而影响其功能。

二、ADB 调试机制简要解析

ADB 通信流程如下：

1. 设备启动 adbd 服务，监听在 USB 或 TCP 端口。
2. PC 端运行 adb 客户端连接 adb server。
3. adb server 与设备端 adbd 建立连接。
4. 设备首次连接时，会弹出授权提示，生成密钥对保存在 PC 和设备中。

三、Shizuku 的工作机制简介

Shizuku 通过 ADB 权限模拟 Root 环境，其依赖于 ADB 的持续连接和授权状态。其核心流程包括：

• 检测设备是否授权 ADB。
• 启动 Shizuku Manager 服务。
• 通过 ADB 启动 Shizuku Daemon。
• 提供 Binder 接口供应用调用系统级权限。

四、ADB over TCP/IP 对 Shizuku 的影响

当执行 adb tcpip <port> 命令后，设备会切换到 TCP/IP 模式并断开 USB 连接。此时可能出现以下问题：

问题	原因
Shizuku 无法检测到设备	ADB 连接中断，Shizuku Manager 失去连接
无法获取 ADB 授权	切换 TCP 模式后，未重新建立信任连接
Shizuku Daemon 启动失败	缺少持续的 ADB 会话支持

五、解决方案与步骤详解

1. 准备阶段

确保设备已启用开发者选项和 USB 调试，并通过 USB 成功连接一次以完成授权。

adb devices

确认设备显示为授权状态（显示 serial number 而非 unauthorized）。

2. 切换至 TCP/IP 模式

在 USB 连接状态下，执行以下命令切换到 TCP/IP 模式：

adb tcpip 5555

记录设备的 IP 地址：

adb shell ip route

3. 重新连接设备

断开 USB 连接后，通过 IP 地址重新连接：

adb connect <device-ip>:5555

若提示 connected to <ip>:5555，说明连接成功。

4. 保持 ADB 连接稳定

建议使用以下方式保持 ADB 连接：

• 定期执行 adb devices 以维持心跳。
• 使用脚本自动重连 ADB。

5. 启动 Shizuku 服务

在无线连接状态下，启动 Shizuku Manager：

adb install Shizuku.apk adb shell am start -n moe.shizuku.manager/.MainActivity

通过 Shizuku UI 启动服务，并确认状态为“Running”。

六、常见问题与解决建议

1. 问题：执行 tcpip 后 Shizuku 显示未授权
   解决方案：确保 USB 连接时已完成授权，并在无线连接后重新触发授权（adb kill-server && adb start-server）。
2. 问题：无法通过无线连接设备
   解决方案：检查设备与 PC 是否处于同一局域网，关闭防火墙尝试。
3. 问题：Shizuku Daemon 启动失败
   解决方案：检查日志（adb logcat）查找错误信息，确认 ADB 服务是否正常。

七、进阶建议与自动化脚本

可编写如下 shell 脚本自动完成流程：

#!/bin/bash
adb tcpip 5555
IP=$(adb shell ip route | awk '{print $3}' | cut -d'/' -f1)
adb disconnect
adb connect $IP:5555
sleep 2
adb shell am start -n moe.shizuku.manager/.MainActivity

该脚本可一键切换无线调试并启动 Shizuku。

八、流程图示意图

graph TD
A[设备 USB 连接] --> B[adb tcpip 5555]
B --> C[获取设备 IP]
C --> D[adb connect IP:5555]
D --> E{连接成功?}
E -->|是| F[启动 Shizuku Manager]
E -->|否| G[检查网络与授权]
F --> H[Shizuku 正常运行]