ZigDash

Переход с ZHA на Zigbee2MQTT

ZHA — это собственный Zigbee в Home Assistant. ZigDash работает с Zigbee2MQTT, поэтому не может показать устройства, которые находятся в ZHA. Переход означает, что устройства нужно заново сопрячь с Zigbee2MQTT. Home Assistant и дальше будет ими пользоваться — через свою интеграцию MQTT.

Перед началом

Два способа перехода

Второй адаптерТот же адаптер
СтоимостьНовый адаптер, примерно 30–60 € (например, Home Assistant Connect ZBT-2 или SMLIGHT SLZB-06M либо SLZB-07)Бесплатно
Во время переходаВсё продолжает работать: у ZHA остаётся старый адаптерZigbee не работает, пока каждое устройство не будет сопряжено заново
ТемпКомната за комнатой, хоть несколько днейВсё сразу
Возврат назадЛегко: отключите новый адаптер, ZHA и не останавливаласьВосстановите резервную копию ZHA (см. Как вернуться назад)

Второй адаптер

  1. Настройте Zigbee2MQTT на новом адаптере (с приложениями или Docker) с собственной сетью. Выберите всё это до первого запуска Zigbee2MQTT, потому что смена канала потом может потребовать повторного сопряжения:
    • оставьте ключ сети и PAN ID на GENERATE (по умолчанию);
    • выберите канал, отличный от канала ZHA (его видно в ⚙ › Network information у ZHA); Home Assistant советует 15, 20 или 25.
  2. Держите адаптеры подальше друг от друга, каждый на своём USB-удлинителе.
  3. В Home Assistant OS при подключении нового адаптера Home Assistant может предложить настроить его для ZHA или Thread. Не обращайте внимания: адаптер нужен для Zigbee2MQTT.
  4. Переносите по одной комнате: сначала сопрягите устройства с питанием от сети (лампы, розетки, встраиваемые выключатели — это роутеры), потом устройства на батарейках.
  5. Когда все устройства перенесены, отключите ZHA (см. ниже), а старый адаптер оставьте про запас.

Тот же адаптер

  1. Скачайте резервную копию ZHA (см. Перед началом) прямо перед началом.
  2. Отключите ZHA: Настройки › Устройства и службы › Zigbee Home Automation, ⋮ рядом с Zigbee Home Automation › Disable. Не Delete.
  3. Настройте Zigbee2MQTT на том же адаптере (с приложениями или Docker), оставив ключ сети и PAN ID на GENERATE.
  4. Обесточьте устройства Zigbee с питанием от сети — выключателем на стене или автоматом в щитке. Иначе они продолжат искать старую сеть.
  5. Включайте их обратно по одному и сопрягайте каждое, как только оно включится. Потом сопрягите устройства на батарейках.

Ваш адаптер

Подробности — на страницах адаптеров Zigbee2MQTT.

Home Assistant с приложениями (Home Assistant OS)

  1. В разделе Настройки › Apps установите и запустите Mosquitto broker. Затем Home Assistant предложит интеграцию MQTT в разделе Настройки › Устройства и службы: примите её.
  2. Добавьте репозиторий Zigbee2MQTT (в магазине приложений: ⋮ › Repositories: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt), затем установите Zigbee2MQTT.
  3. На его вкладке Configuration укажите последовательный порт и адаптер из раздела Ваш адаптер, например:
    port: /dev/serial/by-id/usb-...
    adapter: ember
    Для способа со вторым адаптером укажите также канал (см. выше) до первого запуска.
  4. Запустите Zigbee2MQTT и откройте его веб-страницу со страницы приложения. Затем сопрягите устройства.

Home Assistant в Docker (без приложений)

Без приложений Mosquitto и Zigbee2MQTT работают в отдельных контейнерах рядом с Home Assistant. В новой папке:

1. compose.yaml (укажите путь к адаптеру в devices; его покажет ls /dev/serial/by-id/):

