Установка Home Assistant Supervised на Ubuntu/Debian

Home Assistant можно запускать двумя основными способами на обычной Linux-системе: в “Supervised” режиме (полный набор функций Supervisor, аддонов и бэкапов) или в “non-supervised” режиме (только Core/Container, ручное управление аддонами). Non-supervised быстрее и проще, но ограничен в возможностях. Если вы хотите опыт, максимально приближённый к официальной Home Assistant OS, используйте Supervised.

Кому подходит этот сценарий

• Системным администраторам, инженерам «умного дома» и продвинутым энтузиастам Linux.
• Если вам нужны аддоны, интегрированные бэкапы, Supervisor и простой веб-интерфейс управления.
• Не рекомендуется для абсолютных новичков в Linux или тех, кто не готов работать с Docker и сетевыми настройками.

Краткий план установки

1. Подготовить аппарат и установить Ubuntu Server (рекомендуется).
2. Установить Docker CE и зависимости.
3. Установить OS-Agent и пакет homeassistant-supervised.deb.
4. Проверить работу Supervisor и открыть порт 8123.

Требования и рекомендации перед началом

• Оборудование: x86_64 (ПК или ноутбук); любой аппарат, который может корректно запустить Ubuntu/Debian.
• ОС: рекомендуется Ubuntu Server 20.04.5 LTS (или совместимая Debian версия).
• Docker: Docker CE >= 20.10.17.
• Права: доступ root или sudo.
• Сеть: фиксированный IP-адрес или настройка локального DNS (mDNS) для удобства доступа.
• Резервные копии: если у вас есть предыдущая инсталляция Home Assistant, подготовьте её бэкап.

Важно: Supervised требует взаимодействия с systemd, NetworkManager, dbus и AppArmor — эти компоненты должны быть в системе и корректно работать.

Контрольный список перед установкой

• Установлен Ubuntu Server 20.04.5 LTS или совместимая Debian-версия.
• Есть доступ по SSH и права sudo.
• Аппарат в локальной сети с постоянным IP.
• План резервного копирования и восстановление бэкапа (если требуется).
• Понимание базовых команд Docker и управления systemd.

Шаг 1 — Обновите систему и установите Docker

Обновите пакеты и примените обновления:

sudo apt update && sudo apt upgrade -y

Установите зависимости (понадобятся позже для OS-Agent и Supervisor):

sudo apt install apparmor jq wget curl udisks2 libglib2.0-bin network-manager dbus lsb-release systemd-journal-remote -y

Установка Docker CE (официальный скрипт упрощает процесс):

curl -fsSL get.docker.com | sh

Примечание: проверьте версию Docker после установки:

docker --version

Если версия ниже 20.10.17 — обновите Docker до требуемой версии.

Шаг 2 — Установка Home Assistant Supervised

Запустите контейнер Home Assistant (потом Supervisor создаст свои сервисы). Команда создаёт контейнер с именем homeassistant, использует сетевой режим host и монтирует конфиг в /etc/homeassistant:

sudo docker run -d --name=homeassistant --restart=always --network=host -v /etc/homeassistant:/config homeassistant/home-assistant:stable

Затем скачайте и установите OS-Agent (пример для x86_64; замените версию на актуальную при необходимости):

wget https://github.com/home-assistant/os-agent/releases/download/1.4.1/os-agent_1.4.1_linux_x86_64.deb
sudo dpkg -i os-agent_*.deb

Проверьте работу OS-Agent командой gdbus (интерфейс io.hass.os должен быть видим):

gdbus introspect --system --dest io.hass.os --object-path /io/hass/os

Если команда gdbus не найдена, убедитесь, что установлен пакет libglib2.0-bin.

Наконец, скачайте и установите пакет homeassistant-supervised.deb (установщик Supervisor):

wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
sudo dpkg -i homeassistant-supervised.deb

