Как получить токен для пылесоса Xiaomi: все способы 2026 года

Роботы-пылесосы Xiaomi стали неотъемлемой частью умных домов, но для полноценного управления через сторонние приложения (вроде Home Assistant, ioBroker или Node-RED) требуется специальный токен доступа. Этот уникальный ключ позволяет интегрировать устройство в экосистемы, не ограниченные официальным приложением Mi Home. Однако процесс его получения часто вызывает вопросы — особенно у пользователей, которые впервые сталкиваются с настройкой умной техники.

В этой статье мы разберём все актуальные способы получения токена для пылесосов Xiaomi (включая модели Mi Robot Vacuum, Viomi, Dreame и другие), а также рассмотрим типичные ошибки и их решения. Важно понимать, что методы отличаются в зависимости от региона привязки устройства (Китай, Европа, Россия) и версии прошивки. Мы обновили инструкции с учётом изменений 2026 года — теперь они работают даже для новых устройств с усиленной защитой.

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

Токен — это уникальный алфавитно-цифровой ключ, который идентифицирует ваше устройство в облаке Xiaomi. Он необходим для:

  • 🔄 Интеграции с системами умного дома (Home Assistant, OpenHAB, Domoticz). Без токена пылесос не будет отображаться в этих платформах.
  • 📱 Управления через альтернативные приложения (например, Valetudo для локального контроля без облака).
  • 🛠️ Автоматизации задач (создание сценариев уборки по расписанию, триггеры на основе датчиков).
  • 🔧 Диагностики и отладки (просмотр логов, тестирование новых функций через API).

Официальное приложение Mi Home скрывает токен от пользователя, так как Xiaomi не поддерживает открытое API для сторонних разработчиков. Однако энтузиасты нашли обходные пути, которые мы и рассмотрим далее.

⚠️ Внимание: Получение токена может нарушать условия использования Xiaomi. В редких случаях это приводит к блокировке аккаунта (обычно при массовых запросах к API). Используйте методы на свой страх и риск.

Способ 1: Получение токена через Mi Home (официальный метод для старых версий)

Этот метод работал до 2022 года для устройств, привязанных к китайскому региону (cn). Сейчас он актуален только для пылесосов с прошивками старше 3.5.8. Если ваше устройство новое, переходите к Способу 2.

Инструкция:

  1. Откройте приложение Mi Home и перейдите в настройки пылесоса (Профиль → Настройки устройства → Общие).
  2. Нажмите на три точки в правом верхнем углу и выберите О программе.
  3. Тапните 5–7 раз по версии прошивки, пока не появится меню разработчика.
  4. В открывшемся окне найдите строку Token — это и есть ваш ключ.

Если пункта Token нет, значит:

  • 🌍 Устройство привязано к некитайскому региону (Европа, Россия).
  • 🔄 Прошивка новее 3.5.8Xiaomi убрала эту функцию.
  • 📱 Вы используете неоригинальную версию Mi Home (например, модифицированную для России).
📊 Какой регион у вашего аккаунта Mi Home?
Китай (cn)
Европа (eu)
Россия (ru)
Другой

Способ 2: Извлечение токена через HTTP-перехват (актуально для 2026 года)

