Как узнать токен Xiaomi Mi Robot Vacuum через ПК

Интеграция роботизированных пылесосов Xiaomi в альтернативные системы умного дома, такие как Home Assistant, OpenHAB или Domoticz, часто требует получения уникального идентификатора устройства. Этот цифровой ключ, известный как токен, необходим для авторизации стороннего программного обеспечения в облаке Mi Cloud. Без этого 32-символьного кода прямое локальное управление устройством или расширенная настройка через ПК невозможны.

Существует несколько способов извлечения этой информации, и использование персонального компьютера здесь является наиболее надежным вариантом. Мобильные методы с использованием root-прав или эмуляторов могут быть нестабильны, тогда как ПК позволяет использовать полноценные инструменты отладки и снифферы трафика. В этой статье мы разберем технические методы получения токена, которые работают с большинством моделей Xiaomi Vacuum, Roborock и Viomi.

Процесс получения токена через компьютер требует внимательности и базового понимания работы сетевых протоколов. Вам не обязательно быть программистом, но необходимо точно следовать инструкциям по установке библиотек и запуску скриптов. Ошибки на этапе настройки окружения могут привести к тому, что утилита не сможет перехватить нужный пакет данных.

Зачем нужен токен и где он используется

Токен представляет собой строку из 32 шестнадцатеричных символов, которая генерируется при первом подключении устройства к Wi-Fi роутеру. Этот ключ шифрует весь трафик между вашим смартфоном или компьютером и самим пылесосом. Протокол MiIO, используемый экосистемой Xiaomi, полагается на эту пару «IP-адрес + Токен» для выполнения любых команд, от запуска уборки до получения карты помещения.

Основная сфера применения токена — это локальное управление без задержек. Облачный метод управления имеет лаги и зависит от серверов производителя, которые могут быть недоступны. Используя токен в связке с ПО на ПК или домашнем сервере, вы получаете мгновенный отклик. Это критически важно для создания сложных сценариев автоматизации, где пылесос должен реагировать на события других датчиков в реальном времени.

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

Кроме того, знание токена позволяет использовать расширенные функции, скрытые в официальном приложении. Сторонние интеграции часто открывают доступ к управлению зоной уборки по координатам, регулировке мощности всасывания с шагом в 1%, а также к данным о расходе фильтров и щеток в реальном времени. Для моделей Xiaomi Mi Robot Vacuum Mop P или Roborock S5 Max это единственная возможность полноценной работы вне экосистемы Mi Home.

Подготовка программного окружения на компьютере

Для извлечения токена нам потребуется среда выполнения Python. Это кроссплатформенный язык программирования, который позволяет запускать специализированные скрипты для взаимодействия с IoT-устройствами. Установка Python на компьютер — первый и обязательный шаг, без которого дальнейшие действия невозможны. Рекомендуется использовать версию 3.7 или выше, так как старые версии могут не поддерживать необходимые библиотеки шифрования.

После установки интерпретатора необходимо подготовить пакетный менеджер pip, который идет в комплекте с современными версиями Python. Через него мы установим библиотеку python-miio (или miio), разработанную сообществом для работы с устройствами Xiaomi. Эта библиотека содержит все необходимые функции для генерации запросов и расшифровки ответов от пылесоса.

Важно убедиться, что ваш компьютер и пылесос находятся в одной локальной сети. Если вы используете ноутбук, подключите его к той же Wi-Fi сети, к которой привязан робот. Использование гостевой сети или изоляции клиентов (AP Isolation) на роутере заблокирует обмен данными, и скрипт не сможет найти устройство.

Для установки необходимой библиотеки откройте командную строку (Terminal в macOS/Linux или CMD/PowerShell в Windows) и введите команду:

pip install python-miio

Если система выдаст ошибку прав доступа, попробуйте добавить флаг --user или запустить терминал от имени администратора. Успешная установка подтвердится сообщением о завершении процесса. Теперь ваш компьютер технически готов к взаимодействию с экосистемой умного дома.

Метод получения токена через сниффер трафика (mitmproxy)

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

Сначала установите mitmproxy на ваш ПК. Это инструмент с открытым исходным кодом, который позволяет анализировать HTTPS-трафик. После установки запустите сервер. Вам нужно будет настроить прокси-соединение на вашем компьютере или эмуляторе Android, указав IP-адрес компьютера и порт, который использует mitmproxy (обычно 8080).

Ключевой момент — установка корневого сертификата mitmproxy на устройство, с которого будет производиться вход. Без этого приложение будет видеть ошибку соединения и не сможет передать данные. После установки сертификата и настройки прокси, запустите приложение Mi Home на эмуляторе или телефоне (если настроили прокси на уровне Wi-Fi роутера, что сложнее) и выполните действие, которое требует связи с сервером, например, обновление статуса устройства.

Почему метод с эмулятором надежнее?

Использование эмулятора Android (например, BlueStacks или Nox) на ПК позволяет легко установить корневой сертификат mitmproxy в системное хранилище. На реальном смартфоне это сделать сложнее без root-прав, так как Android блокирует установку недоверенных сертификатов для системных приложений.

В логах mitmproxy вы увидите множество запросов. Вам нужно найти POST-запрос к домену, содержащему api.io.mi.com или api.mi.com. В теле этого запроса или в заголовках будет содержаться JSON-ответ, где среди прочего будет поле result.token или просто token.

