为什么 Android 11+ 无线调试的设备扫不到?Shield Optimizer mDNS 发现与配对原理详解
为什么 Android 11+ 无线调试的设备扫不到?Shield Optimizer mDNS 发现与配对原理详解
Shield Optimizer(现更名 ATV Optimizer)是一款面向 Android TV 的无线 ADB 优化工具,它通过端口扫描 + mDNS 服务发现双通道定位电视设备,并用 6 位配对码完成 Android 11+「无线调试」的一次性配对。本文解释为什么老式 5555 端口扫描扫不到新版设备,以及 Shield Optimizer 的 mDNS 发现与 PIN 配对背后到底发生了什么。
为什么 Android 11+「无线调试」的设备扫不到?
很多人习惯了给电视开启网络调试(Network Debugging),然后扫描局域网的 5555 端口就能连上。但从 Android 11 开始,Google 换了一套「无线调试」(Wireless debugging)机制,行为完全不同:
| 机制 | 出现在 | 监听端口 | 能否被端口扫描找到 |
|---|---|---|---|
| Network debugging(网络调试) | 老设备,如 Shield TV | 固定 5555 | ✅ 能 |
| Wireless debugging(无线调试) | Android 11+ | 随机端口,每次开关都变 | ❌ 不能 |
关键差异有两点:
- 端口是随机的。 每当你重新打开「无线调试」开关,设备会重新分配一个端口(如
41541),扫描工具猜不到它。 - 首次连接必须用配对码。 即使你手动拿到 IP 和端口,直接
adb connect也会被拒——Android 11+ 要求先通过一次带 6 位 PIN 的安全配对建立信任。
这就是为什么不少用户反馈「电视明明开着无线调试,扫描却列表为空」。该问题最早在 v2/HANDOFF.md 中对应 TCL Android 14 扫不到的工单 #88 被正式记录并修复:修复方案就是让扫描不再只猜 :5555,同时去读 mDNS 服务。
双通道发现:5555 端口扫描 + mDNS 广播
Shield Optimizer 的 Scan Network 同时跑两条发现通道,任何一条命中都会把设备列入设备列表:
通道一:/24 子网 5555 端口并发探测
对于老设备(Shield、早期盒子),工具会读取默认网关推出本地 /24 子网,然后并发 TCP 探测每个地址的 5555 端口——单个探测 250ms 超时、64 路并发。实现见 v2/src-tauri/src/adb/scan.rs#L17-L24。
这里故意跳过 ping(ICMP)直接探 TCP,因为很多电视会屏蔽 ICMP,但 5555 只要网络调试开着就必须放行。
通道二:读取 mDNS 服务(关键!)
对 Android 11+ 设备,真正靠谱的是 mDNS:设备会主动向局域网广播自己的服务类型 + 当前随机端口。工具通过 adb mdns services 拿到广播列表并解析,设备名里还直接嵌着硬件序列号(形如 adb-<序列号>-<随机后缀>),可以用来识别「这台电视我连过」。核心解析逻辑在 v2/crates/core/src/adb/parse.rs#L39-L78,三种服务各司其职:
| mDNS 服务类型 | 含义 | 下一步动作 |
|---|---|---|
_adb._tcp |
老式网络调试,无配对码 | 直接 adb connect |
_adb-tls-connect._tcp |
Android 11+ 连接端点(随机端口) | 已配对 → 直接连接 |
_adb-tls-pairing._tcp |
Android 11+ 配对端点(另一个随机端口) | 需要先输入 6 位配对码 |
注意两个细节:
- 配对端口 ≠ 连接端口,同一台电视会同时(或先后)广播两条 mDNS 记录,端口各不相同。
- 配对服务只在配对弹窗打开时才广播。如果扫描发现一台电视只广播了
_adb-tls-pairing,应用会明确提示「该设备需要先配对」,并把配对地址自动填入配对表单,省得你手动抄 IP:port(见 v2/src/routes/+page.svelte#L205-L209)。
如何配对 Android 11+ 设备(Pair PIN 流程)
配对完成后设备才会在列表中出现。完整步骤:
- 电视上:设置 → 开发者选项 → 无线调试 → 使用配对码配对设备,记下弹窗里的 IP:port 和 6 位数字码;
- 在 Shield Optimizer 点 Pair PIN,填入配对弹窗显示的 IP:port 和 6 位码,确认配对;
- 配对成功后关闭电视上的配对弹窗,回到无线调试主界面——那里显示的 IP:port 是另一个端口;
- 用主界面的 Connect IP 填入该「连接端口」。如果 ADB 通过 mDNS 自动发现了已配对设备,刷新设备列表后它也会直接出现。
⚠️ 常见坑:不要用配对端口去 Connect。配对端口是临时服务,关弹窗就失效了;而且 Android 对每个显示的配对码只允许一次尝试机会,所以应用会先在本地校验码必须是 6 位数字,避免白白「烧掉」这次机会。
配对底下发生了什么(原理速览)
配对不是简单的「密码登录」,而是一套抗中间人攻击的密钥协商:设备与电脑先建立 TLS 1.3 会话,从会话导出密钥材料,再把「6 位码 + 导出密钥」作为 SPAKE2 协议的口令做一轮双向质询,并交换双方的 RSA 公钥。从此以后设备凭这把 RSA 公钥放行后续 adb connect,不再弹「允许调试」确认框。
这套流程的完整协议细节、超时策略和错误映射,都记录在 v2/mobile/PAIRING-PLAN.md,值得想深入了解的读者一读。
扫不到?按这个清单自查
| 症状 | 原因 | 解决 |
|---|---|---|
| 扫描列表完全为空 | 电脑与电视不在同一网段 / 路由器开启了 AP 隔离 | 确认同网段,关闭 AP 隔离;或直接用 Connect IP 手动填地址 |
| 电视只有「无线调试」选项 | Android 11+ 新机制,无 5555 | 走 Pair PIN 配对流程 |
| 配对成功但连不上 | 复用了配对端口 | 回无线调试主界面取连接端口 |
| 配对报错 code didn't match | 6 位码输错 | 重新打开配对弹窗取新码(旧码已作废) |
| mDNS 服务一个都发现不了 | 某些路由器/防火墙拦截 mDNS(UDP 5353) | 用 adb mdns services 交叉验证;不行就手动 IP:port |
延伸阅读
- 项目总览与双版本说明:README.md
- v2 架构与模块划分:v2/README.md
- 网络扫描实现:v2/src-tauri/src/adb/scan.rs
- mDNS 服务解析:v2/crates/core/src/adb/parse.rs
- 设备发现命令(配对端口自动填充):v2/crates/core/src/commands/devices.rs
- 配对协议完整原理:v2/mobile/PAIRING-PLAN.md
一句话总结:老设备靠 5555,新设备靠 mDNS;扫不到 Android 11+ 不是版本不支持,而是端口猜不到 + 还没配对。让 Shield Optimizer 替你读 mDNS、填配对地址、完成 PIN 握手,剩下的就是关掉配对弹窗、点一下连接。

