小米云设备令牌提取工具：三步解锁智能家居深度控制

小米云设备令牌提取工具（Xiaomi Cloud Tokens Extractor）是一款开源工具，能够帮助用户轻松获取小米云连接设备的访问令牌和BLE设备加密密钥，实现对智能设备的深度控制与第三方集成。无论是打造个性化智能家居系统，还是实现高级自动化场景，这款工具都能为你提供关键的技术支持。

为什么需要设备令牌？

设备令牌就像是智能设备的"数字身份证"，是设备与小米云服务器通信的核心凭证。通过获取令牌，你可以：

• 突破官方APP限制：实现官方应用不支持的高级控制功能
• 构建跨平台系统：将小米设备集成到Home Assistant、Node-RED等第三方平台
• 实现本地控制：即使在网络中断时也能管理设备
• 开发自定义功能：创建个性化的自动化脚本和设备管理工具

工具核心优势

多平台兼容

支持Windows、Linux和Docker环境，无论你使用什么系统都能轻松部署。项目提供的Dockerfile和run_docker.sh脚本可实现一键容器化部署，避免复杂的环境配置。

双重登录保障

提供两种安全登录方式：

• 密码登录：传统账号密码验证，支持两步验证
• 二维码登录：通过小米APP扫描二维码快速授权，无需输入密码

全面设备信息提取

自动获取设备的关键信息，包括：

• 设备名称、型号和唯一ID
• 本地IP地址和MAC地址
• 访问令牌（Token）
• BLE设备的加密密钥（Beaconkey）

快速开始：三步提取设备令牌

第一步：准备环境

方式1：Docker部署（推荐）

git clone https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor
cd Xiaomi-cloud-tokens-extractor
chmod +x run_docker.sh
./run_docker.sh

方式2：本地Python环境

git clone https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor
cd Xiaomi-cloud-tokens-extractor
pip install -r requirements.txt

第二步：运行工具并登录

执行以下命令启动工具：

python token_extractor.py

根据提示选择登录方式：

• 输入p使用密码登录，需提供小米账号和密码
• 输入q使用二维码登录，通过小米APP扫描生成的二维码

注意：工具不会存储你的账号信息，所有验证过程都在本地完成，确保账号安全。

第三步：选择服务器区域并获取令牌

工具支持全球多个服务器区域（cn、de、us、ru、tw、sg、in、i2），你可以：

• 输入具体区域代码（如cn）仅检查该区域
• 直接回车检查所有可用区域

工具将自动列出所有设备信息，包括设备名称、ID、IP地址和最重要的令牌（Token）。

实用场景与示例

Home Assistant集成

将提取的令牌添加到Home Assistant配置文件中，实现小米设备的无缝集成：

# configuration.yaml示例
xiaomi_miio:
  devices:
    - host: 192.168.1.100
      token: YOUR_DEVICE_TOKEN
      name: Living Room Light

自动化脚本开发

使用提取的令牌通过Python控制设备：

from miio import Device

device = Device("192.168.1.100", "YOUR_DEVICE_TOKEN")
device.send("set_power", ["on"])  # 打开设备

安全注意事项

1. 令牌保护：设备令牌相当于设备的访问密钥，请勿分享给他人
2. 官方渠道：仅从官方仓库获取工具，避免使用第三方修改版本
3. 定期更新：通过git pull保持工具为最新版本，获取安全更新
4. 环境安全：在安全的网络环境中使用工具，避免在公共网络操作

故障排除

常见问题解决

1. 登录失败

   • 确认账号密码正确，或尝试二维码登录
   • 检查网络连接，确保能访问小米云服务器

2. 设备不显示

   • 尝试切换不同的服务器区域
   • 确认设备已绑定到你的小米账号

3. 验证码问题

   • 若登录时需要验证码，请在交互式模式下运行工具
   • 工具会自动显示验证码图片或提供访问链接

总结

小米云设备令牌提取工具为小米智能设备用户提供了通往高级控制的钥匙。通过简单三步操作，你就能突破官方限制，实现设备的深度定制与第三方集成。无论是智能家居爱好者还是开发者，这款工具都能帮助你充分发挥小米设备的潜力，打造真正个性化的智能生活体验。

项目源码和详细文档可通过仓库获取，欢迎贡献代码或报告问题，一起完善这个实用的开源工具。