Установка Home Assistant на TrueNAS упирается в первую очередь в выбор версии системы: на TrueNAS SCALE умный дом разворачивается как приложение из каталога, а на TrueNAS CORE потребуется плагин, джейл или виртуальная машина — и от этого решения зависит вся дальнейшая настройка. Если приложение после установки не открывается по адресу веб-интерфейса, чаще всего причина в неправильно проброшенном порте 8123 или в том, что контейнер ещё не завершил первичную инициализацию.
Связка TrueNAS и Home Assistant популярна среди владельцев домашних серверов: NAS работает круглосуточно, и логично разместить на нём систему автоматизации, не покупая отдельное устройство вроде Raspberry Pi. Однако у такого подхода есть нюансы — от передачи USB-стиков Zigbee и Z-Wave внутрь контейнера до организации сетевого доступа. Ниже разберём варианты установки, типичные ошибки и способы их диагностики.
Выбор платформы: TrueNAS SCALE или CORE
Первое, что нужно проверить, — какая версия TrueNAS у вас установлена. Откройте веб-интерфейс и посмотрите на информацию о системе: SCALE построен на базе Linux и поддерживает контейнерные приложения, а CORE основан на FreeBSD и использует джейлы и плагины. Это принципиально разные механизмы, и инструкции для одной версии не подходят для другой.
На TrueNAS SCALE установка Home Assistant максимально проста: приложение доступно в каталоге (в зависимости от версии системы — через механизм Apps на базе Kubernetes или через Docker-окружение в более свежих релизах). На TrueNAS CORE официального плагина Home Assistant в современных версиях может не быть, и придётся вручную создавать джейл либо поднимать полноценную виртуальную машину с Home Assistant OS.
- 🖥️ TrueNAS SCALE — приложение из каталога, минимум ручной настройки;
- 📦 TrueNAS CORE + джейл — гибко, но требует опыта работы с FreeBSD;
- 💿 Виртуальная машина с Home Assistant OS — полная изоляция и поддержка аддонов;
- 🐳 Ручной запуск Docker-контейнера — для тех, кто хочет полный контроль над конфигурацией.
Установка Home Assistant на TrueNAS SCALE
В веб-интерфейсе SCALE откройте раздел Apps и перейдите в каталог доступных приложений. Найдите Home Assistant через поиск — в зависимости от версии системы он может находиться в официальном или community-каталоге. Нажмите Install и дождитесь загрузки образа: при медленном соединении это может занять заметное время.
В форме установки обратите внимание на сетевые параметры. По умолчанию веб-интерфейс Home Assistant работает на порту 8123. Если этот порт уже занят другим приложением, укажите свободный внешний порт — тогда интерфейс будет доступен по адресу http://IP-NAS:ваш_порт. Также задайте пул хранения для данных приложения: конфигурация умного дома должна лежать на надёжном датасете.
⚠️ Внимание: состав полей в форме установки и названия разделов каталога отличаются между версиями TrueNAS SCALE. Если описанный путь не совпадает с вашим интерфейсом, сверьтесь с официальной документацией вашей версии системы — структура Apps менялась между релизами.
☑️ Проверка после установки Home Assistant
Установка через виртуальную машину
Если вам нужна полноценная Home Assistant OS с магазином аддонов, вариант с виртуальной машиной — самый близкий к «эталонному». На SCALE и CORE есть встроенный гипервизор: создайте ВМ, выделите ей как минимум 2 ГБ оперативной памяти и виртуальный диск достаточного объёма, затем загрузитесь с образа Home Assistant OS, скачанного с официального сайта проекта.
Плюс такого подхода — полная совместимость со всеми функциями платформы, включая supervisor и резервное копирование через штатные механизмы. Минус — больший расход ресурсов NAS и необходимость отдельно настраивать проброс USB-устройств в ВМ, что в гипервизоре TrueNAS делается через параметры виртуальной машины и не всегда работает предсказуемо со специфическими адаптерами.
Сеть и доступ к веб-интерфейсу
Частая жалоба после установки — «Home Assistant не открывается в браузере». Начните диагностику с простого: проверьте, что приложение действительно запущено (статус в разделе Apps), и что вы обращаетесь к правильному IP-адресу и порту. Команда проверки доступности порта с другого компьютера выглядит так:
ping IP_адрес_NAS
curl -I http://IP_адрес_NAS:8123
Если пинг проходит, а порт не отвечает — загляните в логи контейнера через интерфейс приложения. Возможная причина — приложение ещё инициализируется или упало при старте из-за нехватки ресурсов. Также проверьте, не блокирует ли соединение файрвол на стороне клиента или сетевые ограничения самого TrueNAS.
Для корректной работы обнаружения устройств (mDNS, SSDP) контейнерному приложению иногда требуется режим host network, если такая опция предусмотрена в вашей версии каталога. Без него часть интеграций — например, автоматическое обнаружение колонок или телевизоров — может не сработать, хотя ручное добавление по IP обычно остаётся доступным.
Проброс USB-стиков Zigbee и Z-Wave
Самый болезненный момент связки TrueNAS + Home Assistant — передача USB-координаторов вроде Zigbee-стиков внутрь контейнера или ВМ. В контейнерном варианте устройство должно быть видно в системе (проверьте вывод lsusb через shell) и проброшено в приложение через настройки устройств, если такая функция поддерживается вашей версией каталога.
Альтернатива, которая избавляет от проброса USB вообще, — сетевые Zigbee-координаторы, подключаемые к Home Assistant по LAN. Координатор размещается в любом месте квартиры с розеткой и сетью, а NAS остаётся в серверной без «хвостов» из адаптеров. Это также решает проблему помех: USB-порты рядом с дисками и блоком питания — не лучшее место для радиотракта.
⚠️ Внимание: перед покупкой USB-стика убедитесь, что он определяется в Linux и поддерживается нужной интеграцией (Zigbee2MQTT, ZHA, Z-Wave JS). Совместимость конкретных моделей проверяйте в документации соответствующей интеграции — список поддерживаемого оборудования регулярно меняется.
Хранение данных и резервное копирование
Одно из главных преимуществ размещения Home Assistant на NAS — надёжное хранилище. Разместите конфигурацию приложения на пуле с избыточностью (зеркало или RAIDZ), и база данных истории, автоматизации и настройки переживут отказ одного диска. Дополнительно настройте периодические снапшоты датасета с конфигурацией — это позволит откатиться на рабочее состояние после неудачного обновления.
Имейте в виду: база данных истории Home Assistant активно пишется, и на долгом горизонте это создаёт нагрузку на диски. Если пул собран на HDD, заметного эффекта вы не почувствуете, но размещать конфигурацию на SSD-пуле — разумная практика для отзывчивости интерфейса. Параметры хранения истории (срок хранения, исключения) настраиваются в самом Home Assistant через configuration.yaml в секции recorder.
| Метод установки | Сложность | Аддоны HA OS | Проброс USB |
|---|---|---|---|
| Приложение SCALE | Низкая | Нет | Зависит от версии |
| ВМ с Home Assistant OS | Средняя | Да | Через настройки ВМ |
| Docker вручную | Средняя | Нет | Через параметры контейнера |
| Джейл на CORE | Высокая | Нет | Сложно |
Типичные проблемы и их диагностика
Разберём симптомы, с которыми чаще всего сталкиваются при эксплуатации связки. Если приложение внезапно остановилось после обновления TrueNAS, проверьте логи — обновления системы иногда меняют поведение контейнерного окружения, и приложение требует переустановки или обновления до совместимой версии. Данные при этом сохраняются в датасете, если вы не удаляли его вместе с приложением.
Медленный интерфейс и долгая загрузка истории — возможный признак разросшейся базы данных recorder. Проверьте её размер в каталоге конфигурации и ограничьте срок хранения. Если же Home Assistant «не видит» устройства в сети, вернитесь к вопросу сетевого режима контейнера и проверьте, не работают ли NAS и устройства в разных подсетях или VLAN.
Что делать, если приложение не стартует после обновления
Откройте логи приложения в разделе Apps и найдите последнюю ошибку. Типичные варианты: конфликт портов (измените внешний порт), повреждённый образ (переустановите приложение, не удаляя датасет с данными), нехватка памяти (проверьте свободную RAM в дашборде TrueNAS). Если ничего не помогает — восстановите конфигурацию из снапшота ZFS на момент рабочего состояния.
Часто задаваемые вопросы
Можно ли установить Home Assistant на TrueNAS CORE?
Да, но вариантов меньше, чем на SCALE. Реалистичные пути — виртуальная машина с Home Assistant OS или ручная установка в джейл. Готового поддерживаемого плагина в актуальных версиях может не быть, поэтому вариант с ВМ предпочтительнее для большинства пользователей.
Будут ли работать аддоны Home Assistant в приложении SCALE?
Нет, магазин аддонов — функция Home Assistant OS и Supervised-установок. Контейнерная версия поддерживает интеграции и HACS, а функции аддонов (например, MQTT-брокер) придётся разворачивать отдельными приложениями на том же TrueNAS.
Как пробросить Zigbee-стик в Home Assistant на NAS?
Сначала убедитесь, что стик виден в системе через lsusb в shell. Дальнейший порядок зависит от метода установки: в ВМ устройство пробрасывается через настройки виртуальной машины, в контейнере — через параметры устройств приложения, если это поддерживается вашей версией. Универсальная альтернатива — сетевой Zigbee-координатор, подключаемый по LAN.
Не открывается веб-интерфейс после установки — что проверить?
Проверьте статус приложения, правильность IP-адреса и порта (по умолчанию 8123), логи контейнера и отсутствие блокировки со стороны файрвола. Дайте системе несколько минут на первичную инициализацию — первый запуск занимает заметно больше времени.
Опасно ли хранить базу данных Home Assistant на HDD-пуле?
Не опасно, но интенсивная запись истории создаёт постоянную фоновую нагрузку. Для отзывчивости интерфейса и снижения износа разумно разместить конфигурацию на SSD-пуле, а срок хранения истории ограничить в настройках recorder.