如果你精通 Android 开发或喜欢折腾手机,迟早会遇到 ADB。这个命令行工具可以对系统进行非常深入的控制,但传统上它一直与典型的 Android 系统配置联系在一起。 USB 连接线和 USB 调试功能已启用自 Android 11 以来,这一切都发生了变化:现在可以完全无线地使用 ADB,更加方便,无需反复插拔手机。
新的无线净化系统还引入了一个过程: 使用二维码或PIN码进行安全的Wi-Fi配对本指南旨在指导您如何在 Android Studio 和命令行中使用 ADB,它将详细介绍 ADB 的工作原理、如何在 Android 11+ 中充分利用无线模式(包括自动化技巧),以及如果您使用旧版本的 Android 或 Chromebook 等特殊设备,有哪些替代方案。
什么是 ADB?为什么它比 Wi-Fi 更值得使用?
Android 调试桥,或称 Android 调试桥。 ADB 是一个控制台工具,用于创建通信通道。 在您的计算机和安卓设备之间建立连接。此通道允许执行远超普通系统界面所能提供的操作:高级应用安装和卸载(包括许多预装应用)、访问设备的 Unix shell、文件复制、屏幕截图和视频录制、系统命令、测试自动化等等。
传统上,这种沟通是通过以下方式进行的: 使用“USB调试”选项连接USB 在开发者选项中。经典的工作流程是:连接数据线,在移动设备上授权PC,从目录启动命令。 platform-tools 在电脑上操作就完成了。问题是,这需要手机在附近,还要连接线缆,而且可能存在其他问题。 电脑上的安卓设备驱动程序 而且端口也比较少,当你使用多个设备或需要四处移动时,会非常不方便。
在 Android 11 及更高版本中,可以使用 通过 Wi-Fi 使用 ADB 进行安全配对它不仅更方便,还能避免很多麻烦,例如USB驱动程序问题、端口故障,或者某些Chromebook根本不支持通过USB连接ADB等情况。此外,它还允许使用Tasker和Termux等工具,在每次手机启动时自动激活无线ADB。
如何启用开发者选项和无线调试?
在通过 ADB 连接(无论是通过有线连接还是 Wi-Fi 连接)之前,您需要启用以下功能: Android 设备上的开发者选项在 Android 11 及更高版本中,操作步骤与以往相同:进入 设置>关于手机 (o 设备信息)并找到该部分 内部编号 o 版本反复点击直到出现类似这样的信息: “你现在是一名开发者了”如果您需要更完整的解释,请参阅 如何在安卓设备上激活和掌握开发者模式.
启用这些选项后,您将能够使用主设置菜单中的内部搜索框进行搜索。 “开发者选项” 直接进入。在该部分中,您将找到解决整个问题的两个关键点: USB调试 而且,在 Android 11 或更高版本上,新的 无线调试最后一点是您需要激活的,以便无需依赖电缆即可通过 Wi-Fi 使用 ADB。
首次启用无线调试时,Android 会显示一个对话框,要求您确认使用此功能。 当前 Wi-Fi 网络被设置为允许的网络 要进行调试,请选中此复选框。 “始终允许此网络上的访问” 然后按 允许请记住,建议使用可信网络,因为对设备具有深度访问权限的命令将通过该通道传输。
在 Android 11+ 上使用 Android Studio 实现无线 ADB(二维码或 PIN 码)
如果您使用 Android Studio,从 Bumblebee 版本开始,您将拥有一个集成的向导,几乎无需触碰终端即可完成 Wi-Fi 配对。该系统 通过二维码或PIN码轻松配对 它仅适用于搭载 Android 11 或更高版本的设备。
在您的计算机上,打开 Android Studio 并找到设备管理器,通常位于 [此处应填写具体路径]。 物理设备视图中的设备管理器在里面你会找到一个名为“ 使用 Wi-Fi 配对 或类似按钮。点击它会弹出一个包含两个标签页的窗口:一个用于通过二维码配对(使用二维码配对)以及另一种使用数字代码的方法(使用配对码进行配对).
在二维码选项卡中,您将看到 Android Studio 生成的二维码如果你用其他扫描器检查它,你会发现它实际上包含一个 Wi-Fi 连接配置文件,IDE 就是用这个配置文件来建立调试通道的。务必使用 Android 自带的无线调试流进行扫描,不要使用任何扫描器或第三方应用程序。
在您的移动设备上,启用开发者选项,然后转到 开发者菜单中的“无线调试”选项无需启用 USB 调试。您将在那里看到配对选项。对于二维码配对方式,请选择 “将设备与二维码连接” 将摄像头对准电脑上 Android Studio 屏幕上显示的代码。配对过程将在几秒钟内完成,设备将被注册为已配对。
如果二维码扫描出现问题,您可以使用数字代码选项卡。在 Android Studio 中,选择 选择“使用配对码进行配对”,然后按下配对按钮。此时会弹出一个对话框,要求输入六位数的代码。在您的移动设备上,在同一无线调试屏幕上,点击 “链接同步代码” 记下系统显示的号码和端口。将其输入到 Android Studio 的文本框中,验证后,设备将像使用二维码配对一样完成配对。
之后,该移动设备将显示为可用。 在 Android Studio 的终端选项卡中启动应用、调试和使用 ADB 或者通过系统控制台,对于远程控制,您可以…… 在 Windows 中使用 scrcpy 用于控制您的 Android 设备。如果内置终端无法识别该命令。 adb请确保您位于包含二进制文件的目录中,通常情况下 %LOCALAPPDATA%\Android\SDK\platform-tools 在 Windows 系统上,或在 macOS 和 Linux 系统上具有同等功能。
在 Android 11 及更高版本上,使用命令行通过 Wi-Fi 连接。

