如何快速提取小米云设备令牌：从原理到实战的完整指南

【免费下载链接】Xiaomi-cloud-tokens-extractor This tool/script retrieves tokens for all devices connected to Xiaomi cloud and encryption keys for BLE devices. 项目地址: https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor

小米云令牌提取工具（Xiaomi Cloud Tokens Extractor）是一款强大的开源工具，能够帮助用户轻松获取连接到小米云的所有设备的令牌以及BLE设备的加密密钥。无论是智能家居爱好者还是开发者，掌握令牌提取技术都能为设备集成和自动化控制带来极大便利。

什么是小米云令牌？

小米云令牌是设备与小米云服务器通信的重要凭证，相当于设备的"数字身份证"。通过令牌，用户可以实现对小米智能设备的本地控制、数据同步和第三方集成。对于使用Home Assistant等智能家居平台的用户来说，获取设备令牌是实现设备接入的关键步骤。

工具核心功能亮点

• 双重认证方式：支持用户名/密码登录和QR码扫描登录两种方式
• 多服务器支持：可选择中国、德国、美国、俄罗斯等多个地区服务器
• 全面设备信息：获取设备名称、ID、MAC地址、IP地址、型号等详细信息
• BLE密钥提取：自动获取蓝牙设备的加密密钥
• 多平台兼容：支持Windows、Linux系统和Home Assistant环境

准备工作：环境与依赖

在开始使用前，请确保您的系统满足以下要求：

• Python 3.6或更高版本
• 网络连接（需要访问小米云服务器）
• 小米账号（已绑定智能设备）

项目依赖包已在requirements.txt中列出，主要包括requests、pycryptodome和Pillow等库。

快速安装指南

Windows系统

1. 下载最新版本的token_extractor.exe
2. 双击运行可执行文件
3. 按照提示完成操作

Linux系统

打开终端，执行以下命令：

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

Docker方式

对于Docker用户，可使用以下命令：

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

手动安装（开发者选项）

如果您需要手动安装，可以按照以下步骤操作：

# 克隆仓库
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

详细使用步骤

步骤1：选择登录方式

运行程序后，您可以选择两种登录方式：

• 密码登录：输入小米账号和密码
• QR码登录：扫描生成的QR码进行登录

步骤2：选择服务器区域

根据您的小米账号注册地区选择合适的服务器，可选值包括：

• cn（中国）
• de（德国）
• us（美国）
• ru（俄罗斯）
• tw（台湾）
• sg（新加坡）
• in（印度）
• i2（国际版）

如果不确定，可以留空让工具自动检测所有可用服务器。

步骤3：获取设备令牌

登录成功后，工具将自动获取并显示您账号下所有设备的信息，包括：

• 设备名称（NAME）
• 设备ID（ID）
• MAC地址（MAC）
• IP地址（IP）
• 设备令牌（TOKEN）
• 设备型号（MODEL）
• BLE密钥（如适用）

步骤4：保存结果

您可以将结果保存到文件中，方便后续在Home Assistant等平台中使用：

python3 token_extractor.py -o tokens.json

常见问题与解决方案

登录失败怎么办？

如果遇到登录问题，请尝试以下解决方案：

• 确保输入的是小米云账号而非设备APP账号
• 检查网络连接，暂时关闭广告拦截器
• 清除浏览器缓存或尝试QR码登录方式
• 检查是否超过每日2FA验证次数限制（通常为3-5次）

无法找到设备怎么办？

如果工具未显示您的设备：

• 确认设备已连接到小米云
• 尝试切换不同的服务器区域
• 确保设备已在小米家庭APP中正常显示

如何在Home Assistant中使用令牌？

获取令牌后，您可以在Home Assistant的配置文件中使用这些信息，例如在configuration.yaml中添加设备：

xiaomi_miio:
  devices:
    - host: 192.168.1.100
      token: your_device_token
      name: Living Room Vacuum

故障排除与支持

如果您在使用过程中遇到问题，可以参考项目的故障排除指南或寻求社区支持：

• 检查README.md中的故障排除部分
• 确认网络环境没有阻止对小米服务器的访问
• 尝试更新到最新版本的工具

总结

小米云令牌提取工具为小米设备用户提供了一种简单高效的方式来获取设备令牌，无论是用于智能家居集成还是开发目的，都能大大简化流程。通过本指南，您应该已经掌握了从安装到提取令牌的全部步骤。

如果您觉得这个工具有用，不妨给项目点个星标，或者通过项目支持页面支持开发者的工作。

祝您使用愉快，享受智能生活的便利！

【免费下载链接】Xiaomi-cloud-tokens-extractor This tool/script retrieves tokens for all devices connected to Xiaomi cloud and encryption keys for BLE devices. 项目地址: https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor