如何轻松提取小米云设备令牌：Xiaomi Cloud Tokens Extractor 完整指南

Xiaomi Cloud Tokens Extractor 是一款免费实用工具，能够帮助用户快速获取小米云中所有已连接设备的令牌及BLE设备加密密钥。无论是智能家居爱好者还是开发者，都能通过它轻松管理小米设备的访问权限，实现跨平台数据同步。

一、为什么选择 Xiaomi Cloud Tokens Extractor？

核心功能亮点 ✨

• 双认证方式：支持用户名/密码登录或二维码扫描，灵活适配不同使用场景
• 多区域支持：自动适配小米服务器区域（中国、德国等），无需手动配置
• 全面设备信息：输出设备名称、IP地址及令牌等关键信息，一目了然

适用人群

• 智能家居DIY玩家 🛠️
• 小米生态开发者 👨💻
• 多设备管理需求用户 🏠

二、快速上手：3种安装方法任选

方法1：Windows系统一键启动

1. 下载 token_extractor.exe 可执行文件
2. 双击运行即可开始使用

方法2：Linux & Home Assistant终端安装

bash <(curl -L https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor/raw/master/run.sh)

⚠️ 注意：若安装失败，可尝试Docker版本

方法3：Docker & Home Assistant安装

bash <(curl -L https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor/raw/master/run_docker.sh)

💡 提示：在Home Assistant中使用需先禁用"保护模式"并重启插件

方法4：Python手动运行

# 克隆仓库
git clone https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor
cd Xiaomi-cloud-tokens-extractor

# 安装依赖并运行
pip3 install -r requirements.txt
python3 token_extractor.py

三、使用教程：3步获取设备令牌

步骤1：选择认证方式

• 账号密码登录：输入小米云账号（邮箱/ID）和密码
• 二维码登录：扫描工具生成的二维码完成验证

步骤2：选择服务器区域

根据实际使用地区选择对应服务器：

• cn - 中国服务器
• de - 德国服务器
• 留空可自动检测所有可用区域

步骤3：获取设备信息

完成验证后，工具将自动列出所有已连接设备，包含：

• 设备名称
• IP地址
• 访问令牌
• BLE设备加密密钥（如适用）

四、常见问题解决指南

登录失败怎么办？

1. 确认使用小米云账号而非Roborock等第三方应用凭证
2. 关闭网络广告拦截工具（AdGuard、PiHole等）
3. 检查2FA邮件是否被拦截到垃圾邮件文件夹
4. 尝试二维码登录替代账号密码方式

设备列表为空？

• 检查小米账号是否正确绑定设备
• 尝试切换不同服务器区域
• 确保设备已连接小米云服务

五、最佳实践与安全建议

安全使用准则 🔒

• 不在公共网络环境下使用该工具
• 及时删除包含令牌信息的输出文件
• 定期更新工具至最新版本

进阶应用场景

• 家庭自动化：配合Home Assistant实现设备联动
• 数据备份：定期导出设备令牌用于系统迁移
• 二次开发：作为小米生态集成项目的基础组件

六、相关工具推荐

Xiaomi Cloud Map Extractor

获取小米扫地机器人实时地图数据，支持路径规划与区域清扫

Lovelace Xiaomi Vacuum Map Card

为Home Assistant提供可视化扫地机器人控制界面，支持手动选区清扫

---

通过本指南，您已掌握 Xiaomi Cloud Tokens Extractor 的全部使用技巧。如有其他问题，欢迎查阅项目文档或提交Issue反馈。合理使用工具，让小米智能生态更好地服务生活！