安全必读，你准备好了吗？

使用前必须仔细阅读并严格遵守所有安全须知，操作前确认满足全部前提条件，确保自身及他人安全。

在开始之前，请务必理解并注意以下几点：

1. ADB 是什么？ ADB (Android Debug Bridge) 是 Google 官方提供的强大命令行工具，主要用于开发者在电脑上调试和管理 Android 设备（手机、平板等），它允许执行高级操作，如安装/卸载应用、访问系统文件、抓取日志、修改系统设置等。
2. 高风险操作： 使用 ADB 命令，尤其是涉及系统 (su, rm, mount 等) 或敏感权限 (pm grant, settings put 等) 的命令，具有极高风险，错误的命令可能导致：
   • 应用程序崩溃或数据丢失。
   • 系统功能异常（如Wi-Fi、蓝牙失效）。
   • 设备变砖（无法启动）。
   • 安全漏洞（如果授予了恶意应用过高权限）。
3. 目标受众： 本指南主要面向具备一定技术背景的 Android 开发者、高级用户或热衷于深度定制的研究者。普通用户强烈不建议尝试，除非你完全理解每个命令的含义和潜在后果,并愿意承担风险。
4. 责任自负： 按照本指南操作产生的任何后果（包括设备损坏、数据丢失）需自行承担，操作前务必备份重要数据。
5. 必要条件：
   • 一部 Android 手机（通常需要 Android 5.0 Lollipop 或更高版本，部分方法要求 Android 11+）。
   • 手机已开启 USB 调试模式 (Developer Options > USB Debugging)，这是 ADB 通信的基础。
   • 强烈建议： 一部电脑（Windows, macOS, Linux）并已安装好对应平台的 ADB 工具，虽然本指南核心是“在手机上运行”，但初始设置（尤其是无线调试配对）通常需要电脑辅助，且电脑 ADB 是救砖的最后手段。
   • 稳定的网络连接（对于无线调试方案）。
   • 可选：OTG 转接线（对于有线自调试方案）。

核心概念：在手机上运行 ADB 命令的本质

传统上，ADB 是在电脑上运行 (adb.exe 或 adb)，通过 USB 或网络连接到手机执行命令，要在手机自身上运行 ADB 命令,意味着我们需要：

1. 在手机上安装 ADB 二进制文件： 将电脑上的 adb 可执行文件放到手机的某个目录（如 /data/local/tmp）。
2. 在手机上获得一个 Shell 环境： 需要一个终端模拟器 App（如 Termux）来输入和执行命令。
3. 让手机上的 ADB 连接到自身（或网络上的其他设备）： 这是最关键的步骤，ADB 设计是 Client-Server 架构，我们需要在手机上启动 ADB 服务器 (adb start-server)，然后让手机上的 ADB 客户端 (adb -s ... shell) 连接到这个服务器，通常需要指定目标设备的 IP 地址和端口（即手机自身的无线调试端口）。

使用无线调试 (Android 11+ 推荐)

这是目前最主流、相对便捷且无需额外线缆（除初始配对外）的方法，要求手机系统为 Android 11 (API 30) 或更高。

步骤详解：

1. 在手机上启用开发者选项和 USB 调试：

   • 进入 设置 > 关于手机 > 连续点击 版本号 7 次，直到提示“您现在是开发者！”。
   • 返回 设置 > 系统和更新 > 开发者选项 (或在 设置 中直接搜索)。
   • 开启 USB 调试 (USB Debugging)。
   • 找到并开启 无线调试 (Wireless Debugging)。

2. 使用电脑进行初始配对 (关键步骤)：

   • 确保手机和电脑连接到同一个 Wi-Fi 网络。
   • 在电脑上打开命令提示符 (CMD) 或终端 (Terminal)。
   • 输入 adb devices 查看设备（此时应无设备或显示未授权）。
   • 在手机的 无线调试 设置界面，找到并点击 使用配对码配对设备 (Pair device with pairing code)，记下显示的 IP 地址:端口 和 6 位配对码。
   • 在电脑上输入命令：adb pair <IP地址:端口> <配对码> (adb pair 192.168.1.100:40431 123456),成功后会有提示。
   • 配对成功后，再次在手机的 无线调试 设置界面，找到 已配对的设备 列表，确认电脑已列出，同时记下设备下方显示的 IP 地址:端口（这是用于连接的端口，可能与配对端口不同）。

