Аддон Zigbee2MQTT при первом запуске открывает страницу onboarding - мастер первоначальной настройки адаптера и MQTT. Иногда мастер застревает: поля на странице серые и недоступные, а настройка не завершается. Обычно помогает убрать заранее заполненные секции serial и mqtt из configuration.yaml и закончить настройку в самом мастере - этот способ сработал в двух ветках форума из трех, где его пробовали.
Как выглядит проблема
Аддон застревает на мастере настройки. В ветках форума проблема выглядит по-разному:
- после настройки SLZB-06 аддон продолжает показывать страницу onboarding с серыми недоступными полями;
- в логе аддона только сообщение про onboarding, а заполненные поля конфигурации сбрасываются при сохранении, так что настройка не завершается;
- меню Zigbee2MQTT открывает только экран onboarding с пустыми полями;
- аддон показывает экран onboarding и не открывает список устройств, чтобы добавить новые.
Отдельной строки ошибки у этой проблемы нет, она проявляется поведением мастера.
Если Zigbee2MQTT не запускается после обновления прошивки SLZB-06 - это другая проблема. Когда мастер пройден, но устройства Zigbee2MQTT не появляются в Home Assistant, это тоже отдельная ситуация со своей страницей.
Причины
В собранных ветках названы две причины.
| Причина | Как проверить | Что сделать |
|---|---|---|
| Секции serial и mqtt уже заполнены в configuration.yaml и конфликтуют со страницей onboarding (2 ветки, прямо названа в одной) | Открыть configuration.yaml аддона и посмотреть, заполнены ли секции serial и mqtt | Оставить эти поля пустыми и пройти мастер заново |
| Выключен MQTT-брокер Mosquitto (1 ветка) | Проверить, запущен ли аддон Mosquitto broker | Включить брокер и повторить настройку |
Что помогает
Оставить serial и mqtt пустыми
Основной способ. Секции serial и mqtt в configuration.yaml оставляют пустыми, а настройку завершают на странице onboarding. Помогло в двух ветках из трех, где его пробовали, в третьей он не сработал.
Документация подтверждает сам мастер: Zigbee2MQTT предлагает onboarding при первом запуске, пока configuration.yaml не существует (getting started). В configuration.yaml за страницу onboarding отвечает строка:
onboarding: trueЕсли вы только устанавливаете аддон, пошаговая инструкция есть в гайде Установка и настройка Zigbee2MQTT в Home Assistant.
Выбрать адаптер и заполнить вкладки
В одной ветке помогло такое: на странице getting started выбрать адаптер и заполнить вкладки frontend и MQTT. Выбор адаптера подтверждается документацией - поиск пробует найти последовательные (serial) устройства и устройства, доступные по mDNS - автоматическому обнаружению в сети (installation). Вкладки frontend и MQTT в документации не описаны, эта часть - опыт пользователя.
Взять другие PAN ID и сетевой ключ
У одного пользователя помогло использовать PAN ID (идентификатор сети Zigbee) и сетевой ключ, отличные от тех, что показаны на экране onboarding. Это опыт форума, в документации способ не описан.
Включить брокер Mosquitto
В одной ветке настройка прошла после включения брокера Mosquitto. Документация требует, чтобы MQTT-брокер был установлен; что он должен быть именно запущен, в документации не сказано - это наблюдение с форума. Если брокер работает, но Zigbee2MQTT не может к нему подключиться, это отдельная ошибка: MQTT failed to connect.
Сбросить координатор ZBT-2
Сброс координатора ZBT-2 к заводским настройкам помог одному пользователю, способ из форума, в документации не описан. У ZBT-2 есть и другая известная проблема.
Если не помогло
Основной способ не помог в одной ветке из трех. Еще два совета с форума остались без подтверждений - отчетов об их результате нет:
- открыть Zigbee2MQTT на порту 8080 вместо 8123;
- остановить Zigbee2MQTT и удалить строку
onboarding: trueиз configuration.yaml.
Частые вопросы
Когда Zigbee2MQTT показывает страницу onboarding?
При первом запуске, пока файла configuration.yaml еще нет. Так сказано в документации Zigbee2MQTT: мастер предлагается на первом старте, когда конфигурация не создана. Если конфигурационный файл уже существует и секции в нем заполнены, мастер может конфликтовать с ними, и тогда поля становятся недоступными.
Обязателен ли MQTT-брокер для настройки?
Да, нужен. В документации сказано, что должен быть установлен MQTT-брокер. Что брокер должен быть именно запущен, в документации не сказано, но на форуме был случай, когда мастер не давал завершить настройку из-за выключенного Mosquitto. После включения брокера настройка прошла.
Какой порт использовать - 8123 или 8080?
Подтвержденного ответа нет. Есть один совет с форума: открыть Zigbee2MQTT на порту 8080 вместо 8123. Отчетов о результате нет, неизвестно, помогло ли это кому-нибудь. Сначала стоит проверить способы, у которых есть отчеты: пустые секции serial и mqtt и включенный брокер.
Можно ли убрать onboarding из конфигурации?
Можно, но подтверждений нет. На форуме предлагали остановить Zigbee2MQTT и удалить строку onboarding: true из configuration.yaml. Отчетов, что это помогло, нет. Проще оставить секции serial и mqtt пустыми и пройти мастер заново: этот способ подтвержден двумя ветками.
