Менеджер Rocket Home (TUI) и привязка к облаку¶

После установки инструмент лежит в каталоге /opt/rocket-home. Управление сервисами — через TUI-менеджер (команда rocket) или напрямую make-целями: каждый пункт меню TUI печатает и вызывает эквивалентную make-команду, поэтому всё воспроизводимо и без TUI.

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

Мастер первичной настройки¶

При установке визард запускается автоматически. Запустить его повторно можно так:

cd /opt/rocket-home
rocket          # TUI-менеджер (в нём — пункт «Первичная настройка»)
# или напрямую:
make setup

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

Состояние сервисов, контейнеров и моста (make status).
Управление стеком: запуск/пересоздание и остановка (make up / make down).
Просмотр логов (make logs).
Разрешение добавления устройств (make permit-join-on / make permit-join-off).
Обновление ZigBee2MQTT по матрице совместимости (make update).
Резервное копирование и восстановление (make backup / make restore).
Привязка к облаку и смена способа авторизации (make oauth-link / make relink).
Включение/выключение Node-RED (опционально).
Диагностика (make doctor) и сквозная проверка (make smoke).

Привязка к облаку Rocket Home (OAuth, по умолчанию)¶

По умолчанию мост в облако авторизуется по протоколу OAuth (device grant) — вводить логин и пароль вручную не нужно. Привязка выполняется в мастере первичной настройки, а повторно — так:

cd /opt/rocket-home
make oauth-link

Команда покажет ссылку и короткий код. Откройте ссылку на телефоне или компьютере, войдите в аккаунт rocket-home.ru, введите код и подтвердите доступ. После этого токены сохранятся в secrets/tokens.json, а обновлением ключей и поддержанием моста займётся фоновый агент внутри контейнера MQTT-брокера — вмешательство не требуется.

Повторно привязать машину или сменить локацию (с перезапуском моста):

cd /opt/rocket-home
make relink

Альтернатива — статические учётные данные MQTT¶

Вместо OAuth мост можно авторизовать по логину и паролю MQTT-аккаунта. Для этого в файле /opt/rocket-home/.env задайте CLOUD_AUTH_MODE=static и заполните CLOUD_MQTT_USERNAME и CLOUD_MQTT_PASSWORD, после чего примените конфигурацию (make gen-configs && make up).

Логин и пароль возьмите в личном кабинете:

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

Совет

Эти же данные доступа (адрес брокера, порт, логин/пароль) подойдут и для прямого подключения собственного устройства по MQTT — через драйвер generic, без ZigBee2MQTT. Пример: DIY-измеритель CO₂ на ESPHome.

Основные команды¶

cd /opt/rocket-home

make status                          # состояние контейнеров, моста и токенов
make logs                            # логи (все сервисы)
make logs SERVICE=zigbee2mqtt FOLLOW=1   # логи одного сервиса в реальном времени
make up                              # запустить/пересоздать стек
make down                            # остановить стек (данные сохраняются)
make smoke                           # сквозная проверка: брокер → мост → облако
make doctor                          # диагностика всего сетапа
make update                          # обновить ZigBee2MQTT по матрице совместимости
make backup                          # резервная копия конфигурации и данных
make restore ARCHIVE=<путь.tar.gz>   # восстановление из резервной копии

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

cd /opt/rocket-home
make permit-join-on TIME=254   # открыть сеть на TIME секунд (по умолчанию 254)
make permit-join-off           # закрыть сеть

Веб-интерфейсы и порты¶

ZigBee2MQTT: http://IP_ADDRESS:4000
Node-RED (если включён): http://IP_ADDRESS:1880
Локальный MQTT-брокер: порт 1883