Установка Home Assistant на Debian 12/13, Ubuntu Server: Supervised и OS | AdminWiki
Logo

Установка Home Assistant на Debian: полное руководство для умного дома

17 декабря 2025 6 мин. чтения #debian #devops #home assistant #nginx #ubuntu #умный дом
Содержание статьи

Что такое Home Assistant и какой вариант выбрать?

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

Тип установки Сложность Контроль Для кого
Home Assistant OS Низкая Минимальный Новички, отдельный сервер
Home Assistant Supervised Высокая Полный Опытные пользователи, существующий сервер
Home Assistant Container Средняя Частичный Docker-энтузиасты
Важно: Установка Home Assistant Supervised на Debian требует полного контроля над системой. Это не просто Docker-контейнер, а полноценная система управления с собственным supervisor.

Подготовка системы: Debian 12/13 или Ubuntu Server

Перед установкой Home Assistant на Debian убедись, что твоя система соответствует требованиям. Я рекомендую свежие версии: Debian 12 "Bookworm" или Debian 13 "Trixie" (если уже доступна). Для Ubuntu Server подойдет 22.04 LTS или новее.

1. Обновление системы и установка зависимостей

bash
# Обновляем пакеты системы
sudo apt update && sudo apt upgrade -y

# Устанавливаем необходимые пакеты для Home Assistant Supervised
sudo apt install -y \
    software-properties-common \
    apparmor \
    jq \
    wget \
    curl \
    udisks2 \
    libglib2.0-bin \
    network-manager \
    dbus \
    lsb-release \
    systemd-journal-remote \
    systemd-resolved

2. Установка Docker и Docker Compose

Home Assistant Supervised требует Docker. Установим его официальным способом:

bash
# Устанавливаем Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Добавляем текущего пользователя в группу docker
sudo usermod -aG docker $USER

# Устанавливаем Docker Compose
sudo apt install -y docker-compose-plugin

# Проверяем установку
docker --version
docker compose version
Внимание: После добавления пользователя в группу docker нужно выйти из системы и зайти снова, либо выполнить newgrp docker для применения изменений в текущей сессии.

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

Теперь перейдем к основной части — установке Home Assistant Supervised на Debian 12 или 13. Этот метод дает максимальную интеграцию с системой.

3. Установка OS-Agent

OS-Agent — обязательный компонент для Supervised установки:

bash
# Определяем архитектуру процессора
ARCH=$(uname -m)

# Скачиваем подходящую версию OS-Agent
if [ "$ARCH" = "x86_64" ]; then
    wget https://github.com/home-assistant/os-agent/releases/latest/download/os-agent_linux_amd64.deb
elif [ "$ARCH" = "aarch64" ]; then
    wget https://github.com/home-assistant/os-agent/releases/latest/download/os-agent_linux_aarch64.deb
else
    echo "Неподдерживаемая архитектура: $ARCH"
    exit 1
fi

# Устанавливаем OS-Agent
sudo dpkg -i os-agent_*.deb

# Проверяем установку
sudo systemctl status os-agent

4. Установка Home Assistant Supervised

bash
# Скачиваем установщик Home Assistant Supervised
wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb

# Устанавливаем
sudo dpkg -i homeassistant-supervised.deb

# Если возникают ошибки зависимостей
sudo apt --fix-broken install -y
Во время установки Home Assistant Supervised на Ubuntu или Debian тебе зададут несколько вопросов о сетевых интерфейсах. Выбери основной интерфейс (обычно eth0 или enp0s3).

5. Проверка установки

bash
# Проверяем статус Home Assistant
sudo systemctl status haos-agent

# Смотрим логи установки
sudo journalctl -u haos-agent -f

Установка Home Assistant Supervised на Debian 12 займет 10-15 минут. После завершения открой браузер и перейди по адресу http://IP_ТВОЕГО_СЕРВЕРА:8123. Ты увидишь приветственный экран настройки.

Альтернатива: установка Home Assistant через Docker

Если тебе не нужна полная Supervised установка, можно использовать простой Docker-контейнер. Этот метод отлично подходит для тестирования или минимальной установки.

bash
# Создаем директорию для конфигураций
mkdir -p ~/homeassistant/config

# Запускаем Home Assistant контейнер
docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -v /etc/localtime:/etc/localtime:ro \
  -v ~/homeassistant/config:/config \
  -v /run/dbus:/run/dbus:ro \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

Настройка Nginx для Home Assistant

Для безопасного доступа из интернета рекомендую настроить Nginx в качестве обратного прокси. Это также позволит использовать SSL-сертификаты.

1. Установка Nginx и настройка прокси

bash
# Устанавливаем Nginx
sudo apt install -y nginx

# Создаем конфигурационный файл для Home Assistant
sudo nano /etc/nginx/sites-available/homeassistant

2. Конфигурация Nginx для Home Assistant

nginx
server {
    listen 80;
    server_name homeassistant.ваш-домен.ru;

    # Логи
    access_log /var/log/nginx/homeassistant.access.log;
    error_log /var/log/nginx/homeassistant.error.log;

    location / {
        proxy_pass http://localhost:8123;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # Для WebSocket
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # Статические файлы
    location /static {
        proxy_pass http://localhost:8123;
        expires 30d;
    }
}

3. Активация конфигурации и настройка SSL

bash
# Активируем сайт
sudo ln -s /etc/nginx/sites-available/homeassistant /etc/nginx/sites-enabled/

# Проверяем конфигурацию Nginx
sudo nginx -t

# Перезапускаем Nginx
sudo systemctl restart nginx

# Устанавливаем Certbot для SSL (опционально)
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d homeassistant.ваш-домен.ru

Решение распространенных проблем

Проблема 1: Ошибки при установке Home Assistant Supervised

Решение: Проверь, что все зависимости установлены и Docker работает корректно:

bash
# Проверяем статус Docker
sudo systemctl status docker

# Смотрим подробные логи установки
sudo journalctl -u haos-agent -n 100 --no-pager

Проблема 2: Нет доступа к веб-интерфейсу

Решение: Проверь firewall и порты:

bash
# Проверяем, слушает ли Home Assistant порт 8123
sudo netstat -tlnp | grep 8123

# Если используешь UFW (Ubuntu)
sudo ufw allow 8123/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Проблема 3: Медленная работа Home Assistant

Решение: Оптимизируй настройки базы данных и кэширование. В configuration.yaml добавь:

yaml
recorder:
  purge_keep_days: 7
  db_url: !secret db_url

# Используй SQLite для небольших инсталляций
# или перейди на PostgreSQL/MariaDB для больших

Дальнейшие шаги после установки

После успешной установки Home Assistant на Debian:

  • Настрой автоматическое резервное копирование через Add-on Store
  • Установи необходимые интеграции для твоих устройств умного дома
  • Настрой удаленный доступ через Nabu Casa или собственный VPN
  • Создай автоматизации для освещения, климата и безопасности
  • Регулярно обновляй Home Assistant через панель управления
Не забывай делать регулярные бэкапы! Home Assistant имеет встроенную систему резервного копирования. Используй её перед каждым крупным обновлением.

Теперь у тебя есть полноценный центр управления умным домом на Debian или Ubuntu Server. Помни: установка Home Assistant Supervised на Debian 13 или 12 — это только начало. Настоящая магия начинается, когда ты настраиваешь автоматизации и интеграции под свои нужды.

Поделиться:
Сохранить гайд? В закладки браузера