OpenHome.pro DOCS

Тема

Home Assistant ​

Как мы упомянули в разделе "С чего начать", Home Assistant — это open-source платформа для автоматизации дома, которая ставит во главу угла локальное управление, приватность и совместимость с огромным количеством устройств. Выбрав HASS, вы получаете систему, которая работает внутри вашей домашней сети, не завися от облачных сервисов производителей (хотя интеграция с ними возможна).

1. Выбор "Сервера" для Home Assistant ​

Home Assistant — это программное обеспечение, которому нужно где-то работать. Вот основные варианты "железа":

  1. Raspberry Pi (Рекомендуется для старта):

    • Модели: Raspberry Pi 4 Model B (с 2GB, 4GB или 8GB RAM) или Raspberry Pi 5. Модели 3B+ тоже могут работать, но для комфортной работы и будущего роста лучше 4 или 5.
    • Плюсы: Низкое энергопотребление, компактность, относительно невысокая цена, огромное сообщество и множество гайдов.
    • Минусы: Производительность может быть ограничена для очень больших систем с сотнями устройств и сложными автоматизациями. Требуется качественная SD-карта (лучше Class A2) или внешний SSD для надежности (SD-карты со временем выходят из строя из-за частой перезаписи логов).
    • Хранение: MicroSD карта (минимум 32GB, рекомендуется 64GB+) или внешний SSD через USB-адаптер (более надежный вариант).

  2. Мини-ПК (Intel NUC, Beelink, аналоги):

    • Плюсы: Значительно большая производительность, чем у Raspberry Pi, надежные SSD/NVMe накопители, часто больше портов. Отличный вариант для больших систем или если вы хотите запускать на том же устройстве другие сервисы (например, медиасервер).
    • Минусы: Выше цена и энергопотребление по сравнению с Raspberry Pi.

  3. Старый Ноутбук или ПК:

    • Плюсы: Возможно, у вас уже есть ненужное устройство. Достаточная производительность.
    • Минусы: Большие габариты, высокое энергопотребление (особенно у стационарных ПК), шум.

  4. NAS (Сетевое хранилище - Synology, QNAP и др.):

    • Плюсы: Если у вас уже есть NAS, можно запустить HASS в Docker-контейнере или на виртуальной машине (если модель поддерживает).
    • Минусы: Производительность может быть ограничена, настройка сложнее, не все модели NAS подходят. Проброс USB-устройств (Zigbee/Z-Wave стиков) может потребовать дополнительных настроек.

  5. Виртуальная машина (на вашем основном ПК/сервере):

    • Плюсы: Отличный способ "пощупать" HASS без покупки отдельного железа. Легко делать снимки системы (снапшоты).
    • Минусы: Ваш основной компьютер должен быть постоянно включен. Требует определенных знаний для настройки виртуализации (VirtualBox, VMware, Proxmox и т.д.).

Рекомендация: Для большинства пользователей, начинающих с нуля, Raspberry Pi 4 (4GB+) с SSD или недорогой Мини-ПК будут оптимальным выбором по соотношению цена/производительность/простота.

2. Установка Home Assistant ​

