小米云 Token 提取工具

← 返回使用指南
平台地址：https://zhihongos.cn/mi_cloud
更新日期：2026-09-03

---

工具地址：https://zhihongos.cn/mi_cloud
界面语言：简体中文（默认中文，无需切换）

---

1. 工具概述

「小米云设备 Token 提取」是基于 Xiaomi Cloud API 的 Web 工具，用于获取小米/米家智能设备的：

• 设备 IP 地址
• 设备 Token
• 设备 ID、名称、型号等完整 JSON 信息

该工具常用于 Home Assistant、开源智能家居集成等场景，是连接小米生态设备的必要前置步骤。

---

2. 界面布局

页面分为三个主要面板：

面板	位置	功能
登录方式	左侧	小米账号登录（二维码 / 账号密码）
服务器区域	中间	选择小米云区域，获取设备列表
完整 JSON 数据	右侧	展示提取结果，支持一键复制

---

3. 登录方式

3.1 二维码登录（推荐）

1. 保持左侧 二维码登录 Tab 选中
2. 点击 获取二维码
3. 使用 小米 App 或 米家 App 扫描二维码
4. 在手机上确认登录

若无法扫码，页面提供跳转链接，可在浏览器中打开小米官方登录页完成认证。

3.2 账号密码登录

1. 切换到 账号密码登录 Tab
2. 输入小米账号与密码
3. 完成登录（可能需二次验证）

---

4. 获取设备列表

登录成功后，在中间 服务器区域 面板操作：

4.1 选择区域

选项	说明
全部区域	查询所有区域设备（耗时较长）
中国大陆	仅查询国内服务器
其他区域	按实际设备所在区域选择

默认选择 全部区域。

4.2 提取设备信息

1. 选择目标区域
2. 点击 获取设备列表
3. 等待 API 返回结果
4. 右侧 完整 JSON 数据 面板显示设备信息

4.3 退出登录

点击 退出登录 清除当前会话。

---

5. 结果解读

右侧 JSON 面板展示每个设备的完整信息，典型字段包括：

{
  "device_id": "xxx",
  "name": "客厅台灯",
  "model": "yeelink.light.xxx",
  "ip": "192.168.1.100",
  "token": "32位十六进制字符串",
  "region": "cn"
}

字段	用途
ip	局域网 IP，用于本地 miio 协议通信
token	设备认证 Token，接入 Home Assistant 等必需
model	设备型号，用于匹配集成组件

点击右上角 复制 按钮可将完整 JSON 复制到剪贴板。

---

6. 典型使用场景

6.1 接入 Home Assistant

1. 在本工具获取设备 ip 与 token
2. 在 Home Assistant 中添加 Xiaomi Miio 集成
3. 填入 IP 和 Token 完成配对

6.2 接入 EdgeIOT / 智鸿 OS

1. 提取目标设备 Token
2. 在 EdgeIOT 平台创建设备或使用插件接入
3. 配置 miio 协议参数进行控制

6.3 批量导出

1. 选择 全部区域
2. 获取设备列表
3. 复制 JSON 保存为本地文件
4. 批量导入到自动化脚本或配置管理工具

---

7. 注意事项

1. 账号安全：Token 具有设备控制权限，请勿泄露
2. 网络要求：部分设备信息依赖小米云服务，需能访问 Xiaomi Cloud API
3. Token 有效期：设备重置或重新绑定后 Token 可能变化，需重新提取
4. 区域选择：设备仅存在于特定区域时，选择「全部区域」可避免因区域不匹配导致列表为空
5. 登录失效：长时间未操作需重新登录，点击 退出登录 后重新认证

---

8. 操作流程 Checklist

• [ ] 访问 https://zhihongos.cn/mi_cloud
• [ ] 使用二维码或账号密码登录小米账号
• [ ] 选择服务器区域
• [ ] 点击「获取设备列表」
• [ ] 在右侧 JSON 面板查看/复制 IP 与 Token
• [ ] 将 Token 配置到目标系统（Home Assistant / EdgeIOT 等）
• [ ] 使用完毕后点击「退出登录」

---

附录：截图索引

截图	说明
01_首页.png	工具首页（三栏布局）
02_二维码登录.png	二维码登录 Tab
03_二维码生成.png	二维码生成中
04_账号密码登录.png	账号密码登录 Tab
05_获取设备列表提示.png	获取设备列表操作

本工具界面默认为中文，截图通过 Firefox 无头浏览器自动采集。