1. Установка Mosquitto (MQTT-брокера).
Обычно Mosquitto устанавливается как отдельный контейнер (например, с образом eclipse-mosquitto).
В конфигурации Home Assistant нужно указать IP-адрес NAS, где работает Mosquitto.

2. Установка Zigbee2MQTT.
а)
Как аддон для Home Assistant.
Если используется Home Assistant OS или Home Assistant Supervised,
то Zigbee2MQTT можно установить как аддон прямо из интерфейса HA.
Для этого нужно добавить репозиторий, найти аддон в списке и установить его.
После установки в боковом меню HA появится пункт Zigbee2MQTT — веб-интерфейс.
б)
Через Docker.
Можно использовать образ koenkk/zigbee2mqtt в Docker-контейнере.
В docker-compose.yml нужно указать тома, порты и устройства (например, /dev/ttyUSB0:/dev/ttyACM0).
Конфигурационный файл configuration.yaml содержит параметры, такие как mqtt, serial, frontend и другие.

3. Настройка конфигурации.
В файле configuration.yaml можно указать параметры, например:
homeassistant: true — чтобы Zigbee2MQTT взаимодействовал с Home Assistant;
permit_join: true — разрешает устройствам присоединяться к сети;
mqtt: base_topic: zigbee2mqtt, server: mqtt://<IP_NAS>:1883 — адрес сервера MQTT и порт;
serial: port: /dev/ttyUSB0 — путь к USB-координатору.

4. Подключение устройств.
После настройки в веб-интерфейсе Zigbee2MQTT (доступном по указанному порту) нужно нажать «Permit join (All)»,
затем перевести устройство в режим сопряжения.
Оно появится в списке через 10–60 секунд.

Особенности для Synology NAS
Драйверы для USB-координаторов.
По умолчанию в DSM могут быть отключены USB-периферия.
Для работы с Zigbee-координаторами может потребоваться установка соответствующих драйверов.

Проблемы с портами.
При запуске контейнера Zigbee2MQTT может возникнуть конфликт портов с другими сервисами на NAS.
Рекомендуется проверить настройки портов в конфигурации и при необходимости изменить их.

Перезагрузка.
Если Home Assistant и Zigbee2MQTT работают на одном устройстве, при перезагрузке сервера оба сервиса могут перестать работать.

рекомендации
Вынос Zigbee2MQTT на отдельное устройство.
Это может снизить риск сбоев и упростить диагностику проблем.

Настройка каналов Zigbee.
Рекомендуется использовать каналы, которые меньше пересекаются с типичными Wi-Fi-каналами (например, 11, 15, 20, 25).

доументация
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt#installation

это легковесный брокер сообщений с открытым исходным кодом,
который реализует протокол MQTT (Message Queuing Telemetry Transport).
Он служит центральным узлом для обмена данными между устройствами и клиентами в системах,
использующих модель «издатель — подписчик» (publish-subscribe)

Основные функции и задачи:

Получение сообщений от издателей (publishers).
Брокер принимает данные от устройств или приложений, которые отправляют информацию на определённые темы (topics).

Фильтрация сообщений.
Mosquitto определяет, какие подписчики подписаны на каждое сообщение, и пересылает их только им.

Управление доставкой сообщений.
Брокер обеспечивает доставку данных подписчикам, учитывая уровень качества обслуживания (QoS).

Сохранение сообщений.
Mosquitto может хранить сообщения, которые получает,
когда предполагаемые получатели в данный момент не подключены.
После восстановления подключения сохранённые сообщения доставляются адресатам.

Обеспечение безопасности.
Поддерживаются базовые механизмы защиты:
аутентификация по логину и паролю, списки контроля доступа (ACL), шифрование TLS/SSL.