Этот метод хорош тем, что он работает даже если у вас двухфакторная авторизация, так как вы входите в акка-унт через официальное приложение. Однако, он требует внимательности при фильтрации трафика, так как объем данных может быть большим.

Использование Python-скрипта для токенизации

Существует более прямой способ, использующий логику работы приложения. Скрипт miio имеет встроенную функцию получения токена, если у вас есть доступ к определенным данным сессии. Однако, чаще всего используют скрипт, который эмулирует вход в аккаунт Xiaomi.

Для этого метода вам понадобятся ваш логин (номер телефона или email) и пароль от аккаунта Mi Cloud. Создайте файл с расширением .py на компьютере и вставьте в него код для авторизации. Библиотека miio позволяет выполнить вход и получить список устройств вместе с их токенами.

Пример команды для получения информации об устройстве, если токен уже известен (для проверки), выглядит так:

miio device --ip 192.168.1.50 --token 1234567890abcdef info

Но для именно получения токена через скрипт входа, процесс выглядит иначе. Вам нужно использовать утилиту, которая часто поставляется отдельно или является частью репозитория python-miio под названием miio-extract-tokens (если доступна) или написать простой скрипт, использующий API Xiaomi.

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

• 🔑 Введите логин и пароль от аккаунта Xiaomi в скрипт.
• 🌐 Скрипт отправляет запрос на сервер авторизации Xiaomi.
• 📱 Если включена двухфакторная защита, введите код из СМС в консоль.
• 💾 Скрипт получает список всех устройств и выводит их токены в текстовом виде.

⚠️ Внимание: Передача логина и пароля сторонним скриптам несет потенциальные риски. Используйте этот метод только если доверяете исходному коду библиотеки python-miio и запускаете её в изолированной среде. Для максимальной безопасности рекомендуется временно сменить пароль после получения токена.

Результатом работы скрипта будет список, где каждому устройству соответствует его DID (Device ID) и токен. Найдите в списке ваш пылесос по имени или MAC-адресу и скопируйте соответствующую строку токена.

Альтернативные методы: эмуляторы и базы данных

Если методы с Python кажутся слишком сложными, можно использовать эмуляторы Android на ПК, такие как BlueStacks, NoxPlayer или LDPlayer. Суть метода заключается в установке приложения Mi Home внутрь эмулятора, авторизации и последующем извлечении базы данных, где токены хранятся в открытом (или легко декодируемом) виде.

Порядок действий:

1. Установите эмулятор Android и приложение Mi Home.
2. Авторизуйтесь и дождитесь появления пылесоса в списке.
3. Получите root-доступ внутри эмулятора (обычно встроенная функция).
4. Найдите файл базы данных miio.db или smart_home.db в директории приложения.
5. Скопируйте файл на ПК и откройте через SQLite Browser.

Внутри базы данных нужно найти таблицу Device или similar. Токен может храниться в поле token. В некоторых версиях приложения токены шифруются, но ключ дешифровки часто хранится там же или является статичным для версии приложения.

Этот метод хорош тем, что не требует написания кода, но требует умения работать с файловой системой Android и SQL-базами данных. Для моделей Xiaomi Vacuum E10 или новых версий прошивок структура базы может отличаться.

Сравнение методов и troubleshooting

Каждый из описанных методов имеет свои преимущества и недостатки. Выбор зависит от вашей технической подготовки и конкретной модели пылесоса. Ниже приведена сравнительная таблица, которая поможет определиться со способом действий.

Часто пользователи сталкиваются с ошибкой «Invalid token» или «Unable to discover device». Это может означать, что пылесос находится в другой подсети, или на роутере включена изоляция точек доступа. Убедитесь, что брандмауэр Windows или антивирус не блокируют входящие соединения для Python или mitmproxy.

Также возможна ситуация, когда Xiaomi меняет алгоритмы шифрования или API. В этом случае старые версии библиотеки python-miio могут не работать. Всегда обновляйте библиотеку до последней версии командой pip install --upgrade python-miio.

Часто задаваемые вопросы (FAQ)

Можно ли получить токен, если пылесос уже настроен и работает?

Да, все описанные методы работают для уже настроенных устройств. Вам не нужно сбрасывать пылесос или перепривязывать его. Токен хранится на сервере и в приложении, пока вы не выполните полный сброс устройства до заводских настроек.

Что делать, если скрипт пишет "Login failed"?

Проверьте правильность логина и пароля. Убедитесь, что вы выбрали правильный регион сервера (Китай, Европа, Россия и т.д.) в настройках скрипта, если такая опция есть. Также проверьте, не требуется ли подтверждение входа через СМС на вашем телефоне.

Изменится ли токен после обновления прошивки пылесоса?

В большинстве случаев токен остается неизменным после обновления прошивки OTA (Over-The-Air). Однако, если вы сбросите Wi-Fi настройки на самом пылесосе (зажав кнопки сброса), токен сменится, и процедуру придется повторить.

Безопасно ли использовать китайскую версию приложения для получения токена?

Использовать можно любую версию приложения, к которой привязано устройство. Если ваш пылесос привязан к региону "Китай", то и вход в скрипте нужно выполнять в китайский сервер. Токен един для всех регионов, но серверы авторизации разные.

Где именно хранить полученный токен для Home Assistant?

В конфигурационном файле configuration.yaml (или через графический интерфейс интеграции) в поле token. Для Xiaomi Mi Robot Vacuum это поле часто называется просто token и принимает строку из 32 символов.