После установки Supervisor создаст свои контейнеры. Откройте Portainer (если установлен) или используйте docker ps для проверки контейнеров.

Доступ к интерфейсу Home Assistant

Откройте браузер и перейдите по адресу:

http://:8123/

Пример:

192.168.0.111:8123

Или используйте mDNS-имя, если оно доступно:

http://homeassistant.local:8123/

При первом запуске вам будет предложено создать учётную запись и восстановить бэкап, если он у вас есть.

Частые ошибки и их устранение

Ниже — расширенный раздел с типичными проблемами, командами диагностики и пошаговыми исправлениями.

1. Нельзя установить или обновить аддоны / Home Assistant Core

Симптом: при установке аддона или обновления Core появляется ошибка.

Решение:

sudo docker stop portainer
sudo docker restart hassio_supervisor

Затем откройте веб-интерфейс и повторите установку.

Если контейнер Supervisor постоянно перезапускается, посмотрите логи:

sudo docker logs hassio_supervisor --tail 200

2. Home Assistant показывает множество ремонтов (Repairs)

При Supervised установке вы можете видеть предупреждения о “Unsupported system” по следующим пунктам:

• Unsupported system - Operating System
• Unsupported system - Unsupported software
• Unsupported system - Connectivity check disabled
• Unsupported system - Systemd Journal issues

Важно: многие из этих предупреждений не мешают работе Supervisor и аддонов. Если же появляется “Unhealthy system - Docker misconfigured”, выполните:

docker start 

и проверьте конфигурацию Docker:

sudo systemctl status docker
sudo docker info

3. gdbus не распознаётся

Установите вспомогательный пакет:

sudo apt install libglib2.0-bin -y

и повторите команду проверки OS-Agent.

4. Проблемы с NetworkManager или systemd

Supervisor ожидает, что systemd и NetworkManager присутствуют и управляют сетью. Если вы изменяли конфигурацию init-системы, верните systemd и NetworkManager в рабочее состояние или установите совместимую конфигурацию.

Проверьте статус:

systemctl status NetworkManager
systemctl status systemd-journald

5. Общие команды диагностики

• Список контейнеров:

sudo docker ps -a

• Просмотр логов конкретного контейнера:

sudo docker logs  --tail 200

• Статус служебных сервисов Supervisor:

sudo systemctl status hassio-supervisor

Безопасность и доступ извне

Безопасность — важный аспект при открытии доступа к Home Assistant из интернета. Некоторые рекомендации:

• Используйте Cloudflare Tunnel (ранее Argo) или другой безопасный туннель вместо проброса портов напрямую.
• Настройте HTTPS и автоматически обновляемые сертификаты, если пробрасываете порт.
• Используйте firewall (ufw) и ограничьте доступ по IP при возможности:

sudo ufw enable
sudo ufw allow from 192.168.0.0/24 to any port 8123 proto tcp

• Установите fail2ban для защиты SSH и веб-сервисов.
• Регулярно делайте бэкапы, храните их в внешнем или зашифрованном хранилище.

Конфиденциальность и соответствие (коротко)

Home Assistant хранит локально данные устройств, логи и конфигурации. Если вы открываете доступ извне, спланируйте политику хранения логов и доступов, минимизируйте передачу персональных данных в сторонние сервисы и используйте шифрование канала для удалённого доступа.

Методология управления и уровни зрелости

Минимальная методология развёртывания Supervised:

1. Подготовка ОС и резервного плана.
2. Установка Docker и зависимостей.
3. Установка OS-Agent и Supervisor.
4. Тестирование основных интеграций и бэкапов.
5. Внедрение политики безопасности и мониторинга.

Уровни зрелости (пример):

• Уровень 0 (эксперимент): установка non-supervised, ручной контроль аддонов.
• Уровень 1 (базовый): Supervised на одном сервере, ручные бэкапы.
• Уровень 2 (промежуточный): автоматические бэкапы, туннель для удалённого доступа.
• Уровень 3 (производство): мониторинг, централизованные бэкапы, документация и план отката.