services:
  mosquitto:
    image: eclipse-mosquitto:2
    restart: unless-stopped
    ports:
      - 1883:1883
    volumes:
      - ./mosquitto/config:/mosquitto/config
      - ./mosquitto/data:/mosquitto/data
  zigbee2mqtt:
    image: ghcr.io/koenkk/zigbee2mqtt
    restart: unless-stopped
    depends_on:
      - mosquitto
    ports:
      - 8080:8080
    volumes:
      - ./zigbee2mqtt:/app/data
      - /run/udev:/run/udev:ro
    environment:
      - TZ=Europe/Berlin
    devices:
      - /dev/serial/by-id/usb-...:/dev/ttyACM0

С сетевым адаптером уберите devices и строку с udev.

2. mosquitto/config/mosquitto.conf:

listener 1883
allow_anonymous false
password_file /mosquitto/config/passwd
persistence true
persistence_location /mosquitto/data/

Создайте пользователя MQTT (пароль спросят дважды; файл должен принадлежать собственному пользователю Mosquitto, иначе Mosquitto не запустится):

docker run -it --rm -v "$PWD/mosquitto/config:/mosquitto/config" eclipse-mosquitto:2 \
  sh -c "mosquitto_passwd -c /mosquitto/config/passwd zigbee && chown mosquitto:mosquitto /mosquitto/config/passwd"

3. zigbee2mqtt/configuration.yaml (строки адаптера — из раздела Ваш адаптер):

homeassistant:
  enabled: true
frontend:
  enabled: true
  port: 8080
mqtt:
  server: mqtt://mosquitto:1883
  user: zigbee
  password: your-password
serial:
  port: /dev/ttyACM0          # a network adapter: tcp://IP:6638
  adapter: ember
advanced:
  network_key: GENERATE
  pan_id: GENERATE
  ext_pan_id: GENERATE
  channel: 20                 # second adapter: not ZHA's channel

4. Для способа с тем же адаптером ZHA к этому моменту уже отключена (см. выше). Если контейнер самого Home Assistant пробрасывает адаптер, уберите эту строку из его compose-файла или docker run: адаптер может использовать только один контейнер.

5. docker compose up -d, затем откройте http://the-machine:8080: это веб-страница Zigbee2MQTT.

6. В Home Assistant: Настройки › Устройства и службы › Добавить интеграцию › MQTT. Broker: IP-адрес машины, порт 1883, пользователь zigbee и пароль.

Сопряжение устройств

  1. На веб-странице Zigbee2MQTT нажмите Permit join (открыто примерно четыре минуты). Чтобы сопрягать через роутер рядом с устройством, выберите этот роутер в меню permit join: это полезно для Aqara и других капризных устройств.
  2. Переведите устройство в режим сопряжения так, как указывает производитель: долгое нажатие у большинства датчиков, несколько циклов включения и выключения у ламп, серия переключений у некоторых встраиваемых выключателей.
  3. Когда оно появится, дайте ему имя и комнату в Zigbee2MQTT. Затем переходите к следующему.

Сначала устройства с питанием от сети, потом на батарейках, чтобы у новой сети были маршруты.

После перехода

Как вернуться назад

Проверено: 17 ноября 2026 г. с Home Assistant 2026.11 и Sonoff ZBDongle-E сеть ZHA вернулась в точности (канал, PAN ID и ключ сети). С сопряжёнными устройствами мы это ещё не проверяли, поэтому сохраните файл резервной копии.

Сохранить сеть без повторного сопряжения

Есть и третий способ: скопировать сеть ZHA в Zigbee2MQTT, чтобы устройства не пришлось сопрягать заново. Zigbee2MQTT его не поддерживает, неверное значение может стереть сеть, и смысл в этом есть только для больших домов (скажем, больше 60 устройств). Если хотите почитать об этом: ответ сопровождающего Zigbee2MQTT, а также отчёты сообщества в обсуждении 24478 и обсуждении 26716.

Расскажите, как всё прошло. Это руководство новое. Если какой-то шаг был неверным или его не хватало, напишите на [email protected] или в сообщество.