Как узнать токен пылесоса Xiaomi: официальные и неофициальные методы

Роботы-пылесосы Xiaomi (включая модели Mi Robot, Dreame, Viomi) требуют токен авторизации для интеграции со сторонними системами умного дома, такими как Home Assistant, Node-RED или OpenHab. Этот уникальный идентификатор связывает устройство с вашим аккаунтом Mi Account и позволяет управлять пылесосом через API, минуя официальное приложение. Однако производитель не предоставляет токен в открытом виде — его нужно извлекать самостоятельно.

В этой статье вы найдёте 5 актуальных способов получить токен, включая официальный метод через Mi Home/Xiaomi Home, парсинг сетевого трафика, использование скриптов для Python и даже ручное извлечение из файлов резервной копии. Мы также разберём риски блокировки аккаунта при использовании неофициальных методов и дадим рекомендации по безопасности. Если вы планируете интегрировать пылесос в систему умного дома или просто хотите разблокировать расширенные функции — читайте дальше.

Что такое токен пылесоса Xiaomi и зачем он нужен

Токен (или authentication token) — это уникальный 32-символьный ключ, который генерируется серверами Xiaomi при первом подключении устройства к аккаунту. Он служит для:

• 🔐 Аутентификации запросов к API пылесоса (например, для отправки команд на уборку или получение карты помещения).
• 🏠 Интеграции с системами умного дома (Home Assistant, ioBroker, Domoticz).
• 🛠️ Разблокировки скрытых функций (например, зонирование уборки в старых прошивках).
• 📊 Сбора статистики (время работы, покрытая площадь, ошибки) через сторонние сервисы.

Без токена вы ограничены возможностями официального приложения Mi Home/Xiaomi Home, которое часто скрывает продвинутые настройки или работает нестабильно в некоторых регионах. Например, в моделях Xiaomi Mi Robot Vacuum-Mop 2 Pro или Dreame D9 токен требуется для:

• 🗺️ Загрузки карты помещения в реальном времени.
• 🔄 Настройки расписания уборки с точностью до минуты (в приложении шаг — 30 минут).
• 🔊 Изменения голосовых оповещений или отключения звуков.

⚠️ Внимание: Неофициальное использование токена может нарушать пользовательское соглашение Xiaomi. В редких случаях аккаунт блокируют за "подозрительную активность" (например, слишком частые запросы к API). Рекомендуем создавать отдельный аккаунт для интеграций.

Способ 1: Получение токена через официальное приложение (без рутинга)

Самый безопасный метод — извлечь токен из трафика приложения Mi Home или Xiaomi Home с помощью прокси-сервера или специализированных утилит. Вам не потребуются root-права или модификация прошивки пылесоса.

Алгоритм действий:

1. Установите на смартфон приложение для перехвата трафика — например, HTTP Toolkit (Android) или Charles Proxy (iOS/Android/PC).
2. Настройте прокси в телефоне (адрес и порт укажет выбранная утилита).
3. Запустите Mi Home, войдите в аккаунт и подключитесь к пылесосу.
4. В логах прокси найдите запрос к домену api.io.mi.com с путьём /app/genToken — в ответе будет строка "token": "ваш_токен".

Для упрощения процесса можно использовать скрипт mihome-bin (доступен на GitHub):

git clone https://github.com/Maxmudjon/com.xiaomi-miio.git
cd com.xiaomi-miio
python3 -m pip install -r requirements.txt
python3 miio_extract_token.py

Установить приложение для перехвата трафика

Настроить прокси на телефоне

Авторизоваться в Mi Home и подключиться к пылесосу

Найти запрос к api.io.mi.com в логах

Скопировать токен из ответа сервера-->

Этот метод работает для большинства моделей, включая:

• 🤖 Xiaomi Mi Robot Vacuum 1/2/Pro
• 🧹 Dreame D9, F9, Z10 Pro
• 🏡 Viomi V2/V3

⚠️ Внимание: Если вы используете Xiaomi Home (новое приложение), токен может передаваться в зашифрованном виде. В этом случае потребуется дополнительно извлечь ключ шифрования из APK-файла приложения.

Способ 2: Извлечение токена из резервной копии Mi Home

