Роботы-пылесосы Xiaomi давно стали неотъемлемой частью экосистемы умного дома, но их полноценная интеграция с сторонними системами (вроде Home Assistant, Node-RED или ioBroker) требует двух ключевых параметров: локального IP-адреса устройства и уникального токена. Без них вы не сможете отправлять прямые команды через API, настраивать автоматизации по расписанию или обходить облачные ограничения Mi Home.
Проблема в том, что Xiaomi не предоставляет эту информацию в открытом виде — её приходится извлекать обходными путями. В этой статье мы разберём все актуальные методы получения IP и токена для моделей Mi Robot Vacuum, Viomi, Dreame и других пылесосов на платформе Xiaomi, включая способы через мобильное приложение, роутер, терминал и даже физический доступ к устройству. Особое внимание уделим новым моделям с протоколом MiOT (2023–2026 гг.), где стандартные методы могут не работать.
Зачем нужны IP и токен робота-пылесоса?
Большинство пользователей ограничиваются базовым управлением через Mi Home, но это далеко не все возможности устройства. Вот почему вам могут понадобиться IP и токен:
- 🔄 Локальное управление без облака: отправка команд напрямую по локальной сети (без задержек и зависимости от серверов Xiaomi).
- 🤖 Интеграция с Home Assistant: создание сложных автоматизаций (например, запуск уборки при уходе из дома или по данным с датчиков пыли).
- 📊 Расширенная телеметрия: доступ к скрытым параметрам (износ щёток, история уборок, карты помещений в высоком разрешении).
- 🔧 Обход региональных ограничений: некоторые функции (например, зонирование) могут быть заблокированы для вашего региона в Mi Home.
Без токена вы не сможете авторизоваться в API пылесоса, а без IP — просто не найдёте устройство в локальной сети. При этом Xiaomi регулярно ужесточает защиту: если раньше токен можно было извлечь из пакета приложения, то теперь для новых моделей требуются альтернативные методы.
⚠️ Внимание: Извлечение токена нарушает пользовательское соглашение Xiaomi. Это может привести к блокировке аккаунта или ограничению функциональности устройства. Используйте данные методы на свой страх и риск.
Способ 1: Получение IP-адреса через приложение Mi Home
Самый простой способ найти IP — использовать официальное приложение Mi Home. Однако он работает только если пылесос подключён к вашей сети Wi-Fi (не через Bluetooth!). Следуйте инструкции:
- Откройте Mi Home и перейдите на страницу вашего робота-пылесоса.
- Тапните по трём точкам в правом верхнем углу →
Настройки→Общие настройки. - Прокрутите вниз до блока
Сеть— здесь будет указан локальный IP-адрес (например,192.168.1.105).
Если пункта Сеть нет, попробуйте альтернативный путь:
- В Mi Home перейдите в
Профиль→Настройки→Умный дом→Устройства. - Выберите свой пылесос и нажмите
Информация об устройстве. - В некоторых версиях приложения IP отображается в разделе
Сетевая информация.
Если IP не отображается, проверьте:
- 🔌 Подключен ли пылесос к Wi-Fi (не к мобильному интернету через телефон).
- 📱 Обновлено ли приложение Mi Home до последней версии.
- 🌍 Регион аккаунта: в некоторых странах (например, Китай) IP может скрываться.
Способ 2: Поиск IP через роутер
Если Mi Home не показывает IP, его можно найти в списке подключённых устройств вашего роутера. Этот метод универсален и работает для любых сетевых гаджетов. Инструкция зависит от модели роутера, но общий алгоритм такой:
- Откройте веб-интерфейс роутера, введя в браузере его IP (обычно
192.168.0.1или192.168.1.1). - Авторизуйтесь (логином и паролем, указанными на наклейке роутера).
- Найдите раздел
Подключённые устройства,Локальная сетьилиDHCP Clients List. - В списке найдите устройство с названием, содержащим
roborock,miioилиviomi.
Примеры названий устройств в роутере:
| Модель пылесоса | Название в роутере |
|---|---|
| Xiaomi Mi Robot Vacuum-Mop 2 | roborock.vacuum.m1s или miio12345678 |
| Viomi V3 | viomi.vacuum.v7 или lumi.12345678 |
| Dreame D9 | dreame.vacuum.p2008 или rockrobo.vacuum.v1 |
| Mi Robot Vacuum X10+ | roborock.vacuum.a15 или miot-12345678 |
Если в роутере много устройств, отключите пылесос от сети на 1–2 минуты, затем обновите список подключённых гаджетов — исчезнувший и вновь появившийся IP будет принадлежать роботу.
⚠️ Внимание: Некоторые роутеры (особенно от провайдеров) скрывают список устройств. В этом случае используйте сторонние приложения для сканирования сети, например Fing (Android/iOS) или Advanced IP Scanner (Windows).
Способ 3: Извлечение токена через Mi Home (старые модели)
Для пылесосов, выпущенных до 2022 года, токен можно было получить путём перехвата сетевого трафика приложения Mi Home. Сейчас этот метод работает только для устаревших прошивок, но мы приведем его для полноты информации.
☑️ Подготовка к извлечению токена
Пошаговая инструкция:
- Установите на ПК программу для перехвата трафика (например, Charles Proxy или Fiddler).
- Настройте прокси на телефоне (в настройках Wi-Fi укажите IP ПК и порт
8888). - Запустите Mi Home и дождитесь загрузки данных пылесоса.
- В Charles найдите запрос к домену
api.io.mi.comилиmiot-spec.org. - В теле запроса или ответа будет строка
"token": "ваш_токен"(обычно 32 символа).
Пример фрагмента ответа с токеном:
{
"result": {
"token": "5a4d8e1f2c3b6a7d8e9f0a1b2c3d4e5f",
"did": "miio12345678",
"localip": "192.168.1.105"
}
}
Для новых моделей (Mi Robot Vacuum-Mop 2 Pro, X10+ и др.) этот метод не работает — Xiaomi шифрует токен. В этом случае используйте альтернативные способы (см. следующий раздел).
Почему Xiaomi скрывает токен?
Токен — это уникальный ключ доступа к API устройства. Его раскрытие позволяет обходить облачные ограничения и отправлять команды напрямую, что противоречит бизнес-модели Xiaomi (они заинтересованы в использовании их экосистемы). Кроме того, токен может быть использован для несанкционированного управления устройством, если злоумышленник получит доступ к вашей локальной сети.
Способ 4: Получение токена через Home Assistant (MiOT)
Для современных пылесосов (2023–2026 гг.) единственный надёжный способ получить токен — использовать интеграцию Mi Home в Home Assistant с протоколом MiOT. Этот метод не требует перехвата трафика и работает даже для устройств с последними прошивками.
Инструкция:
- Установите Home Assistant (например, на Raspberry Pi или в Docker).
- В файле
configuration.yamlдобавьте:
miot:
username: ваш_email@mi.com
password: ваш_пароль
country: cn # или ваш регион (ru, us, de и др.)
- Перезапустите Home Assistant и дождитесь появления устройств в разделе
Интеграции. - Найдите свой пылесос и скопируйте токен из его свойств (поле
miot_token).
Если интеграция не находит устройство:
- 🔄 Проверьте регион аккаунта в Mi Home (должен совпадать с
countryв конфиге). - 🔒 Включите в Mi Home опцию
Разрешить доступ к устройству из локальной сети(в настройках пылесоса). - 📡 Убедитесь, что Home Assistant и пылесос подключены к одной сети.
⚠️ Внимание: При использовании Home Assistant в облачном режиме (например, через Nabu Casa) токен может передаваться на внешние серверы. Для безопасности используйте только локальный доступ.
Способ 5: Физическое извлечение токена (для продвинутых)
Если программные методы не сработали, токен можно извлечь напрямую из памяти пылесоса, подключившись к нему через ADB или SSH. Этот способ подходит только для опытных пользователей и требует:
- 🔧 Разобранного пылесоса (доступ к материнской плате).
- 🖥️ Компьютера с установленными
ADBи драйверами. - 🔌 Кабеля USB-Type-C (для подключения к плате).
Краткая инструкция:
- Подключитесь к пылесосу через
ADB:
adb shell
- Найдите файл с токеном (обычно в
/data/miio/device.tokenили/mnt/default/miio/miio_token.conf). - Скопируйте его на ПК:
adb pull /data/miio/device.token C:\token.txt
На новых моделях путь к токену может отличаться. Для его поиска используйте команду:
adb shell find / -name "token" 2>/dev/null
Этот метод рискован: неправильные действия могут привести к потере гарантии или повреждению прошивки. Используйте его только если другие способы не сработали.
Проблемы и решения
При извлечении IP и токена пользователи часто сталкиваются с типичными ошибками. Мы собрали самые распространённые из них и способы их решения:
| Проблема | Возможная причина | Решение |
|---|---|---|
| IP не отображается в Mi Home | Пылесос подключён через Bluetooth или мобильный интернет | Подключите его к Wi-Fi и перезагрузите |
Токен состоит из одних нулей (0000...) |
Устройство использует новый протокол MiOT | Получите токен через Home Assistant (см. Способ 4) |
| Home Assistant не находит пылесос | Несовпадение региона аккаунта | Проверьте параметр country в конфиге |
| После перепрошивки токен изменился | Обновление прошивки сбросило ключи | Повторите процедуру получения токена |
Если ни один из методов не сработал, проверьте:
- 📋 Версию прошивки пылесоса (в Mi Home →
Настройки→Об устройстве). Новые прошивки могут блокировать старые способы. - 🔄 Регион сервера: некоторые функции доступны только для китайских аккаунтов (
country: cn). - 🛡️ Брандмауэр роутера: он может блокировать локальные запросы к пылесосу.
FAQ: Частые вопросы
Можно ли использовать один токен для нескольких пылесосов?
Нет, токен уникален для каждого устройства. Даже два одинаковых пылесоса одной модели будут иметь разные токены.
Что делать, если IP пылесоса постоянно меняется?
Настройте на роутере статический IP для MAC-адреса пылесоса или используйте резервирование DHCP. Инструкция зависит от модели роутера, но обычно это делается в разделе DHCP Reservation или Статическая аренда.
Как проверить, работает ли токен?
Отправьте тестовый запрос через curl или Postman:
curl -X POST http://[IP_пылесоса]/miIO.info -d '{"id":1}' -H "Content-Type: application/json"
Если токен верный, вы получите ответ с информацией об устройстве. Если нет — ошибку {"error":"invalid token"}.
Можно ли сбросить токен и получить новый?
Да, но для этого нужно сбросить пылесос к заводским настройкам (в Mi Home → Настройки → Сбросить настройки). После этого придётся заново подключать устройство к Wi-Fi и извлекать токен.
Безопасно ли хранить токен в облаке (например, в Google Sheets)?
Нет. Токен даёт полный контроль над пылесосом. Если ваш аккаунт Google будет взломан, злоумышленник сможет управлять устройством. Храните токен только в локальных зашифрованных файлах (например, в KeePass или Bitwarden).