Интеграция ZONT с Home Assistant MQTT

Установка Zigbee2MQTT для ZONT

Программа Zigbee2MQTT позволяет подключить Zigbee-устройства (датчики, розетки, лампы, реле) к личному кабинету ZONT.

---

Windows

Установочный скрипт для Windows делает всё сам: ставит драйверы адаптера, саму программу и настраивает подключение к облаку ZONT по вашему логину и паролю. Вводить адреса серверов и пароли брокера вручную не нужно.

---

Linux и macOS

На Linux и macOS ставьте Zigbee2MQTT по официальной инструкции — запуск в Docker.

Учётные данные для подключения к облачному брокеру можно скопировать из настроек прибора «Home Assistant» (раздел Данные для подключения) в приложении ZONT.

Дополнительная информация в разделе «Техническим специалистам».

---

Что понадобится

• Компьютер с 64-разрядной Windows 10 или новее.
• Zigbee-стик*, вставленный в USB-порт (рекомендуем стик Zigbee 3.0 на базе TICC2652P).
• Логин и пароль от личного кабинета ZONT.
• Прибор типа «Home Assistant», заранее добавленный в приложении ZONT. Если такого прибора нет, установщик остановится и сообщит об этом.
• Права администратора на компьютере.
• Подключение к интернету.
• Скачать скрипты установки для Windows.

* Пример стика: Zigbee RF-DG-52PAS CC2652P USB

---

Как установить

1. Вставьте Zigbee-стик в USB-порт компьютера.
2. Извлеките файлы из скачанного архива z2m-setup.zip
3. Щёлкните по файлу Install-Zigbee2MQTT.bat правой кнопкой мыши и выберите «Запуск от имени администратора».
4. Дождитесь окончания. Установка идёт в одном окне и занимает от 5 до 20 минут в зависимости от скорости интернета.
5. В случае каких-либо ошибок вам будет выведено их описание и наиболее вероятные способы исправления.
6. Скрипт установки можно перезапускать повторно.

---

Что попросит установщик

За всю установку вас спросят только о трёх вещах, и все три — в самом начале.

Логин и пароль от личного кабинета ZONT. Пароль при вводе не отображается — это нормально, просто наберите его и нажмите Enter. Если в вашем аккаунте включена двухфакторная аутентификация, установщик дополнительно попросит код.

Прибор. Если в аккаунте один прибор Home Assistant, он выберется автоматически. Если несколько — появится список, введите номер строки:

В аккаунте несколько приборов Home Assistant. Выберите тот, к которому подключается Zigbee2MQTT: 1) Дом 2) Дача Введите номер прибора из списка:

Zigbee-стик. Если адаптер в компьютере один, он определится сам. Если портов несколько — выберите из списка тот, в который вставлен адаптер.

Дальше вмешательство не потребуется: остальные этапы пройдут без вопросов.

---

После установки

При первом запуске Windows может спросить, разрешить ли Zigbee2MQTT доступ к сети. Нажмите «Разрешить доступ» — без этого не откроется веб-интерфейс.

В конце установки в окне побегут строки — это Zigbee2MQTT запускается. Когда он заработает, внизу появится сообщение «ZIGBEE2MQTT ЗАПУЩЕН ИРАБОТАЕТ» с адресом веб-интерфейса:

http://localhost:3097

Дальше в этом окне появляются только сообщения об ошибках, если они будут.

Откройте адрес в браузере: в веб-интерфейсе добавляют Zigbee-устройства в сеть и смотрят их состояние. Устройства, добавленные в Zigbee2MQTT, появляются в приложении ZONT автоматически.

---

Как запускать Zigbee2MQTT в фоне

Пока Zigbee2MQTT запущен из окна установки, он работает только с открытым окном: закрыли окно — связь с Zigbee-устройствами прекратилась. Чтобы программа работала сама по себе и включалась вместе с компьютером, щёлкните по файлу Install-Zigbee2MQTT-Service.bat правой кнопкой мыши и выберите «Запуск от имени администратора».

После этого:

• программа запускается при включении компьютера, ещё до входа в Windows;
• окно держать открытым не нужно, веб-интерфейс работает как обычно;
• если программа даст сбой, Windows запустит её заново сама.

Запускать этот файл нужно уже после основной установки: пока Zigbee2MQTT не установлен, запускать в фоне нечего.

Окно с запущенным Zigbee2MQTT скрипт закроет сам: Zigbee-стик может использовать только одна копия программы.

---

Если Zigbee2MQTT перестал отвечать

Щёлкните по файлу Install-Zigbee2MQTT-Service.bat правой кнопкой мыши и выберите «Запуск от имени администратора» ещё раз. Повторный запуск безопасен: он перезапустит программу и ничего не сотрёт.

---

Как отключить фоновый режим

Щёлкните по файлу Uninstall-Zigbee2MQTT-Service.bat правой кнопкой мыши и выберите «Запуск от имени администратора». Программа перестанет запускаться сама, а её настройки и список Zigbee-устройств останутся на месте.

---

Как изменить настройки позже

Запустите Install-Zigbee2MQTT.bat ещё раз тем же способом. Уже установленные компоненты повторно не скачиваются — установщик сразу перейдёт к выбору прибора и адаптера. Прошлый выбор будет предложен по умолчанию: чтобы оставить его, достаточно нажать Enter.

---

Как удалить Zigbee2MQTT

Щёлкните по файлу Uninstall-Zigbee2MQTT.bat правой кнопкой мыши и выберите «Запуск от имени администратора».

Скрипт снимет службу Windows (если был включён фоновый режим), остановит программу и удалит её вместе с настройками. Про Node.js он спросит отдельно: им могут пользоваться другие программы на компьютере, поэтому по умолчанию Node.js остаётся. Чтобы удалить и его, ответьте «да».