Существует несколько официальных способов установки:

  1. Home Assistant Operating System (HAOS) - Рекомендуется:

    • Что это: Минималистичная операционная система, оптимизированная для запуска Home Assistant и его дополнений (Add-ons). Включает Supervisor, который управляет HASS, ОС и дополнениями.
    • Плюсы: Самый простой способ установки и управления. Легкое обновление "по воздуху". Встроенный магазин дополнений (Add-ons) для установки Zigbee2MQTT, Mosquitto, Node-RED и т.д. в один клик. Управление резервными копиями.
    • Минусы: Меньше гибкости в настройке самой операционной системы (она "закрыта").
    • Как ставить: Скачать образ для вашего устройства (Raspberry Pi, NUC, VM) с официального сайта и записать его на SD-карту/SSD с помощью Raspberry Pi Imager или BalenaEtcher.

  2. Home Assistant Container (Docker):

    • Что это: Запуск HASS как Docker-контейнера на любой ОС, поддерживающей Docker (Linux, macOS, Windows, NAS).
    • Плюсы: Гибкость. Вы полностью контролируете основную ОС. Можно запускать рядом другие Docker-контейнеры.
    • Минусы: Требует знаний Docker. Нет встроенного магазина дополнений (Add-ons) и Supervisor'а (нужно ставить и настраивать все зависимости, вроде MQTT или Zigbee2MQTT, отдельными контейнерами и связывать их вручную). Обновления требуют ручного управления контейнерами.

  3. Home Assistant Core (Python Venv):

    • Что это: Установка HASS напрямую в виртуальное окружение Python на вашей ОС.
    • Плюсы: Максимальный контроль.
    • Минусы: Самый сложный способ установки и поддержки. Все зависимости нужно устанавливать и обновлять вручную. Подходит только для опытных пользователей Linux/Python.

Рекомендация: Если вы не гуру Linux и Docker, выбирайте Home Assistant Operating System (HAOS). Это самый простой и функциональный способ для большинства пользователей.

После установки: Подключите ваш "сервер" к сети (лучше проводом Ethernet) и найдите его IP-адрес. Откройте в браузере http://<IP-адрес>:8123 или http://homeassistant.local:8123. Пройдите первоначальную настройку (создание пользователя, указание местоположения и т.д.).

3. Подключение Устройств (Интеграции) ​

Home Assistant взаимодействует с устройствами через Интеграции.

  • Автообнаружение: Многие устройства (особенно Wi-Fi, работающие по стандартным протоколам вроде mDNS/Zeroconf, UPnP) HASS найдет сам при первом запуске или при появлении в сети. Вы увидите уведомление о найденных устройствах.
  • Ручная настройка: Для других устройств или протоколов нужно добавить интеграцию вручную через Настройки > Устройства и службы > Добавить интеграцию. Найдите нужный бренд или протокол (например, Xiaomi Miio, Tuya, ZHA, Zigbee2MQTT, Z-Wave JS).
  • Zigbee и Z-Wave:
    • Вам понадобится USB-стик (координатор) Zigbee или Z-Wave, подключенный к вашему серверу HASS.
    • Zigbee: Популярные интеграции – ZHA (встроенная, проще для начала) или Zigbee2MQTT (более гибкая, ставится как Add-on в HAOS). После настройки интеграции вы переводите Zigbee-устройства в режим сопряжения (pairing mode), и HASS/Zigbee2MQTT их находит.
    • Z-Wave: Основная интеграция – Z-Wave JS. Также ставится как Add-on (Z-Wave JS UI) или сервер управления + интеграция в HASS. Процесс сопряжения аналогичен Zigbee.
  • Wi-Fi устройства: Часто требуют настройки через облако производителя (Tuya, Xiaomi), либо локального управления, если поддерживается (Shelly, ESPHome).
  • ESPHome: Мощнейший инструмент для создания собственных DIY-устройств на базе ESP32/ESP8266 или перепрошивки некоторых коммерческих Wi-Fi устройств (например, Sonoff) для полностью локального управления через HASS.

Каждое подключенное физическое устройство представляется в HASS как одно или несколько Сущностей (Entities). Например, умная лампочка может иметь сущности:

  • light.living_room_lamp (вкл/выкл, яркость, цвет)
  • sensor.living_room_lamp_power (потребляемая мощность, если поддерживается)

4. Настройка Сценариев (Автоматизации, Скрипты, Сцены) ​

