ZigBee2MQTT manager (TUI)¶

Проект использует менеджер z2m (скрипт ./z2m), который управляет сервисами через Docker Compose и помогает с первичной настройкой.

GitHub репозиторий: rocket-home/z2m

Wizard (мастер первичной настройки)¶

При первом запуске ./z2m автоматически запустится мастер первичной настройки (wizard): он поможет подготовить окружение и заполнить базовые параметры.

Возможности¶

Подготовка окружения при первом запуске (зависимости/виртуальное окружение).
Управление сервисами ZigBee2MQTT/MQTT (start/stop/restart/status/logs).
Настройка облачного MQTT (rocket-home.ru) и включение мостового режима.
Включение/выключение Node-RED (опционально) и управление сервисом.
Диагностика (doctor) и просмотр подключённых USB устройств (devices).
Просмотр текущей конфигурации (config).

Получение данных доступа к облачному MQTT Rocket Home¶

Для подключения ZigBee2MQTT к облачному MQTT Rocket Home понадобятся параметры подключения (адрес брокера, порт, логин/пароль и, при необходимости, параметры TLS), которые отображаются в личном кабинете.

Откройте страницу профиля MQTT: rocket-home.ru/profile/mqtt
Выберите один из вариантов:
- Использовать существующий MQTT аккаунт:
  - Скопируйте логин существующего аккаунта.
  - Если пароль утерян — нажмите «Установить пароль» напротив нужного аккаунта и задайте новый пароль.
- Создать новый MQTT аккаунт:
  - Нажмите «Добавить» — будет создан новый логин и сгенерирован пароль.
  - Сохраните пароль сразу (он показывается один раз в диалоге) и скопируйте логин.
Запустите ./z2m и в мастере (wizard) или в разделе настройки облачного MQTT введите полученные параметры.

Режимы запуска¶

cd ~/z2m
./z2m        # TUI (интерфейс в терминале)
./z2m --cli  # интерактивный CLI

Быстрые команды¶

./z2m start
./z2m stop
./z2m restart
./z2m status
./z2m logs

Permit join (разрешить добавление устройств)¶

./z2m permit-join on
./z2m permit-join off
./z2m permit-join          # покажет текущее значение из yaml

Диагностика¶

./z2m doctor
./z2m devices
./z2m config