Если у вас есть резервная копия настроек Mi Home (созданная через Настройки → Резервное копирование), токен можно извлечь из файла mihome.sql или mihome_backup.db. Этот метод подходит для пользователей, у которых уже была настроена синхронизация с облаком.

Инструкция:

1. Скачайте резервную копию на ПК (файл будет в формате .zip или .ab).
2. Распакуйте архив и найдите файл базы данных (обычно mihome.sql или в папке databases).
3. Откройте файл в текстовом редакторе или через SQLite Browser.
4. Выполните запрос:

   SELECT token FROM devices WHERE model LIKE '%vacuum%';

   или найдите вручную строку с "token":.

Пример структуры файла mihome.sql:

Способ 3: Использование скриптов для Python (miio)

Библиотека Python-miio позволяет не только управлять устройствами Xiaomi, но и извлекать токен при наличии логинов от Mi Account. Этот метод подходит для технически подкованных пользователей.

Установите библиотеку и выполните скрипт:

pip install python-miio
python -c "from miio import ChuangmiPlug; print(ChuangmiPlug('IP_пылесоса', 'токен').info())"

Для автоматического получения токена используйте скрипт miio-cli:

miio --discover
miio --ip IP_пылесоса --token ваш_токен info

Если токен неизвестен, его можно получить через авторизацию в Mi Account (требуется логин и пароль):

from miio import ChuangmiPlug
device = ChuangmiPlug.ip_discover()
print(device.token)

Способ 4: Ручное извлечение токена из прошивки (для продвинутых)

Этот метод требует физического доступа к пылесосу и навыков работы с ADB или SSH. Подходит для моделей на базе Linux (например, Viomi V3 или Dreame Z10 Pro), где можно получить root-доступ.

Пошаговая инструкция:

1. Подключитесь к пылесосу по SSH (обычно порт 22, логин/пароль: root/123456 или admin/empty).
2. Выполните команду для поиска токена:

   cat /mnt/UDISK/config/miio/device.token

   или

   grep -r "token" /mnt/UDISK/

3. Если токен не найден, проверьте файлы конфигурации:

   cat /etc/miio/device.conf

Для моделей на MT7688 (например, Xiaomi Mi Robot 1S) можно использовать UART-консоль:

• 🔧 Подключитесь к контактам TX/RX/GND на плате (обычно рядом с микросхемой памяти).
• 🖥️ Используйте PuTTY или screen для подключения (скорость 115200 бод).
• 🔍 Введите команду cat /proc/mtd для поиска раздела с конфигурацией.

⚠️ Внимание: Неправильные команды в консоли могут навсегда вывести пылесос из строя. Если вы не уверены в своих действиях, используйте другие методы. Также помните, что открытие корпуса пылесоса снимает гарантию.

Способ 5: Покупка токена или использование общедоступных баз

Если все вышеперечисленные методы не сработали, остаётся два варианта:

1. Покупка токена на специализированных форумах (например, 4PDA или Xiaomi Community). Цена обычно не превышает 500–1000₽, но есть риск получить нерабочий или украденный ключ.
2. Поиск в открытых базах (например, GitHub Gist или Pastebin). Некоторые пользователи публикуют токены для тестирования, но они часто уже недействительны или привязаны к чужим аккаунтам.

Риски этих методов:

• 🚫 Блокировка аккаунта (если токен привязан к другому пользователю).
• 🔄 Нестабильная работа (токен может быть отозван сервером Xiaomi).
• 🕵️ Утечка данных (мошенники могут запросить доступ к вашему аккаунту).

Официальное приложение + прокси

Извлечение из резервной копии

Скрипты Python (miio)

Ручное извлечение из прошивки

Покупка токена-->

Частые ошибки и их решения

При работе с токенами пользователи сталкиваются с типичными проблемами. Вот самые распространённые и способы их устранения:

Если пылесос перестал отвечать после интеграции:

1. Отключите его от питания на 10–15 секунд.
2. Сбросьте настройки сети в приложении Mi Home.
3. Проверьте, не блокирует ли запросы ваш файрвол или антивирус.

FAQ: Ответы на популярные вопросы

python -m miio --ip IP_пылесоса --token ВАШ_ТОКЕН info