3. 在手机上安装终端和 ADB 二进制：

   • 从 Google Play 商店安装 Termux，这是一个强大的终端模拟器和 Linux 环境。
   • 打开 Termux。
   • 更新包列表：pkg update
   • 安装必要的工具：pkg install wget (用于下载)
   • 下载 ADB 二进制： 你需要找到与你的手机 CPU 架构 (通常是 arm64-v8a) 兼容的 ADB 二进制文件，一个相对可靠的来源是 https://github.com/rendiix/termux-adb-fastboot 提供的预编译包（注意：第三方来源需自行甄别风险）。
     • 在 Termux 中，使用 wget 下载：wget https://github.com/rendiix/termux-adb-fastboot/releases/download/v33.0.3/adb-android11-arm64-v8a.zip (版本和架构请根据实际情况替换，访问项目页面查看最新)。
     • 解压：unzip adb-android11-arm64-v8a.zip
     • 将解压出的 adb 文件移动到 Termux 的 $PREFIX/bin 目录使其可执行：mv adb $PREFIX/bin && chmod +x $PREFIX/bin/adb
     • 验证：adb --version 应输出版本信息。

4. 在手机上连接自身 (ADB over WiFi – Local)：

   • 确保手机的 无线调试 功能保持开启。
   • 在 Termux 中，输入：adb connect <手机自身的IP地址>:<无线调试连接端口> (这个端口就是你在第 2 步最后记下的那个连接端口，adb connect 192.168.1.100:40589)。注意：这里的 IP 是手机在 Wi-Fi 网络中的 IP，端口是无线调试设置里显示的用于连接的端口，不是配对的端口。
   • 连接成功后，会显示 connected to <IP:端口>。
   • 关键一步：授权连接。 你的手机屏幕上会弹出一个“允许 USB 调试？”的提示框，询问计算机的 RSA 密钥指纹。务必勾选“始终允许”，然后点击“允许”，这是让手机上的 ADB 客户端信任手机上的 ADB 服务器。

5. 在手机上运行 ADB 命令：

   • 你可以在 Termux 中像在电脑上一样使用 adb 命令了！
     • 查看已连接设备：adb devices (应该会列出 0.0.1:<端口> 或 <手机IP>:<端口> 的设备，状态为 device)。
     • 进入设备的 Shell：adb -s <设备标识符> shell (adb -s 192.168.1.100:40589 shell)，进入后提示符通常会变成 设备型号:/ $ 或 设备型号:/ # ( 表示普通用户权限， 表示 root 权限，需要额外获取)。
     • 直接在 Shell 里执行命令（如 ls /sdcard, pm list packages 等）。
     • 不进入 Shell 直接执行单条命令：adb -s <设备标识符> shell <命令> (adb -s 192.168.1.100:40589 shell pm list packages | grep google)。

使用 Termux 和 ADB (无需电脑配对 – 更复杂)

此方法尝试完全在手机上完成，不依赖电脑进行无线配对，但步骤更繁琐，且对系统版本和权限要求更高（通常需要 root 或更复杂的配置）。仅作介绍，不推荐新手使用。

1. 安装 Termux 和 ADB 二进制： 同方法一第 3 步。
2. 在 Termux 中启动 ADB 服务器： adb start-server，如果成功，adb devices 可能会显示 List of devices attached 但为空，或者显示 * daemon started successfully。
3. 获取 USB 调试端口： 这是难点，传统方式需要 setprop 设置服务端口，但普通用户无权限，Root 用户可能尝试 setprop service.adb.tcp.port 5555 stop adbd; start adbd，非 Root 用户极其困难，可能需要利用 settings 命令（如果系统允许）或寻找其他漏洞，风险极高且不稳定。
4. 连接自身： 如果第 3 步成功设置了端口（如 5555），则在 Termux 中尝试 adb connect 127.0.0.1:5555。
5. 授权： 同样需要处理授权弹窗（如果出现）。
6. 运行命令： 同方法一第 5 步。

使用 OTG 线和 ADB (有线自调试 – 较少用)

此方法需要手机支持 USB OTG (On-The-Go) 功能，并有一根 OTG 转接线（或 C to C 线 + 适配器）。

1. 安装终端和 ADB 二进制： 同方法一第 3 步（在 Termux 中安装好 adb）。
2. 物理连接： 使用 OTG 线将手机连接到自身，这听起来奇怪，但技术上可行（一端插手机充电口，另一端通过 OTG 转接插到手机的数据口？实际操作困难且非标准），更可行的场景是：手机A (运行ADB命令) 通过 OTG + USB线 连接到手机B (被调试)，这里我们讨论的是手机A调试手机A自身，此方法在实际操作中非常别扭且不推荐，仅作理论提及，连接后，手机A可能会提示“USB 连接方式”，选择“文件传输”或“仅充电”通常不影响调试,关键是USB调试已开。
3. 在 Termux 中启动 ADB 服务器： adb start-server。
4. 查找设备： 尝试 adb devices，如果连接成功且授权过，设备可能会列出（通常显示为一个长串序列号）。
5. 运行命令： adb -s <序列号> shell 或 adb shell (如果只有一个设备)。