Драйверы USB-адаптеров остаются в системе всегда: их используют не только Zigbee-стики, но и платы Arduino, программаторы и переходники USB-COM.

Вместе с программой стирается база Zigbee-сети: после повторной установки все Zigbee-устройства придётся подключать заново.

Прибор Home Assistant в личном кабинете ZONT удаление не затрагивает — если он больше не нужен, удалите его в приложении ZONT.

---

Если что-то пошло не так

В самом начале каждый файл показывает свою версию (например, версия 2026.9.1) — назовите её при обращении в поддержку, она же записана в журнале.

Рядом с файлом Install-Zigbee2MQTT.bat установщик создаёт файл log.txt c подробностями последнего запуска, а удаление пишет log-uninstall.txt.

Настройка фонового режима пишет log-service.txt, отключение — log-service-uninstall.txt.

Приложите нужный файл к обращению в техническую поддержку ZONT — по нему причина видна почти всегда.

Если Zigbee2MQTT работает в фоне, поддержка может попросить ещё и журнал самой программы. Он лежит в папке %LOCALAPPDATA%\Zigbee2MQTT\logs: скопируйте этот адрес в адресную строку проводника и нажмите Enter.

Частые случаи и что делать:

Что на экране	Что это значит
«Установка требует прав администратора»	Файл запущен обычным двойным щелчком. Закройте окно и запустите правой кнопкой мыши через «Запуск от имени администратора».
«Неверный логин или пароль»	Проверьте данные на сайте ZONT. После трёх неудачных попыток установка прервётся.
«В аккаунте нет ни одного прибора Home Assistant»	Сначала добавьте прибор в приложении ZONT, затем запустите установку заново.
«Сервер ZONT не отвечает»	Подключение блокирует антивирус, брандмауэр или провайдер. Проверьте, открывается ли сайт ZONT в браузере на этом компьютере.
«Zigbee2MQTT запустился в фоне и сразу остановился»	Чаще всего Zigbee-стик занят или выбран не тот COM-порт. Порядок действий — в разделе «Если адаптер занят» ниже.
«В системе уже есть служба Zigbee2MQTT»	Службу с таким именем создала другая программа. Скрипт её не трогает, чтобы ничего не сломать.
«Адаптер на порту COM…чем-то занят»	Установщик пробует освободить адаптер сам. Если не помогло — порядок действий в разделе «Если адаптер занят» ниже.

---

Если адаптер занят

Zigbee-стик может использовать только одна программа за раз. Если в окне написано, что адаптер занят, выполняйте по порядку и после каждого шага запускайте файл заново (правой кнопкой мыши — «Запуск от имени администратора»):

1. Извлеките адаптер из USB и вставьте его заново. Помогает чаще всего: Windows заново подключает устройство и отпускает его.

2. Подключите адаптер к другому USB-порту компьютера.

3. Закройте программы, которые могут работать с адаптером — другую копию Zigbee2MQTT, программы настройки Zigbee-стика, монитор COM-порта.

4. Перезагрузите компьютер.

---

Базовая информация по добавлению устройств Zigbee

При входе на http://localhost:3097 интерфейс по умолчанию на английском языке. Нажмите на кнопку en, чтобы открыть меню выбора доступных языков

Выберите из списка Русский.

Перейдите во вкладку Устройства и нажмите кнопку Разрешить подключение.

Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на Запретить присоединение.

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

Имя плитки по умолчанию максимально наполняется данными, чтобы была понятна принадлежность компонента к устройству. Переименование доступно в настройках устройства Home Assistant, разделы Управление, Оборудование, Отопление.

Ненужные плитки можно скрыть в настройках дома, раздел Главный экран.

Итоговый вид на главном экране дома.

---

Техническим специалистам

Раздел описывает обмен по протоколу MQTT в сервисе ZONT.

---

Брокер

1. Поддерживаются протоколы MQTT 3.1.1 и 5.0.

2. Подключены аутентификация и авторизация. Регистрация в брокере доступна через новое приложение ZONT.

3. Публикация сообщений MQTT 3.1.1 в топики, на которые клиент не авторизован, не приводит к разрыву соединения — такие сообщения игнорируются.

4. Передача от клиентов — не чаще 1 сообщения в секунду и не более 1 МБ.

5. Глубина топика — не более 15 элементов (не более 14 символов / ).

6. Хранение сессий отключено: сообщения, не доставленные получателю, в очередях брокера не остаются.

7. Retain-сообщения отключены — флаг игнорируется на уровне брокера. Само сообщение доставляется всем получателям, которые находятся на связи.

---

Полезная нагрузка

Формат соответствует интеграциям Home Assistant MQTT. На 19.08.2026 поддерживаются:

Интеграция	Что описывает
binary_sensor	дискретные датчики
button	кнопки
climate	контуры отопления и их режимы
light	освещение
lock	замки
number	регуляторы
select	селекторы и многопозиционные переключатели
sensor	измерительные датчики
switch	переключатели

---

MQTT Discovery

Сообщения MQTT Discovery сообщают серверу информацию об устройстве и правилах взаимодействия с ним. Топик должен начинаться с префикса ZONT/<user_id>/<device_id>/ и заканчиваться суффиксом /config :

ZONT/102645/469742/sensor/9FF5B6BCEC40/8207/config

• поля availability игнорируются: устройство считается вышедшим на связь после успешной аутентификации клиента в брокере;
• в value_template из соображений безопасности поддерживаются только простейшие значения — извлечение ключей JSON, например {{value_json.temperature }}. Любые преобразования и сценарии недоступны;
• message_expiry_interval игнорируется: все способы персистентного хранения сообщений в брокере отключены.