Диагностическое дерево принятия решения

flowchart TD
  A[Нужны аддоны и бэкапы?] -->|Да| B[Есть опыт Linux и Docker?]
  A -->|Нет| C[Выберите non-supervised]
  B -->|Да| D[Выберите Supervised]
  B -->|Нет| E[Рекомендуется изучить Docker или использовать Home Assistant OS]

Чек-лист ролей (быстро)

Администратор:

• Подготовить сервер, настроить резервное питание, установить Ubuntu Server.
• Настроить мониторинг и бэкап.

Энтузиаст/инсталлятор:

• Установить Docker, OS-Agent и Supervisor.
• Настроить сетевые правила и Cloudflare Tunnel.

Пользователь:

• Настроить автоматические бэкапы и учётные записи с MFA.
• Проверять обновления и логи еженедельно.

Справочник команд (cheat sheet)

• Обновление системы: sudo apt update && sudo apt upgrade -y
• Установка зависимостей: sudo apt install apparmor jq wget curl udisks2 libglib2.0-bin network-manager dbus lsb-release systemd-journal-remote -y
• Установка Docker: curl -fsSL get.docker.com | sh
• Установка OS-Agent: wget && sudo dpkg -i os-agent_*.deb
• Установка Supervisor: wget && sudo dpkg -i homeassistant-supervised.deb

Матрица совместимости и советы по миграции

• Аппарат: x86_64 поддерживается; ARM — смотрите отдельные сборки OS-Agent и пакеты.
• ОС: Ubuntu Server и некоторые версии Debian поддерживаются; кастомные или «облегчённые» дистрибутивы могут не поддерживать Supervisor.
• Docker: используйте официальные релизы Docker CE.

Шаблон восстановления (коротко)

1. Остановить проблемные контейнеры: sudo docker stop
2. Выполнить резервную копию каталога /etc/homeassistant
3. Восстановить бэкап через веб-интерфейс Supervisor или вручную размонтировать и заменить конфигурацию
4. Перезапустить Supervisor: sudo docker restart hassio_supervisor

Факты и ключевые параметры

• Порт веб-интерфейса Home Assistant по умолчанию: 8123.
• Рекомендуемая ОС: Ubuntu Server 20.04.5 LTS.
• Минимальная рекомендуемая версия Docker: 20.10.17.
• Компоненты, от которых зависит Supervised: systemd, NetworkManager, dbus, AppArmor.

Когда Supervised — плохая идея (контрпримеры)

• У вас слабое, малопроизводительное устройство (тогда лучше Home Assistant OS на Raspberry Pi).
• Вы предпочитаете полностью контейнерный подход без Supervisor и уже управляете всеми интеграциями вручную.
• Система сильно модифицирована и не использует systemd/NetworkManager — возможны некорректные работы Supervisor.

Критерии приёмки

• Веб-интерфейс Home Assistant доступен по адресу http://:8123
• Supervisor и все базовые аддоны отображаются в разделе Supervisor/Settings
• Выполнено создание первого бэкапа и проверено восстановление (тестовое)
• Налажена политика безопасного удалённого доступа (туннель или HTTPS)

Итог и рекомендации

Home Assistant Supervised даёт полный пользовательский опыт Home Assistant, но требует от вас навыков работы с Linux, Docker и сетевыми сервисами. Если вы готовы тратить время на настройку и поддерживать систему — Supervised станет отличным выбором. Для простоты и минимального обслуживания рассматривайте Home Assistant OS или non-supervised установку.

Краткие рекомендации:

• Если приоритет — простота и минимум поддержки: используйте Home Assistant OS (Raspberry Pi) или non-supervised.
• Если приоритет — функциональность, аддоны и удобное управление бэкапами: выбирайте Supervised.

Спасибо за внимание — удачной установки и стабильной работы вашего умного дома!