Tuya в Home Assistant: облачная интеграция и Local Tuya

Tuya в Home Assistant подключается двумя способами: через официальную облачную интеграцию Tuya (вход по QR-коду из приложения Smart Life или Tuya Smart) или локально через пользовательские компоненты Local Tuya и Tuya Local из HACS. Облако проще и подходит большинству устройств, локальный способ быстрее и работает без интернета, но требует получить ключи устройств. Ниже разберём оба пути и их ограничения.

1Облачная интеграция Tuya: быстрый старт

Официальная интеграция входит в состав Home Assistant. Она получает устройства из вашего аккаунта Tuya, поэтому сначала их нужно добавить в приложение Smart Life или Tuya Smart.

Добавьте устройства в приложение Smart Life (или Tuya Smart) и убедитесь, что они работают.
В Home Assistant откройте «Настройки» → «Устройства и службы» → «Добавить интеграцию» и выберите Tuya.
Введите пользовательский код из приложения (он находится в настройках учётной записи; расположение пункта может отличаться в версиях приложения).
Отсканируйте QR-код в приложении Smart Life и подтвердите вход.
Устройства появятся в Home Assistant, назначьте им помещения.

Если мастер просит данные из Tuya IoT Platform (Access ID, Access Secret), значит используется старая схема: нужно зарегистрироваться на платформе разработчиков Tuya, создать облачный проект с правильным центром обработки данных (он зависит от региона вашей учётной записи) и связать приложение. Сейчас приоритет у входа по QR-коду, поэтому сверьтесь с документацией интеграции в вашей версии Home Assistant.

2Что умеет облако и где подводные камни

Параметр	Облачная интеграция	Локальная (Local Tuya / Tuya Local)
Скорость отклика	Зависит от облака, возможны задержки	Мгновенно, по локальной сети
Работа без интернета	Нет	Да
Сложность настройки	Низкая	Средняя: нужны ключи устройств
Зависимость от аккаунта производителя	Да	Только на этапе получения ключей
Нестандартные функции	Ограничены набором стандартных кодов	Гибко, можно задавать DP вручную
Установка	Встроена	Через HACS

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

3Локальное управление: Local Tuya и Tuya Local

Оба компонента ставятся через HACS и общаются с устройствами по локальной сети по протоколу Tuya (версии 3.3, 3.4 и 3.5). Для них нужен локальный ключ (local key) каждого устройства и его IP-адрес. Различие в подходе такое.

Local Tuya — вы вручную сопоставляете функции устройства (DP-идентификаторы) с сущностями Home Assistant. Гибко, но требует понимания, какая функция какому номеру соответствует.
Tuya Local — использует готовые шаблоны для известных моделей, поэтому настройка занимает минуты, если ваше устройство есть в списке поддерживаемых.

Состояние проектов и форков меняется, поэтому перед установкой проверьте, какой репозиторий сейчас обновляется, и прочитайте инструкцию в нём.

4Как получить local key

Подключите устройства к приложению Smart Life.
Зарегистрируйтесь на платформе разработчиков Tuya (iot.tuya.com), создайте облачный проект и привяжите к нему приложение через QR-код.
Выберите правильный центр обработки данных: неверный регион — частая причина пустого списка устройств.
В разделе устройств найдите свои устройства и скопируйте идентификатор (Device ID) и локальный ключ. Некоторые компоненты умеют получать ключи автоматически через облачный проект с помощью встроенного мастера.
Узнайте IP-адрес устройства в роутере и закрепите его.
Добавьте устройство в Local Tuya или Tuya Local, указав Device ID, IP, ключ и версию протокола.

Учтите, что локальный ключ меняется, если вы заново добавляете устройство в приложение: после этого его нужно обновить в Home Assistant. Платформа разработчиков Tuya периодически требует продлить пробную подписку на облачные сервисы, но на уже полученные ключи это обычно не влияет.

Нет времени разбираться? Мы можем настроить Home Assistant под ключ и подключить ваши устройства Tuya локально.

5Пример автоматизации с розеткой Tuya

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

alias: Выключать удлинитель ночью
triggers:
  - trigger: time
    at: "00:30:00"
conditions:
  - condition: state
    entity_id: switch.udlinitel_tuya
    state: "on"
actions:
  - action: switch.turn_off
    target:
      entity_id: switch.udlinitel_tuya
mode: single

Похожие правила без YAML можно собрать в нашем конструкторе автоматизаций.

6Tuya Zigbee и Wi-Fi: чем отличаются

В экосистеме Tuya встречаются Wi-Fi-устройства и Zigbee-датчики. Wi-Fi-устройства работают через облачную или локальную интеграцию, как описано выше. Zigbee-датчики Tuya лучше подключать напрямую к ZHA или Zigbee2MQTT, минуя родной шлюз и облако: так вы получаете локальность и скорость. Некоторые устройства используют нестандартные кластеры, и для них в ZHA приходится ставить дополнительные «quirks», а Zigbee2MQTT часто поддерживает их из коробки.

7Как снизить зависимость от облака

Если вы уже купили много устройств Tuya, не обязательно менять их все. Разумный план: оставьте облачную интеграцию для малокритичных устройств, переведите на локальное управление розетки, реле и выключатели, а Zigbee-датчики перенесите на свой координатор. Дополнительно зарезервируйте IP-адреса, чтобы локальные подключения не ломались, и держите устройства в отдельной сети Wi-Fi 2,4 ГГц с хорошим покрытием. Ещё один способ — перепрошить совместимые устройства на Tasmota или ESPHome, но это требует разборки и пайки, а у новых моделей чипы часто прошить нельзя.

8Частые проблемы

Устройства не видны в интеграции. Неверный регион/центр обработки данных, либо устройство привязано к другому аккаунту.
Локальное устройство «недоступно». У устройства поменялся IP-адрес или ключ; зарезервируйте IP в роутере.
Только одно подключение. Многие устройства Tuya принимают ограниченное число локальных соединений: если параллельно открыто другое приложение, Home Assistant может не подключаться.
Неверная версия протокола. Попробуйте 3.3, 3.4 или 3.5.
Дубли сущностей. Если одновременно включены облачная и локальная интеграции, одно и то же устройство появится дважды. Отключите лишнее.

9Безопасность и резервные копии

Локальные ключи устройств — это секреты, поэтому не публикуйте их в открытых репозиториях и скриншотах. Храните ключи в файле secrets.yaml или в самих настройках интеграции, а перед обновлением Home Assistant делайте копию. Если устройство подключено к чужой сети Wi-Fi или находится в гостевой сети, проверьте, что роутер разрешает локальные подключения между сегментами: иначе Local Tuya не увидит устройство. Для гостевых сетей включите маршрутизацию между сетями или переведите устройства в основную.

Если вы только планируете покупку, отдавайте предпочтение устройствам, которые уже есть в списках поддержки Local Tuya или Tuya Local, либо Zigbee-версиям: они не зависят от облака и проще в настройке. Сверяйтесь с отзывами владельцев Home Assistant, а не только с описанием в магазине.

10Частые вопросы

Что лучше: облако или локально?

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

Нужен ли аккаунт Tuya, если всё локально?

Для получения ключей — да. После настройки работа идёт по локальной сети.

Можно ли использовать приложение Smart Life одновременно с Home Assistant?

Да, но с оговорками: при локальном управлении часть устройств принимает одно соединение за раз. Если возникают конфликты, закройте приложение или управляйте через Home Assistant.

Подходят ли устройства Tuya для безопасности?

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

11Итог

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