Самый надёжный метод на сегодня — перехват сетевого трафика между приложением Mi Home и серверами Xiaomi. Для этого потребуется:

  • 📱 Android-смартфон (на iOS метод не работает из-за ограничений системы).
  • 🔌 Программа для перехвата трафика (HTTP Toolkit, Fiddler или Packet Capture).
  • 🔑 Root-права не требуются, но нужно установить сертификат перехвата.

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

  1. Установите программу для перехвата (рекомендуем HTTP Toolkit — она проще в настройке).
  2. Настройте прокси:
    • На Android: перейдите в Настройки → Wi-Fi → [ваша сеть] → Дополнительно → Прокси-сервер.
    • Укажите IP и порт из программы (например, 192.168.1.100:8080).
  • Установите сертификат:
    • В HTTP Toolkit перейдите во вкладку Certificates и скачайте сертификат для Android.
    • Установите его на телефон (потребуется разблокировать установку из неизвестных источников).
    • Запустите перехват и откройте Mi Home.
    • Обновите данные пылесоса (например, нажмите на него в главном меню).
    • Найдите запрос с URL, содержащим /home/device_list или /miot-spec/v2/.
    • Скопируйте токен из поля "token" в ответе сервера.
    • Установить HTTP Toolkit на ПК|Подключить телефон и ПК к одной сети|Настроить прокси на телефоне|Установить сертификат|Запустить перехват перед открытием Mi Home-->

      Пример ответа сервера (токен выделен):

      {
      

      "result": [

      {

      "did": "123456789",

      "token": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4",

      "name": "Mi Robot Vacuum",

      "model": "roborock.vacuum.a1"

      }

      ],

      "code": 0

      }

      ⚠️ Внимание: Если в ответе сервера нет поля token, значит ваш аккаунт привязан к региону с усиленной защитой (например, ru). Попробуйте сменить регион на Europe (eu) в настройках Mi Home (см. раздел про смену региона).

      Способ 3: Смена региона аккаунта для получения токена

      Многие пользователи сталкиваются с проблемой, когда токен не отображается из-за региональных ограничений. Решение — сменить регион аккаунта на Europe (eu) или China (cn). Это не требует создания нового аккаунта, но может потребовать VPN.

      Инструкция:

      1. Удалите приложение Mi Home и очистите его данные (Настройки → Приложения → Mi Home → Хранилище → Очистить данные).
      2. Установите Mi Home заново и при первом запуске выберите регион Europe (или China, если нужно).
      3. Авторизуйтесь под тем же аккаунтом (логин и пароль остаются прежними).
      4. Добавьте пылесос заново через Добавить устройство → Пылесос.
      5. Повторите Способ 2 (перехват трафика). Теперь токен должен появиться.
    Регион Вероятность успеха Требуется VPN? Примечания
    China (cn) 90% Да Самый надёжный вариант, но нужна китайская SIM или VPN с китайским IP.
    Europe (eu) 70% Нет Работает для большинства моделей, кроме новых Dreame.
    Russia (ru) 10% Нет Токен почти никогда не отображается.
    USA (us) 50% Нет Часто требует подтверждения по SMS.

    Способ 4: Использование сторонних утилит (для продвинутых пользователей)

    Если ручные методы не сработали, можно воспользоваться специализированными инструментами:

    • 🖥️ MiTokenextractor — скрипт на Python для автоматического извлечения токена из бэкапа Mi Home.
    • 📱 Packet Capture (Android) — упрощённая альтернатива HTTP Toolkit для мобильных устройств.
    • 🌐 Online-сервисы (например, Xiaomi Cloud Tokens Extractor) — работают через авторизацию в аккаунте Xiaomi, но небезопасны (риск утечки данных).
    • Пример работы с MiTokenextractor:

      1. Сделайте бэкап данных Mi Home через Настройки → О программе → Резервное копирование.
      2. Скачайте скрипт с GitHub.
      3. Запустите его через командную строку:
        python mi_extractor.py backup.ab
      4. В результате вы получите файл tokens.txt со всеми токенами ваших устройств.
      Что делать, если скрипт выдаёт ошибку?

      Убедитесь, что у вас установлен Python 3.8+ и библиотека protobuf (установите через команду pip install protobuf). Если ошибка связана с версией бэкапа, попробуйте использовать Mi Home версии 6.0.100 или ниже.

      Типичные ошибки и их решения

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

      Ошибка Причина Решение
      Токен не отображается в Mi Home Новая прошивка или регион ru Используйте перехват трафика или смените регион
      Приложение не подключается к пылесосу Сброс настроек устройства Удерживайте кнопку питания 10 секунд для сброса, затем добавьте заново
      Ошибка "Invalid token" в Home Assistant Токен устарел или неверный регион Получите новый токен или проверьте регион в настройках интеграции
      HTTP Toolkit не перехватывает трафик Не установлен сертификат или неверный прокси Проверьте настройки прокси и переустановите сертификат
      После смены региона пылесос не добавляется Устройство привязано к другому региону Сбросьте пылесос и добавьте его в новом регионе

      Если ни один из методов не сработал, проверьте:

      • 🔄 Версию прошивки пылесоса (обновите или откатните её через Mi Home).
      • 📱 Версию Mi Home (иногда помогает откат на старую версию, например, 5.9.54).
      • 🌐 Настройки сети (отключите IPv6, если используете прокси).

      Безопасность: как не потерять доступ к пылесосу

      Получение токена — процесс, который может повлиять на стабильность работы устройства. Чтобы избежать проблем:

      ⚠️ Внимание: Никогда не делитесь токеном в открытых источниках (форумы, GitHub, чаты). Злоумышленники могут получить контроль над вашим пылесосом, включая доступ к картам помещений и истории уборки.

      Рекомендации по безопасности:

      • 🔐 Храните токен в защищённом месте (например, в менеджере паролей).
      • 🔄 Регулярно обновляйте прошивку пылесоса, но проверяйте совместимость с вашей системой умного дома.
      • 🚫 Не используйте токен в облачных сервисах, которым не доверяете (риск утечки).
      • 📱 Отзывайте токен при продаже пылесоса (сбросьте устройство до заводских настроек).

      Если вы подозреваете, что токен скомпрометирован:

      1. Удалите пылесос из Mi Home.
      2. Сбросьте его настройки (удерживайте кнопку питания 10 секунд).
      3. Добавьте устройство заново — будет сгенерирован новый токен.

      FAQ: Частые вопросы о токенах Xiaomi

      Можно ли получить токен без перехвата трафика?

      Да, но только для старых устройств (прошивка до 3.5.8) через меню разработчика в Mi Home. Для новых моделей перехват — единственный надёжный способ.

      Работает ли токен после сброса пылесоса?

      Нет, токен привязан к текущей сессии устройства. После сброса или перепривязки к другому аккаунту генерируется новый ключ.

      Можно ли использовать один токен для нескольких пылесосов?

      Нет, каждый пылесос имеет уникальный токен. Однако один аккаунт Mi Home может управлять несколькими устройствами, и для каждого будет свой ключ.

      Что делать, если токен перестал работать?

      Вероятные причины:

      • 🔄 Обновление прошивки пылесоса (требуется получить новый токен).
      • 🔒 Смена пароля или email в аккаунте Xiaomi.
      • 🌐 Изменение региона аккаунта.

      Решение: повторите процесс получения токена заново.

      Как проверить, валиден ли токен?

      Используйте API-запрос для проверки статуса устройства:

      GET https://{api-region}.api.io.miot.xiaomi.com/home/device_list
      

      Headers:

      Cookie: userId={ваш_userId}; serviceToken={ваш_serviceToken}

      Если в ответе есть ваше устройство с указанным did, токен действует.