Android 11 还允许您完全通过控制台使用无线调试,而无需打开 Android Studio。为此,请使用以下命令: 移动设备已启用无线调试进入该选项屏幕并使用菜单 “将设备与同步代码关联”在那里您将看到 IP 地址、端口和临时配对码。
在你的电脑上,打开一个终端,该终端位于以下目录中: Android SDK 平台工具(platform-tools 文件夹) 并执行如下命令:
adb pair IP_DEL_DISPOSITIVO:PUERTO
自己 adb 接下来,系统会要求您输入手机屏幕上显示的六位数配对码。输入配对码后,如果一切顺利,配对信息将被记录。此步骤可将您的工作站与设备安全连接。
配对成功后,您可以直接连接到:
adb connect IP_DEL_DISPOSITIVO:PUERTO
在许多情况下,配对后,得益于 mDNS,ADB 服务器本身可以 自动发现已连接的设备 无需重新输入 IP 地址和端口,但如果您的网络对 mDNS 的支持不佳,则可以使用手动方法。 adb connect ip:puerto 这是个可靠的选择。
从那一刻起,你就可以使用 所有经典的 ADB 命令都可通过 Wi-Fi 执行: adb devices 要查看设备列表, adb install 安装 APK 文件, adb shell 进入壳中, adb pull/push 用于传输文件或诸如此类的实用程序 screencap y screenrecord 用于屏幕截图和屏幕录制。更多相关资源,请参阅如何操作。 通过计算机控制您的手机, 查看 通过 PC 控制手机.
无需 Android 11 的无线 ADB:完成初始 USB 设置后的 Wi-Fi 连接
如果您的设备使用 Android 10 或更早版本(或者如果您想要一种也兼容 11 及更高版本的方法),您可以使用经典的 ADB 方案。 它通过 USB 接口配置一次,然后即可通过 Wi-Fi 使用。虽然 Android 11 及更高版本中新的配对系统更安全、更方便,但该流程在现代版本中仍然受支持。
传统步骤是:通过 USB 将手机连接到电脑,检查…… USB调试已启用,并且命令 adb devices 它能检测到它 如 设备然后,在终端中运行:
adb tcpip 5555
此命令会重启手机上的 ADB 服务,使其通过 TCP/IP 协议监听 5555 端口。此时,您可以拔下 USB 数据线。
下一步是找出…… 本地网络中设备的 IP 地址在标准的安卓手机上,你会在以下位置找到它: 设置 > 关于手机 > 状态 > IP 地址它通常采用这样的格式 192.168.1.x获取完成后,请在您的电脑上运行以下命令:
adb connect 192.168.1.X:5555
如果您不指定端口, adb 它默认使用 5555 端口。如果一切正常且网络防火墙没有阻止该端口,设备将会响应,当您执行操作时…… adb devices 你会看到它被标识出来。 其 IP 地址和端口,处于“设备”状态.
如果需要兼容更严格的防火墙,可以使用相同的模式配置其他端口。关键在于网络和设备允许流量通过该端口。 ADB端口(默认值:5555) 并且移动设备和工作站都在同一网络或网段上。
通过以太网使用 ADB 以及 Chromebook 等特殊情况
在Wi-Fi网络受到严格控制或存在安全限制的环境中,另一种选择是使用 通过以太网使用物理电缆进行 ADB 连接 通过将设备连接到与开发团队相同的网络来实现。从概念上讲,它与 Wi-Fi TCP/IP 模式相同,只是网络接口不是 Wi-Fi 而是有线连接。
对于未运行 ChromeOS 的普通 Android 设备,可能需要像使用传统 Wi-Fi 一样运行 adb tcpip 5555 首次 USB 连接后手机监听该端口后,即可断开 USB 电缆,仅使用以太网电缆和网络分配的 IP 地址进行操作。
对于 Chromebook 而言,很多都不支持通过 USB 连接 ADB,因此唯一可行的选择是 Wi-Fi 或以太网。典型的以太网连接流程如下: 为开发机器和 Chromebook 分配同一网段的 IP 地址。 (例如,PC 的 IP 地址为 192.168.1.3,Chromebook 的 IP 地址为 192.168.1.2),使用诸如以下工具: ifconfig 或者系统的网络配置。然后在电脑上运行一个程序。 adb connect 192.168.1.2:5555 其余部分的工作方式与任何 ADB TCP/IP 连接相同。
在 Windows 系统中,将 ADB 配置到系统路径中。
如果每次都需要手动导航到文件夹,那么从控制台不断使用 ADB 会有点繁琐。 platform-tools 为了能够执行命令理想情况下,应该将此文件夹添加到环境变量中。 途径 Windows 系统,以便 adb 能够从任何目录中识别出来。
为此,请打开 Windows 搜索栏并输入 “查看高级系统设置”在打开的窗口中,转到选项卡 进阶选项 然后点击 环境变量. 在 系统变量 找到入口 途径 并单击 编辑.
在路径编辑器中,单击 新 并输入该文件夹的完整路径 “platform-tools”(例如 C:\Android\sdk\platform-tools)在所有窗口中单击“确定”进行确认。从那时起,您可以打开任何命令提示符或 PowerShell 窗口并运行 adb 直接执行,无需考虑当前目录。
ADB 命令和高级功能(概述)
除了无线连接之外,了解 ADB 基于什么也很重要。 由三个组件构成的客户端-服务器架构客户端(工具) adb (您在电脑上运行的)守护进程 adbd 它运行在每个安卓设备上,而服务器则负责协调它们之间的通信。服务器监听本地端口 5037,并通过端口范围或 IP 地址检测与模拟器和物理设备的连接。
连接器 adb devices -l 您可以列出已连接的设备,并查看更详细的信息。每个设备都会显示一个 序列号、状态(离线、设备或无设备) 以及描述。如果您使用多个设备,则可以使用 adb -s SERIAL command 或者配置环境变量 ANDROID_SERIAL 将命令定向到特定对象。如果您是新手,这会很有帮助。 利用开发者模式.
其中最有用的命令是 adb install y adb uninstall 管理 APK包括那些借助软件包管理器预装在系统中的软件包(pm该命令 adb shell 在设备上打开一个 Unix shell,您可以从中运行诸如……之类的工具 am (活动经理) pm (软件包管理器) dpm (设备策略管理器) logcat 为了记录, sqlite3 适用于数据库(在具有 root 访问权限的环境中)或系统特定的实用程序。
它也非常实用。 配置端口重定向 adb forward使用以下方式复制任意文件 adb push y adb pull并控制服务器本身 adb kill-server y adb start-server后者有助于解决 ADB 服务器停止响应或检测不到设备时偶尔出现的阻塞问题。
补充工具,例如 screencap 用于屏幕截图和 screenrecord 用于视频录制 它们允许您通过简单的命令从设备中获取图形素材。例如:
adb exec-out screencap -p > screen.png
好吧:
adb shell screenrecord /sdcard/demo.mp4 跟一个 adb pull 将视频传输到电脑上。
无线调试:常见问题及解决方案
无线模式并非总是运行流畅。这通常有几个原因。 与 ADB 的 Wi-Fi 连接可能会失败最常见的原因之一是 Wi-Fi 网络是企业网络或高度安全的网络,会阻止 P2P 连接和 5555 等端口。在这种情况下,通常唯一可行的解决方案是使用其他网络、将手机用作热点或使用以太网连接。
另一个反复出现的问题是,在 Android 11+ 上成功配对后, 该设备似乎已无法通过 ADB 访问。这通常是由于网络或设备上的 mDNS 限制造成的。如果 mDNS 无法正常工作,ADB 服务器将无法自动发现移动设备,但您可以手动连接。 adb connect ip:puerto 使用无线调试屏幕提供的数据。
当手机切换网络或断开 Wi-Fi 连接时,连接自行断开也是正常现象,这会导致…… 重复配对步骤,或者至少重复连接步骤。如果无线调试功能被自动禁用,请在开发者选项中检查是否有快捷磁贴可用。 无线调试 通过快捷设置帘幕可以更轻松地激活它。
使用 Tasker 和 Termux 在 Android 11+ 上通过 Wi-Fi 自动使用 ADB
对于希望避免每次重启手机后都重复激活和连接过程的高级用户来说,这是可以实现的。 使用 Tasker 和 Termux 自动启用 ADB Wi-Fi该解决方案依赖于手机本身运行 adb 在本地(通过 Termux 中的 android-tools)管理 TCP/IP 模式的激活和配对。
基本要求是:一台设备 Android 11 或更高版本,且设置中需包含 ADB Wi-Fi 选项连接到 Wi-Fi 网络(无需访问互联网),安装 Tasker、Termux 以及 Termux:Tasker 插件,并已授予 Tasker 权限。 写_安全_设置 y 读取日志 使用 ADB 或特定工具。这些权限允许 Tasker 修改安全系统设置并读取 logcat 日志条目。
第一步是打开 Termux 并安装软件包。 android-tools 用命令 pkg install android-tools安装过程中,您可能需要确认一些问题。完成后,请尝试输入 adb 在 Termux 中验证其是否运行正常。
接下来,您需要创建 Tasker 将要运行的文件夹结构和脚本。在 Termux 中运行以下命令:
mkdir -p .termux/tasker
然后创建第一个脚本,内容如下:
nano .termux/tasker/adb.sh
在该文件中,您必须粘贴一个使用以下功能的小型 bash 脚本: 路线 adb 在 Termux 中连接到主机 (IP:端口),激活 adb tcpip 5555断开并终止 ADB 服务器。重要的是,第一行必须以……开头。 #!/data/data/com.termux/files/usr/bin/bash (垫子后面没有额外空间)。
然后创建第二个脚本, adb_pair.sh负责将手机与 ADB Wi-Fi 配对同样来自 Termux:
nano .termux/tasker/adb_pair.sh
粘贴一个脚本,该脚本接收主机(IP:端口)和配对码作为参数,并将该配对码传递出去。 echo a adb pair 完成后关闭服务器。和以前一样,脚本的第一行必须包含正确的 shebang,不能有任何多余的空格。
脚本创建并保存后(在 nano 编辑器中,这是通过以下方式完成的): Ctrl+X,然后按“Y”确认),您需要授予 Tasker 对 Termux 环境的访问权限。在 Android 设置中,转到…… 应用程序 > Tasker > 权限 > 其他权限 并启用“在 Termux 环境中运行命令”或类似选项。
从这里开始,您无需手动在 Tasker 中设置所有配置文件和任务,而是可以 从 Taskernet 导入一个完整的项目 这些预配置的配置文件用于配对手机、在启动时启用 ADB Wi-Fi 以及从 logcat 获取端口。这些配置文件的设计理念是:其中一个配置文件可以通过按住音量上键激活,然后使用脚本进行配对。 adb_pair.sh另一个程序在手机启动后解锁时运行,以启用“通过 WLAN 进行调试”选项;第三个程序监视 logcat 中与 Wi-Fi ADB 相关的条目,提取端口,并调用脚本。 adb.sh 激活 adb tcpip 5555.
在这种配置下,如果所有部件都正确组装, 每次你打开手机并解锁它 Tasker 可以自动完成启用 WLAN 调试、捕获系统端口、从 Termux 执行内部 ADB 命令以及设置服务器监听 5555 端口等操作。之后,您只需在电脑上连接到手机的 IP 地址和该端口,无需每次都检查配对码和临时端口。
无线ADB的安全性、最佳实践和局限性
使用 ADB 意味着设备对具有高权限的控制台开放,因此存在一些问题。 应遵循的良好安全规范首先,尽量将无线调试限制在受信任的网络(家庭、受控办公室、实验室)上,避免在公共或共享的 Wi-Fi 网络上启用它,因为你无法控制谁连接到这些网络。
你也不应该和任何人分享。 IP地址、端口和配对码虽然 Android 11 及更高版本中的代码有效期有限,但授予他人访问权限可能会让他们能够安装、卸载或修改您手机的系统。如果您怀疑自己配对了不需要的设备,请进入无线调试界面,查看“已配对设备”列表,然后使用“忘记”选项撤销访问权限。
此外,这也是个好主意。 不使用时,请禁用调试功能(USB 或无线)。这可以缩小攻击面,例如,防止本地网络中感染恶意软件的电脑利用开启调试模式的设备进行攻击。如果您使用自动化脚本在每次启动时启用 Wi-Fi 上的 ADB 功能,请务必了解其影响,不要让您的手机一直暴露在其他人的网络上。
综合来看,Android 11+ 中对无线 ADB 的支持以及传统的 TCP/IP 连接方式(通过 USB、Wi-Fi 甚至以太网),使得 Android 设备的调试和高级控制更加灵活便捷。结合官方 SDK 工具、Android Studio、控制台实用程序以及 Tasker 和 Termux 等自动化解决方案,可以构建一个高效的工作流程。 除了特殊情况外,你几乎不再需要依赖 USB 数据线了。在保持合理安全水平的同时,充分利用亚洲开发银行的潜力。 分享信息,帮助其他人在 Android 11+ 系统上使用无线 ADB。