Xiaomi Cloud Tokens Extractor小米云设备令牌提取与智能家居集成的完整指南【免费下载链接】Xiaomi-cloud-tokens-extractorThis tool 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设备的加密密钥。无论你是想构建自定义的智能家居自动化还是需要深度集成小米设备到第三方平台这个工具都能为你提供必要的技术基础。项目概述与核心价值Xiaomi Cloud Tokents Extractor 是一个开源工具专门用于从小米云服务中提取设备令牌和加密密钥。这些令牌是连接和控制小米智能设备的关键凭证包括智能灯泡、摄像头、传感器、扫地机器人等各种物联网设备。核心功能亮点双模式认证支持用户名密码和QR码两种认证方式多区域支持覆盖中国、德国、美国、俄罗斯等全球多个服务器区域完整设备信息获取设备令牌、BLE密钥、IP地址等关键数据多种部署方式支持Windows、Linux、Docker和Python原生运行Home Assistant集成专门为智能家居平台优化快速入门指南环境要求与安装在开始之前确保你的系统满足以下要求组件要求说明Python3.6核心运行环境pip最新版本包管理工具网络可访问小米云服务需要稳定的网络连接一键安装与使用对于Linux和Home Assistant用户bash (curl -L https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor/raw/master/run.sh)使用Docker容器运行bash (curl -L https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor/raw/master/run_docker.sh)手动Python安装# 下载最新版本 wget https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor/releases/latest/download/token_extractor.zip unzip token_extractor.zip cd token_extractor # 安装依赖 pip3 install -r requirements.txt # 运行工具 python3 token_extractor.py认证流程演示运行工具后你会看到以下交互流程选择认证方式用户名密码或QR码扫描输入凭证根据提示输入小米账户信息选择服务器区域根据设备所在地区选择中国、德国、美国等获取设备列表工具自动列出所有连接的设备核心功能详解认证系统架构Xiaomi Cloud Tokens Extractor 采用模块化设计支持多种认证方式密码认证模式(PasswordXiaomiCloudConnector)适用于常规用户登录支持邮箱和Xiaomi Cloud账户ID自动处理2FA验证码QR码认证模式(QrCodeXiaomiCloudConnector)通过扫描二维码快速登录避免密码泄露风险特别适合移动设备用户加密通信机制工具实现了小米云官方通信协议确保数据传输安全class XiaomiCloudConnector(ABC): def __init__(self): self._agent self.generate_agent() self._device_id self.generate_device_id() self._session requests.session() self._ssecurity None self.userId None self._serviceToken None def execute_api_call_encrypted(self, url, params): # 实现小米云加密通信协议 headers { MIOT-ENCRYPT-ALGORITHM: ENCRYPT-RC4, User-Agent: self._agent, Content-Type: application/x-www-form-urlencoded } # RC4加密算法处理 return self._session.post(url, headersheaders, dataparams)设备信息提取工具能够获取的完整设备信息包括信息类型说明用途设备令牌 (Token)设备身份验证凭证第三方平台设备控制BLE加密密钥蓝牙设备通信密钥本地蓝牙连接IP地址设备网络地址局域网内直接通信设备名称用户设置的设备名称设备识别与管理设备型号硬件型号信息功能适配与兼容性实际应用场景Home Assistant 集成Xiaomi Cloud Tokens Extractor 在Home Assistant生态中应用广泛集成步骤获取设备令牌运行工具提取所有小米设备信息配置Xiaomi Miot Auto将令牌添加到Home Assistant配置设备发现与注册Home Assistant自动识别设备自动化配置创建场景和自动化规则配置示例# configuration.yaml 配置示例 xiaomi_miot: username: 你的小米账户 password: 你的密码 devices: - device_id: 获取的设备ID token: 提取的设备令牌 host: 设备IP地址企业级设备管理对于需要管理大量小米设备的企业用户可以基于此工具构建批量设备管理方案自动化令牌收集定期运行工具获取最新设备状态数据库存储将设备信息存储到SQL数据库监控告警实时监控设备在线状态权限管理基于角色的设备访问控制开发调试与测试开发者可以使用此工具进行API调试理解小米云API调用流程协议分析研究设备通信协议兼容性测试验证不同设备类型的令牌格式安全审计检查通信安全性高级配置与优化命令行参数详解工具支持丰富的命令行参数适合自动化场景参数简写说明示例--non-interactive-ni非交互模式-ni--username-u用户名-u userexample.com--password-p密码-p your_password--server-s服务器区域-s cn--log_level-l日志级别-l DEBUG--output-o输出文件-o devices.json--host自定义主机--host 127.0.0.1自动化脚本示例#!/bin/bash # 自动化获取设备令牌脚本 python3 token_extractor.py \ -ni \ -u your_emailexample.com \ -p your_password \ -s cn \ -o /var/lib/homeassistant/xiaomi_devices.json \ -l INFO日志与调试工具内置了完善的日志系统支持多种日志级别# 设置日志级别示例 import logging _LOGGER logging.getLogger(token_extractor) _LOGGER.setLevel(logging.DEBUG) # 不同级别的日志输出 _LOGGER.debug(调试信息 - 详细过程) _LOGGER.info(信息日志 - 关键步骤) _LOGGER.warning(警告信息 - 需要注意) _LOGGER.error(错误信息 - 需要处理)性能优化技巧并发处理优化import threading from concurrent.futures import ThreadPoolExecutor def parallel_device_fetch(servers, max_workers3): 并行获取多服务器设备数据 with ThreadPoolExecutor(max_workersmax_workers) as executor: futures {} for server in servers: future executor.submit(get_devices_for_server, server) futures[future] server results {} for future in futures: server futures[future] try: results[server] future.result(timeout30) except Exception as e: _LOGGER.error(f服务器 {server} 获取失败: {e}) return results缓存机制实现import time import json class DeviceCache: def __init__(self, cache_filedevice_cache.json, ttl300): self.cache_file cache_file self.ttl ttl # 缓存有效期秒 self.cache_data self._load_cache() def get_devices(self, server): 获取缓存的设备数据 cache_key fdevices_{server} if cache_key in self.cache_data: cache_time, devices self.cache_data[cache_key] if time.time() - cache_time self.ttl: return devices return None def update_cache(self, server, devices): 更新缓存 self.cache_data[fdevices_{server}] (time.time(), devices) self._save_cache()常见问题解答认证相关问题Q: 为什么登录失败A: 常见原因及解决方案凭证错误确保使用小米云账户而非Roborock应用账户2FA限制小米云有每日2FA请求限制3-5次/天网络问题检查DNS设置移除Cloudflare DNS区域选择确认选择了正确的服务器区域Q: 如何避免2FA限制A: 建议使用QR码认证方式或合理安排认证时间避免短时间内多次尝试。技术问题Q: 工具运行时报错如何处理A: 按照以下步骤排查检查依赖确保所有Python依赖包已正确安装查看日志使用-l DEBUG参数获取详细日志网络连接确认可以访问小米云服务权限问题确保有足够的文件读写权限Q: 如何获取特定设备的BLE密钥A: 工具会自动列出所有BLE设备及其加密密钥。如果没有显示可能是设备不支持BLE或未启用相关功能。集成问题Q: 如何在Home Assistant中使用提取的令牌A: 将提取的JSON数据中的设备信息添加到Xiaomi Miot Auto组件的配置中。确保格式正确包括device_id、token和host字段。Q: 令牌会过期吗A: 小米设备令牌通常长期有效但某些情况下可能需要重新获取。建议定期如每月更新令牌信息。社区与贡献指南项目结构了解项目结构有助于更好地使用和贡献Xiaomi-cloud-tokens-extractor/ ├── token_extractor.py # 核心工具脚本 ├── requirements.txt # Python依赖包 ├── run.sh # Linux一键安装脚本 ├── run_docker.sh # Docker运行脚本 ├── Dockerfile # Docker构建文件 └── token_extractor.spec # Windows打包配置如何贡献欢迎开发者参与项目改进问题反馈在项目仓库中提交Issue功能建议提出新的功能需求或改进建议代码贡献提交Pull Request修复bug或添加功能文档完善帮助改进使用文档和示例开发环境设置# 克隆项目 git clone https://gitcode.com/gh_mirrors/xia/Xiaomi-cloud-tokens-extractor.git cd Xiaomi-cloud-tokens-extractor # 创建虚拟环境 python -m venv venv source venv/bin/activate # Linux/Mac # 或 venv\Scripts\activate # Windows # 安装开发依赖 pip install -r requirements.txt pip install black flake8 pytest # 代码格式化与测试工具测试与验证提交代码前请确保代码格式使用black进行代码格式化代码检查通过flake8检查代码质量功能测试确保现有功能不受影响新增测试为新功能添加测试用例最佳实践与建议安全最佳实践令牌管理不要将设备令牌硬编码在代码中环境变量使用环境变量存储敏感信息访问控制限制令牌的访问权限定期轮换定期更新设备令牌性能优化建议批量处理一次性获取所有设备信息避免多次API调用缓存策略对稳定的设备信息使用缓存错误重试实现指数退避的重试机制异步处理对于大量设备使用异步获取监控与维护日志监控建立工具运行日志监控设备状态定期检查设备在线状态版本更新关注项目更新及时升级备份策略定期备份设备配置信息下一步行动建议现在你已经了解了Xiaomi Cloud Tokens Extractor的完整功能和使用方法建议按照以下步骤开始实践环境准备选择适合你的安装方式Docker或Python初步测试使用你的小米账户进行测试运行设备验证确认工具能够正确识别你的设备集成部署将提取的令牌集成到你的智能家居系统自动化配置设置定期运行脚本保持设备信息更新通过合理使用这个工具你可以大大简化小米智能设备的集成过程构建更加智能和自动化的家居环境。无论是个人使用还是企业级部署Xiaomi Cloud Tokens Extractor 都能为你提供可靠的技术支持。记住始终遵循小米的服务条款合理使用API尊重设备所有者的隐私和安全。祝你在智能家居集成的道路上取得成功【免费下载链接】Xiaomi-cloud-tokens-extractorThis tool 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