常见问题解答 (FAQ)

• Q：为什么我需要在手机上运行 ADB？电脑不是更方便吗？
  A：确实，电脑是首选，但在没有电脑可用、需要编写自动化脚本在手机端运行、或进行一些特殊研究/调试场景时，手机端运行 ADB 有其价值。强烈建议优先使用电脑。
• Q：adb devices 显示 unauthorized 怎么办？
  A：这表示设备未授权连接，确保手机屏幕上弹出了“允许 USB 调试”的提示，并勾选“始终允许”后点击“允许”，如果没弹出，尝试断开 (adb disconnect) 再重新连接 (adb connect ...)，或者重启手机和 Termux 的 ADB 服务 (adb kill-server; adb start-server)。
• Q：连接时提示 cannot connect to <IP:Port>: Connection refused？
  A：1. 确认手机的无线调试功能是否保持开启，2. 确认你输入的 IP 和端口是否正确（是无线调试设置里显示的连接端口，不是配对端口），3. 确认手机和运行 Termux 的手机（如果是自身连接）处于同一 Wi-Fi 网络，4. 尝试在手机上关闭再重新打开无线调试开关，5. 防火墙或路由器设置有时会阻止端口,尝试更换网络环境。
• Q：进入 adb shell 后提示符是 不是 ，很多命令没权限？
  A： 表示普通用户权限，要执行需要 root 权限 () 的命令，你的手机必须已经获得 root 权限 (如 Magisk)，并且在 adb shell 后需要输入 su 命令来切换。Root 操作风险极高，会失去保修，且操作不当极易变砖，请极度谨慎。
• Q：下载的 ADB 二进制在 Termux 里运行报错？
  A：最常见原因是 CPU 架构不匹配，确认你下载的是否是 arm64-v8a (绝大多数现代手机) 或 armeabi-v7a (较旧32位手机) 版本，使用 uname -m 在 Termux 里查看架构，也可能是文件损坏或权限问题 (chmod +x adb)。
• Q：操作失误导致手机出问题了怎么办？
  A：1. 强制重启：长按电源键（可能需要结合音量键，不同机型不同），2. 尝试进入 安全模式 卸载最近安装的可能有问题的应用，3. 如果系统损坏严重，可能需要使用电脑 ADB 尝试救砖（如 adb sideload 刷 OTA 包），或进入 Recovery 模式 进行恢复出厂设置/刷机。严重变砖可能需要售后或专业维修，再次强调备份的重要性！

总结与再次强调

在手机上运行 ADB 命令是一项高级技术操作，主要服务于开发者、极客和研究目的。方法一（无线调试 + Termux）是相对最可行和推荐的方案，但依然依赖电脑进行初始配对。 整个过程涉及风险,务必：

• 透彻理解每个命令的作用。
• 操作前备份所有重要数据。
• 仅在必要时进行，并做好承担风险的准备。
• 优先使用电脑进行 ADB 操作。

希望这篇详细的指南能帮助有需要的用户安全、有效地完成目标，技术探索充满乐趣,但也请时刻保持谨慎。

引用与参考说明：

• Android 开发者官方文档 (Android Developers): ADB 的权威定义、基础命令和无线调试说明均参考自官方文档 (https://developer.android.com/studio/command-line/adb)，这是最核心、最可信的来源。
• Termux 官方文档与社区: Termux 的安装、基本使用和包管理 (pkg) 信息参考其官方 Wiki (https://wiki.termux.com/) 和社区实践，ADB 二进制在 Termux 中的安装方法参考了社区贡献的方案（如提到的 rendiix 的 GitHub 仓库）。
• XDA Developers 论坛: 作为全球最大的 Android 开发者与高级用户社区，XDA 上的众多讨论帖和教程为理解在手机上运行 ADB 的各种方法（包括无线调试细节、疑难解答、Root 相关操作的风险警示）提供了宝贵的实践经验和案例参考,具体技术细节和解决方案常源于此社区的专家贡献。
• 技术博客与经验分享 (甄别使用): 在撰写过程中，参考了多个技术博客对特定步骤（如无线调试配对过程、Termux 配置）的详细图文解说，以力求步骤清晰易懂,这些来源已通过交叉验证其内容与官方文档及主流社区共识的一致性。