本文最后更新于 2026年11月9日。
因为米家 App 在添加设备时,就参与了设备的配网、绑定和密钥管理过程。
整个过程可以这样理解:
1. 首次添加台灯时发生了什么?
假设你买了一台新的小米台灯:
-
台灯进入配网模式。
-
米家 App 发现台灯,并向它发送 Wi-Fi 配置信息。
-
台灯完成网络连接和设备绑定。
-
设备生成或获得自己的独立 Token。
-
小米云记录设备与小米账号的绑定关系,并保存相应设备信息及凭据。
-
米家 App 后续通过云端或局域网与设备通信。
小米的设备技术文档也描述了设备 Token 的用途:设备绑定、快速配网,以及同一局域网内手机直接控制。
cdn.cnbj0.fds.api.mi-img.com+1
2. 为什么 Xiaomi-cloud-tokens-extractor 能获取?
它利用的是米家账号的云端设备管理接口。
大致流程:
Xiaomi-cloud-tokens-extractor
使用小米账号登录
小米云设备列表 API
读取账号绑定的设备信息
返回设备信息
DID、IP、Model、Token
你的本地控制程序
保存 Token,直接控制设备
参考:项目源码;Home Assistant Token 获取说明。
3. 一个很有意思的问题
你可能会想到:
既然 Token 是设备自己的,为什么不能直接从台灯获取,而必须登录小米云?
实际上,部分 MiIO 设备在特定配网或发现阶段可以通过局域网获取 Token,但很多设备在完成绑定后会隐藏 Token,不能简单地通过 UDP 扫描重新读取。
另外,设备重置、重新绑定可能导致 Token 改变。