如何轻松提取小米云设备令牌：Xiaomi Cloud Tokens Extractor 完整指南
项目地址: https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor Xiaomi Cloud Tokens Extractor 是一款免费实用工具，能够帮助用户快速获取小米云中所有已连接设备的令牌及BLE设备加密密钥。无论是智能家居爱好者还是开发者，都能通过它轻松管理小米设备的访问权限，实现跨平台数据同步。
一、为什么选择 Xiaomi Cloud Tokens Extractor？
核心功能亮点 ✨
- 双认证方式：支持用户名/密码登录或二维码扫描，灵活适配不同使用场景
- 多区域支持：自动适配小米服务器区域（中国、德国等），无需手动配置
- 全面设备信息：输出设备名称、IP地址及令牌等关键信息，一目了然
适用人群
- 智能家居DIY玩家 🛠️
- 小米生态开发者 👨💻
- 多设备管理需求用户 🏠
二、快速上手：3种安装方法任选
方法1：Windows系统一键启动
- 下载
token_extractor.exe可执行文件 - 双击运行即可开始使用
方法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设备加密密钥（如适用）
四、常见问题解决指南
登录失败怎么办？
- 确认使用小米云账号而非Roborock等第三方应用凭证
- 关闭网络广告拦截工具（AdGuard、PiHole等）
- 检查2FA邮件是否被拦截到垃圾邮件文件夹
- 尝试二维码登录替代账号密码方式
设备列表为空？
- 检查小米账号是否正确绑定设备
- 尝试切换不同服务器区域
- 确保设备已连接小米云服务
五、最佳实践与安全建议
安全使用准则 🔒
- 不在公共网络环境下使用该工具
- 及时删除包含令牌信息的输出文件
- 定期更新工具至最新版本
进阶应用场景
- 家庭自动化：配合Home Assistant实现设备联动
- 数据备份：定期导出设备令牌用于系统迁移
- 二次开发：作为小米生态集成项目的基础组件
六、相关工具推荐
Xiaomi Cloud Map Extractor
获取小米扫地机器人实时地图数据，支持路径规划与区域清扫
Lovelace Xiaomi Vacuum Map Card
为Home Assistant提供可视化扫地机器人控制界面，支持手动选区清扫
通过本指南，您已掌握 Xiaomi Cloud Tokens Extractor 的全部使用技巧。如有其他问题，欢迎查阅项目文档或提交Issue反馈。合理使用工具，让小米智能生态更好地服务生活！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
