为什么 Android 11+ 无线调试的设备扫不到?Shield Optimizer mDNS 发现与配对原理详解

原创2026-10-15 09:16:501,415 阅读

为什么 Android 11+ 无线调试的设备扫不到?Shield Optimizer mDNS 发现与配对原理详解

Shield Optimizer(现更名 ATV Optimizer)是一款面向 Android TV 的无线 ADB 优化工具,它通过端口扫描 + mDNS 服务发现双通道定位电视设备,并用 6 位配对码完成 Android 11+「无线调试」的一次性配对。本文解释为什么老式 5555 端口扫描扫不到新版设备,以及 Shield Optimizer 的 mDNS 发现与 PIN 配对背后到底发生了什么。

Shield Optimizer(ATV Optimizer)桌面版无线 ADB 设备发现与配对演示

为什么 Android 11+「无线调试」的设备扫不到?

很多人习惯了给电视开启网络调试(Network Debugging),然后扫描局域网的 5555 端口就能连上。但从 Android 11 开始,Google 换了一套「无线调试」(Wireless debugging)机制,行为完全不同:

机制 出现在 监听端口 能否被端口扫描找到
Network debugging(网络调试) 老设备,如 Shield TV 固定 5555 ✅ 能
Wireless debugging(无线调试) Android 11+ 随机端口,每次开关都变 ❌ 不能

关键差异有两点:

  1. 端口是随机的。 每当你重新打开「无线调试」开关,设备会重新分配一个端口(如 41541),扫描工具猜不到它。
  2. 首次连接必须用配对码。 即使你手动拿到 IP 和端口,直接 adb connect 也会被拒——Android 11+ 要求先通过一次带 6 位 PIN 的安全配对建立信任。

这就是为什么不少用户反馈「电视明明开着无线调试,扫描却列表为空」。该问题最早在 v2/HANDOFF.md 中对应 TCL Android 14 扫不到的工单 #88 被正式记录并修复:修复方案就是让扫描不再只猜 :5555,同时去读 mDNS 服务。

双通道发现:5555 端口扫描 + mDNS 广播

Shield Optimizer 的 Scan Network 同时跑两条发现通道,任何一条命中都会把设备列入设备列表:

Shield Optimizer v1 网络扫描电视设备界面

通道一:/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 流程)

配对完成后设备才会在列表中出现。完整步骤:

  1. 电视上:设置 → 开发者选项 → 无线调试 → 使用配对码配对设备,记下弹窗里的 IP:port 和 6 位数字码;
  2. 在 Shield Optimizer 点 Pair PIN,填入配对弹窗显示的 IP:port 和 6 位码,确认配对;
  3. 配对成功后关闭电视上的配对弹窗,回到无线调试主界面——那里显示的 IP:port 是另一个端口;
  4. 用主界面的 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

延伸阅读

一句话总结:老设备靠 5555,新设备靠 mDNS;扫不到 Android 11+ 不是版本不支持,而是端口猜不到 + 还没配对。让 Shield Optimizer 替你读 mDNS、填配对地址、完成 PIN 握手,剩下的就是关掉配对弹窗、点一下连接。

登录后查看全文
shield_optimizer