Zigbee2MQTT 2.13.0 не запускается после обновления: Node.js 20 больше не поддерживается

Что произошло 1 августа 2026 года

В Zigbee2MQTT 2.13.0 удалена поддержка Node.js 20. Причина указана прямо в примечании к релизу: эта ветка Node.js достигла окончания жизненного цикла и больше не получает обычную поддержку проекта.

В технических требованиях Zigbee2MQTT 2.13.0 указаны три допустимые ветки:

Какие установки находятся в зоне риска

Как узнать версию Node.js и способ установки

Проверка версии Node.js

В терминале системы, где непосредственно запускается Zigbee2MQTT, выполните:

node --version

Возможные результаты:

• v20.x.x — перед переходом на Zigbee2MQTT 2.13.0 требуется обновить Node.js.
• v22.2.0 или новее в ветке 22 — версия входит в допустимый диапазон.
• v24.x.x — подходящая LTS-ветка.
• v26.x.x — поддерживается релизом 2.13.0.
• Команда не найдена — возможно, используется Docker, дополнение Home Assistant или терминал открыт не в той системе.

Как понять, что используется Docker

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

Как понять, что используется Home Assistant Add-on

Zigbee2MQTT открывается в разделе дополнений Home Assistant и может использовать Ingress. В таком случае нельзя применять к Home Assistant OS инструкции для обычного Debian или Raspberry Pi OS.

Что выбрать: Node.js 22, 24 или 26

Для домашнего сервера важнее не максимальный номер версии, а поддерживаемая комбинация операционной системы, Node.js, Zigbee2MQTT и менеджера пакетов. Если сервер давно не обновлялся, иногда безопаснее сначала обновить или заменить сам дистрибутив, а не принудительно устанавливать новую среду поверх устаревшей системы.

Что сохранить, чтобы не потерять Zigbee-сеть

1. Каталог data. В нём находятся конфигурация, база устройств, сетевые параметры и другие рабочие данные Zigbee2MQTT.
2. Файл configuration.yaml. Сохраните отдельную копию и не публикуйте MQTT-пароли и сетевой ключ.
3. Базу координатора. Для поддерживаемых адаптеров полезно иметь актуальную резервную копию координатора.
4. Версии компонентов. Запишите версии Zigbee2MQTT, Node.js, менеджера пакетов, прошивки координатора и ОС.
5. Путь к адаптеру. Предпочтительнее использовать стабильный путь вида /dev/serial/by-id/....
6. Настройки MQTT. Проверьте адрес брокера, пользователя, пароль, TLS и доступность Mosquitto.
7. План отката. Сохраните предыдущий Docker-образ, снимок LXC или резервную копию системы.

Что делать в зависимости от способа установки

Home Assistant Add-on

Создайте полную резервную копию Home Assistant и проверьте сохранность данных дополнения. Обновляйте через интерфейс дополнений. Устанавливать Node.js в Home Assistant OS вручную не требуется.

Docker и Docker Compose

Убедитесь, что каталог /app/data вынесен в постоянный том или каталог хоста. Затем обновите официальный образ и пересоздайте контейнер. Node.js внутри контейнера поставляется вместе с образом.

Linux bare metal

Сначала остановите сервис, сохраните каталог данных и проверьте версию Node.js. Обновление Node.js выполняйте способом, подходящим для вашего дистрибутива. После этого обновите зависимости Zigbee2MQTT и запускайте сервис.

LXC в Proxmox

Создайте снимок контейнера. Если Zigbee2MQTT установлен напрямую внутри LXC, проверяйте Node.js именно внутри контейнера. Отдельно убедитесь, что проброс USB-координатора или доступ к сетевому координатору сохранились.

Synology

При Container Manager проверьте постоянный каталог данных, переменные окружения, сетевой режим и доступ к адаптеру. На DSM 7 проблема USB-драйвера не связана напрямую с версией Node.js.

Windows

Сохраните каталог data, остановите процесс, проверьте Node.js и менеджер пакетов. После обновления убедитесь, что COM-порт адаптера не изменился и не занят другой программой.

Почему Zigbee2MQTT может не запуститься даже на Node.js 24

После выхода 2.13.0 появился пример, когда установка не запускалась на Node.js 24. Причиной был не Node.js, а неподдерживаемая версия менеджера пакетов pnpm. Сам релиз Zigbee2MQTT 2.13.0 указывает pnpm 10.18.3.

Другие полезные изменения Zigbee2MQTT 2.13.0

Для большинства пользователей эти функции вторичны по сравнению с изменением Node.js. Обновление стоит планировать, когда нужна поддержка конкретного устройства, исправление ошибки или актуальная поддерживаемая среда.

Типичные ошибки при обновлении

• Обновлять Zigbee2MQTT без резервной копии каталога data.
• Устанавливать Node.js в Home Assistant OS по инструкции для Debian.
• Одновременно обновлять Zigbee2MQTT, Home Assistant, MQTT-брокер и прошивку координатора.
• Удалять базу данных, если сервис не запустился с первого раза.
• Менять сетевой ключ и PAN ID для устранения ошибки Node.js.
• Считать любую ошибку после обновления проблемой координатора.
• Запускать две копии Zigbee2MQTT с доступом к одному USB-адаптеру.
• Использовать случайную инструкцию без учёта платформы и архитектуры процессора.

Что полезно проверить в самой системе умного дома

Подробнее: Home Assistant в частном доме, как построить стабильную Zigbee-сеть, Zigbee 3.0 и Zigbee 4.0, настройка домашнего сервера и умного дома.

Нужно ли срочно устанавливать Zigbee2MQTT 2.13.0

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

Владельцам bare metal на Node.js 20 сначала нужно обновить среду. Пользователям Node.js 22.2 и новее релиз формально доступен, хотя для плановой модернизации разумно рассматривать LTS-ветку Node.js 24.

Docker и Home Assistant Add-on уменьшают зависимость от Node.js на хосте, но не отменяют резервные копии, проверку каталога данных и возможность отката.