Это самая интересная часть – заставить устройства работать вместе.

  • Автоматизации (Automations): Основной инструмент для создания правил "Если произошло событие, при выполнении условия, то сделать действие".

    • Структура:
      • Триггер (Trigger): Что запускает автоматизацию (датчик движения сработал, время настало, выключатель нажат, состояние устройства изменилось).
      • Условие (Condition): Необязательный шаг. Проверка, нужно ли выполнять действия (например, включать свет по движению, только если сейчас темное время суток И никого нет дома).
      • Действие (Action): Что нужно сделать (включить свет, отправить уведомление, запустить скрипт, изменить температуру термостата).
    • Создание: Используйте встроенный Редактор автоматизаций (Настройки > Автоматизации и сцены > Автоматизации > Создать автоматизацию). Он позволяет создавать большинство сценариев через графический интерфейс. Для более сложных вещей можно переключиться в режим YAML.

  • Скрипты (Scripts): Последовательность действий, которую можно запустить вручную (например, кнопкой в интерфейсе) или вызвать из автоматизации. Удобно для группировки часто используемых действий (например, скрипт "Я ушел": выключить весь свет, включить охрану). Создаются в Настройки > Автоматизации и сцены > Скрипты.

  • Сцены (Scenes): Запоминают определенное состояние одной или нескольких сущностей (например, яркость и цвет ламп в гостиной для "Просмотра кино"). При активации сцены устройства переходят в сохраненное состояние. Полезны для быстрого создания нужной атмосферы. Создаются в Настройки > Автоматизации и сцены > Сцены.

5. Синтаксис YAML и другие тонкости ​

Хотя многое можно сделать через UI, понимание YAML (YAML Ain't Markup Language) полезно для тонкой настройки и понимания "под капотом".

  • Роль YAML: Основной формат для конфигурационных файлов Home Assistant (configuration.yaml, automations.yaml, scripts.yaml, scenes.yaml и др.). Даже UI-редакторы часто генерируют YAML в фоновом режиме.
  • Ключевые правила:
    • Отступы: Критически важны! Используются пробелы (обычно 2 пробела на уровень вложенности) для обозначения структуры. Нельзя использовать табы. Ошибки с отступами – самая частая проблема.
    • Ключ-значение: ключ: значение (пробел после двоеточия обязателен).
    • Списки (Массивы): Начинаются с дефиса и пробела - элемент_списка.
    • Комментарии: Начинаются с символа #.
  • configuration.yaml: Главный конфигурационный файл. Здесь можно вручную описывать некоторые интеграции, сенсоры, настройки системы. Редактировать его нужно осторожно. После изменений требуется проверка конфигурации (Настройки > Система > Проверка конфигурации) и перезапуск HASS (или только YAML-конфигурации, если возможно).
  • Шаблоны (Templates): Мощный инструмент для динамического получения и форматирования данных внутри HASS (например, создать сенсор, показывающий "Свет включен в 3 комнатах"). Используют язык шаблонизации Jinja2. Доступны в редакторе автоматизаций/скриптов и для создания шаблонных сенсоров/сущностей.
  • Дополнения (Add-ons) (для HAOS): Программы, расширяющие функциональность HASS (MQTT-брокер Mosquitto, Zigbee2MQTT, Z-Wave JS UI, Node-RED, AdGuard Home, VSCode для редактирования конфигов и т.д.). Устанавливаются и управляются через Настройки > Дополнения.
  • HACS (Home Assistant Community Store): Неофициальный "магазин" для установки пользовательских интеграций и карточек интерфейса, которых нет в стандартной поставке. Устанавливается отдельно. Используйте с осторожностью, так как это разработки сообщества, и их поддержка не гарантирована.
  • Резервные копии (Backups): Делайте их регулярно! Особенно перед обновлениями. В HAOS это делается через Настройки > Система > Резервные копии. Храните копии на другом устройстве.

Заключение ​

Home Assistant – это невероятно мощная и гибкая платформа, дающая полный контроль над вашим умным домом. Да, она требует времени на изучение и настройку, особенно поначалу. Но взамен вы получаете систему, работающую локально, не зависящую от прихотей производителей и облачных сервисов, с практически безграничными возможностями автоматизации.

Начните с простого, постепенно добавляйте устройства и усложняйте сценарии. Не бойтесь экспериментировать (сделав предварительно бэкап!). Огромное сообщество и подробная официальная документация всегда помогут найти ответы.

Что дальше?

Делаем для людей, присоединяйтесь !

OpenHome