Установка Home Assistant на VPS: Полное руководство с Docker и SSL

Что мы настраиваем и зачем

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

В этом руководстве мы развернем Home Assistant на виртуальном приватном сервере (VPS). Это решение дает несколько ключевых преимуществ:

• Полный контроль и приватность: Ваши данные остаются на вашем сервере. Вы не зависите от облачных сервисов и их политики конфиденциальности.
• Гибкость и масштабируемость: VPS предоставляет значительно больше ресурсов, чем одноплатные компьютеры вроде Raspberry Pi, что позволяет обрабатывать больше интеграций, автоматизаций и хранить больший объем данных без снижения производительности.
• Надежность 24/7: VPS обычно размещаются в профессиональных дата-центрах с высокой доступностью и стабильным интернет-соединением, что обеспечивает бесперебойную работу вашей системы умного дома.
• Удаленный доступ: Мы настроим безопасный доступ к Home Assistant из любой точки мира через доменное имя и HTTPS, защищенный SSL-сертификатом.

В качестве альтернатив Home Assistant на VPS можно рассмотреть:

• Home Assistant Green/Yellow или Raspberry Pi: Локальное решение, простое в развертывании, но ограниченное по ресурсам и требующее постоянного питания и интернет-соединения в вашем доме.
• Облачные платформы умного дома (Google Home, Amazon Alexa, Apple HomeKit): Удобны, но часто требуют передачи ваших данных на их сервера и ограничивают контроль над устройствами.
• Managed-решения (например, Home Assistant Cloud): Предлагают удобный удаленный доступ и интеграцию с голосовыми помощниками за абонентскую плату, но все еще зависят от стороннего сервиса.

Выбор self-hosted решения на VPS позволяет объединить преимущества локального контроля с надежностью и производительностью облачной инфраструктуры, делая его идеальным для продвинутых пользователей и тех, кто ценит приватность.

Какой VPS-конфиг нужен под эту задачу

Выбор подходящего VPS-конфига критически важен для стабильной и быстрой работы Home Assistant, особенно по мере роста вашей системы умного дома.

Минимальные требования (для небольших инсталляций, до 20-30 устройств/интеграций)

• CPU: 2 ядра (x86-64 архитектура)
• RAM: 4 ГБ (Home Assistant может быть требователен к памяти, особенно с базой данных и множеством дополнений)
• Диск: 80 ГБ SSD (быстрый диск важен для базы данных Home Assistant и оперативного доступа к файлам; 80 ГБ дают запас для логов, бэкапов и роста БД)
• Сеть: 100 Мбит/с (достаточно для удаленного доступа и обновлений)
• Операционная система: Ubuntu Server 24.04 LTS (рекомендуется)

Рекомендуемый VPS-план (для средних и крупных инсталляций, 50+ устройств, камеры, голосовые помощники)

• CPU: 4 ядра
• RAM: 8 ГБ
• Диск: 160 ГБ SSD (с запасом для долгосрочных данных, истории и возможных Docker-образов других сервисов)
• Сеть: 1 Гбит/с (для быстрой загрузки, стриминга видео с камер)
• Операционная система: Ubuntu Server 24.04 LTS

Для аренды VPS с такими характеристиками можно рассмотреть VPS с указанными характеристиками, подходящий для надежного хостинга Home Assistant.

Когда нужен dedicated сервер, а не VPS

Dedicated сервер может понадобиться в редких случаях, если:

• Вы планируете очень крупную инсталляцию Home Assistant (сотни устройств, десятки IP-камер с обработкой видео).
• Вам нужны абсолютно все ресурсы сервера без виртуализации.
• Вы хотите разместить на сервере множество других ресурсоемких приложений помимо Home Assistant.
• Требуется специфическое аппаратное обеспечение, недоступное на VPS (например, GPU для ИИ-задач).

В большинстве случаев для Home Assistant достаточно хорошо сконфигурированного VPS. Если ваш проект требует максимальной производительности и полного контроля над железом, можно рассмотреть подходящий dedicated сервер.

Локация: на что влияет

Выбор локации VPS-сервера может повлиять на несколько аспектов:

• Задержка (Latency): Если вы планируете использовать Home Assistant для управления устройствами, требующими минимальной задержки (например, для мгновенной реакции на датчики), лучше выбрать сервер, географически близкий к вам или вашему дому. Однако для большинства автоматизаций и удаленного доступа задержка в 50-150 мс не будет критичной.
• Законодательство: В зависимости от ваших предпочтений к приватности и хранения данных, вы можете выбрать юрисдикцию, которая соответствует вашим требованиям.
• Цена: Цены на VPS могут варьироваться в зависимости от локации дата-центра.

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

Подготовка сервера

Перед установкой Home Assistant необходимо выполнить базовую настройку и защиту вашего VPS. Мы будем использовать Ubuntu Server 24.04 LTS как стабильную и широко используемую операционную систему.

1. Подключение по SSH

Подключитесь к вашему новому VPS, используя SSH. Вам понадобятся IP-адрес сервера и учетные данные (обычно root-пользователь и пароль, или SSH-ключ).

ssh root@ВАШ_IP_АДРЕС_VPS

2. Создание нового пользователя и настройка sudo

Работать под root-пользователем небезопасно. Создадим нового пользователя и добавим его в группу sudo.

# Замените 'ваш_пользователь' на желаемое имя пользователя
adduser ваш_пользователь
usermod -aG sudo ваш_пользователь

Теперь выйдите из сессии root и войдите под новым пользователем:

exit
ssh ваш_пользователь@ВАШ_IP_АДРЕС_VPS

3. Настройка аутентификации по SSH-ключам (рекомендуется)

Если вы еще не используете SSH-ключи, это самый безопасный способ аутентификации. Сгенерируйте ключи на вашей локальной машине, если их нет:

# На вашей ЛОКАЛЬНОЙ машине
ssh-keygen -t ed25519 -C "ваша_почта@example.com"

Скопируйте публичный ключ на сервер:

# На вашей ЛОКАЛЬНОЙ машине
ssh-copy-id ваш_пользователь@ВАШ_IP_АДРЕС_VPS

После успешного копирования, отключите вход по паролю для root и вашего нового пользователя. Отредактируйте файл конфигурации SSH-сервера:

sudo nano /etc/ssh/sshd_config

Найдите и измените следующие строки (или добавьте, если отсутствуют):

# Отключаем вход по паролю
PasswordAuthentication no
# Отключаем вход для root
PermitRootLogin no

Перезапустите SSH-сервис:

sudo systemctl restart sshd

4. Обновление системы

Всегда начинайте с обновления пакетной базы и установленных пакетов.

sudo apt update && sudo apt upgrade -y

5. Настройка брандмауэра (UFW)

UFW (Uncomplicated Firewall) — это простой в использовании интерфейс для iptables. Настроим его, чтобы разрешить только необходимые порты.

# Устанавливаем UFW, если не установлен
sudo apt install ufw -y

# Разрешаем SSH (порт 22)
sudo ufw allow ssh

# Разрешаем HTTP (порт 80) и HTTPS (порт 443) для веб-доступа и Let's Encrypt
sudo ufw allow http
sudo ufw allow https

# Разрешаем порт Home Assistant (обычно 8123), если планируется прямой доступ без прокси
# Однако, мы будем использовать Caddy как обратный прокси, поэтому этот порт можно оставить закрытым извне
# sudo ufw allow 8123/tcp

# Включаем брандмауэр
sudo ufw enable

Подтвердите, что хотите продолжить, если UFW предупредит о возможном разрыве SSH-соединения. Проверьте статус:

sudo ufw status verbose

6. Установка Fail2Ban

Fail2Ban сканирует логи и блокирует IP-адреса, показывающие признаки вредоносных атак (например, многократные неудачные попытки входа в SSH).

sudo apt install fail2ban -y
sudo systemctl enable fail2ban
sudo systemctl start fail2ban

Создайте файл локальной конфигурации для Fail2Ban, чтобы ваши изменения не были перезаписаны при обновлении пакета:

sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
sudo nano /etc/fail2ban/jail.local

В файле jail.local убедитесь, что секция [sshd] активна (enabled = true) и, возможно, настройте bantime (время блокировки) и maxretry (количество попыток).

# Пример секции sshd в jail.local
[sshd]
enabled = true
port = ssh
logpath = %(sshd_log)s
backend = %(sshd_backend)s
# bantime = 1d # Заблокировать на 1 день
# maxretry = 3 # Заблокировать после 3 неудачных попыток

Сохраните изменения и перезапустите Fail2Ban:

sudo systemctl restart fail2ban

7. Установка базовых утилит

Установим несколько полезных утилит, которые пригодятся в процессе установки и обслуживания.

sudo apt install curl wget git htop ntpdate -y

ntpdate поможет синхронизировать системное время, что важно для работы SSL-сертификатов и многих сетевых сервисов. В современных Ubuntu systemd-timesyncd обычно уже активен и достаточно эффективен.

# Проверка статуса синхронизации времени
timedatectl status

Установка ПО — пошагово

Теперь, когда сервер подготовлен, приступим к установке Docker, Docker Compose, Home Assistant и обратного прокси с SSL.

1. Установка Docker Engine (актуально для 2026 года)

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

# Обновляем список пакетов
sudo apt update

# Устанавливаем необходимые пакеты для установки Docker из репозитория
sudo apt install ca-certificates curl gnupg lsb-release -y

# Добавляем официальный GPG ключ Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# Добавляем репозиторий Docker в APT источники
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Обновляем список пакетов с учетом нового репозитория Docker
sudo apt update

# Устанавливаем Docker Engine, Docker CLI и containerd
sudo apt install docker-ce docker-ce-cli containerd.io -y

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

Добавляем нашего пользователя в группу docker, чтобы выполнять команды Docker без sudo (потребуется переподключение к SSH).

# Замените 'ваш_пользователь' на ваше имя пользователя
sudo usermod -aG docker ваш_пользователь

# Переподключитесь к SSH, чтобы изменения вступили в силу
exit
ssh ваш_пользователь@ВАШ_IP_АДРЕС_VPS

Проверьте, что Docker работает, запустив тестовый контейнер:

docker run hello-world

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

В современных версиях Docker Compose является плагином Docker CLI. Устанавливаем его:

sudo apt install docker-compose-plugin -y

# Проверяем версию Docker Compose
docker compose version

3. Подготовка структуры каталогов для Home Assistant

Создадим каталог, где будут храниться конфигурационные файлы Home Assistant и docker-compose.yml.

mkdir ~/homeassistant
cd ~/homeassistant

4. Создание файла docker-compose.yml для Home Assistant

Создайте файл docker-compose.yml. В нем мы определим сервис Home Assistant, его порты, тома для хранения данных и политику перезапуска.

nano docker-compose.yml

Вставьте следующее содержимое:

# Версия Docker Compose файла
version: '3'

# Определяем сервисы
services:
  homeassistant:
    # Используем официальный образ Home Assistant Core
    # Актуальный образ для 2026 года будет 'homeassistant/home-assistant:stable' или 'homeassistant/home-assistant:2026.x.x'
    image: homeassistant/home-assistant:stable
    # Название контейнера
    container_name: homeassistant
    # Указываем, какие порты контейнера маппировать на хост
    # Порт 8123 - стандартный порт Home Assistant
    # Мы маппируем его на локальный порт 8123, который будет доступен только внутри VPS
    # Доступ извне будет через Caddy (обратный прокси)
    ports:
      - "127.0.0.1:8123:8123"
    # Тома для сохранения данных Home Assistant
    # /path/to/your/config:/config - замените на актуальный путь на вашем VPS
    volumes:
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro
    # Разрешаем контейнеру доступ к хост-сети для обнаружения устройств
    # network_mode: host # Можно использовать, но тогда порт 8123 будет открыт на всех интерфейсах VPS
    # Лучше использовать bridge network и настроить trusted_proxies в HA
    # Перезапускать контейнер автоматически, если он остановился
    restart: unless-stopped
    # Установка временной зоны
    environment:
      TZ: Europe/Moscow # Или ваша временная зона

Сохраните файл (Ctrl+O, Enter, Ctrl+X).

5. Запуск Home Assistant

Запустите контейнер Home Assistant с помощью Docker Compose:

docker compose up -d

Проверьте статус контейнера:

docker compose ps
docker logs homeassistant

Первый запуск Home Assistant может занять несколько минут, пока он загружает все необходимые компоненты.

6. Установка и настройка Caddy (обратный прокси с авто-SSL)

Caddy — это мощный веб-сервер, который автоматически управляет SSL-сертификатами от Let's Encrypt. Он идеально подходит для нашего случая.

6.1. Добавление репозитория Caddy

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update

6.2. Установка Caddy

sudo apt install caddy -y

6.3. Настройка Caddyfile

Создайте или отредактируйте файл конфигурации Caddy. Убедитесь, что у вас есть доменное имя (например, ha.yourdomain.com), указывающее на IP-адрес вашего VPS.

sudo nano /etc/caddy/Caddyfile

Удалите все существующее содержимое и вставьте следующее, заменив ha.yourdomain.com на ваш реальный домен:

# Ваш домен для Home Assistant
ha.yourdomain.com {
    # Включаем автоматическую выдачу и обновление SSL-сертификата Let's Encrypt
    tls [email protected]

    # Обратный прокси к Home Assistant, запущенному на локальном порту 8123
    reverse_proxy 127.0.0.1:8123 {
        # Заголовки, необходимые для корректной работы WebSocket и удаленного IP
        header_up Host {host}
        header_up X-Real-IP {remote_ip}
        header_up X-Forwarded-For {remote_ip}
        header_up X-Forwarded-Proto {scheme}
    }

    # Включаем сжатие, если необходимо (опционально)
    # encode gzip zstd

    # Логирование (опционально)
    # log {
    #     output file /var/log/caddy/ha_access.log
    # }
}

Сохраните файл (Ctrl+O, Enter, Ctrl+X).

6.4. Проверка и запуск Caddy

# Проверяем синтаксис Caddyfile
sudo caddy validate --config /etc/caddy/Caddyfile

# Перезапускаем сервис Caddy, чтобы применить изменения
sudo systemctl reload caddy

# Проверяем статус Caddy
sudo systemctl status caddy

Убедитесь, что Caddy успешно запустился и получил SSL-сертификат. Это может занять несколько секунд.

Конфигурация

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

1. Первичная настройка Home Assistant

Откройте ваш браузер и перейдите по адресу https://ha.yourdomain.com (замените на ваш домен). Вы должны увидеть страницу приветствия Home Assistant.

1. Создайте аккаунт владельца: Введите имя, логин и пароль для первого пользователя. Это будет ваш основной административный аккаунт.
2. Настройте местоположение: Укажите ваше местоположение, часовой пояс и единицы измерения. Это важно для корректной работы многих интеграций и автоматизаций (например, для рассвета/заката).
3. Обнаружение устройств: Home Assistant попытается автоматически обнаружить некоторые устройства в вашей локальной сети. Поскольку Home Assistant работает в Docker на VPS, он не будет видеть локальную сеть вашего дома напрямую. Вы будете добавлять устройства вручную или через другие мосты/шлюзы.
4. Завершите настройку: Вы попадете на главный дашборд Home Assistant.

2. Конфигурация Home Assistant для работы через обратный прокси

Для корректной работы Home Assistant через обратный прокси (Caddy) необходимо сообщить ему о доверенных прокси и включить использование заголовков X-Forwarded-For.

Подключитесь к вашему VPS и перейдите в каталог конфигурации Home Assistant:

cd ~/homeassistant/config
nano configuration.yaml

Добавьте следующие строки в configuration.yaml:

# Базовая конфигурация Home Assistant
homeassistant:
  # Если вы используете домен ha.yourdomain.com
  external_url: "https://ha.yourdomain.com"
  internal_url: "http://127.0.0.1:8123" # Внутренний адрес, доступный только на VPS

# Доверенные прокси
http:
  use_x_forwarded_for: true
  # IP-адрес вашего VPS. Это важно, чтобы Home Assistant доверял запросам от Caddy.
  # Если Caddy запущен на том же хосте, что и Home Assistant, используйте 172.17.0.1 (IP Docker-моста)
  # или подсеть Docker, если у вас сложная конфигурация сети.
  # Для простоты, если Caddy на том же хосте, можно использовать IP-адрес вашего VPS
  # или рассмотреть использование IP-адреса Docker-моста.
  # На Ubuntu с Docker по умолчанию, IP Docker-моста часто 172.17.0.1
  # Проверить можно командой: docker network inspect bridge
  trusted_proxies:
    - 172.17.0.0/16 # Пример: вся подсеть Docker-моста
    # Или конкретный IP, если Caddy не в Docker или на другом хосте:
    # - ВАШ_IP_АДРЕС_VPS

Сохраните файл (Ctrl+O, Enter, Ctrl+X).

Чтобы изменения вступили в силу, перезапустите контейнер Home Assistant:

cd ~/homeassistant
docker compose restart homeassistant

Дождитесь полного перезапуска (1-2 минуты), затем обновите страницу Home Assistant в браузере.

3. Использование секретов (secrets.yaml)

Для хранения чувствительных данных, таких как API-ключи, пароли, токены, крайне рекомендуется использовать файл secrets.yaml. Никогда не храните их напрямую в configuration.yaml.

В configuration.yaml вы ссылаетесь на секрет так:

# Пример в configuration.yaml
sensor:
  - platform: template
    sensors:
      my_secret_api_key: !secret my_api_key

А затем создаете файл secrets.yaml в том же каталоге ~/homeassistant/config/:

nano ~/homeassistant/config/secrets.yaml

И добавляете туда сам секрет:

# Пример в secrets.yaml
my_api_key: "ваш_очень_секретный_ключ"
my_password: "мой_супер_пароль_123"

Убедитесь, что права доступа к secrets.yaml ограничены:

chmod 600 ~/homeassistant/config/secrets.yaml

4. Проверка работоспособности

После всех настроек убедитесь, что все работает корректно:

• Доступ по HTTPS: Откройте https://ha.yourdomain.com в браузере. Убедитесь, что видите зеленый замок и никаких предупреждений о безопасности.
• Проверка SSL-сертификата: В браузере проверьте детали сертификата (кем выдан, срок действия).
• Проверка WebSocket-соединения: Home Assistant активно использует WebSocket. Откройте панель разработчика в браузере (F12), вкладку "Network" и убедитесь, что нет ошибок WebSocket.
• Проверка логов Home Assistant: Убедитесь, что нет критических ошибок, связанных с сетью или прокси.

cd ~/homeassistant
docker compose logs homeassistant

Вы успешно настроили Home Assistant на VPS с безопасным доступом через HTTPS!

Бэкапы и обслуживание

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

1. Что бэкапить

Основной объем данных Home Assistant хранится в каталоге config, который мы примонтировали к контейнеру. В нем находятся:

• Конфигурационные файлы: configuration.yaml, secrets.yaml и другие YAML-файлы для интеграций, автоматизаций, скриптов.
• База данных: Обычно файл home-assistant_v2.db (SQLite) или данные для внешней БД (PostgreSQL, MariaDB). В ней хранится вся история состояний устройств, логи и события.
• Дополнения (Add-ons) и кастомные интеграции (Custom Components): Если вы используете Home Assistant Core без Supervisor, то дополнения устанавливаются отдельно. Кастомные интеграции обычно находятся в каталоге custom_components.
• Медиафайлы: Если Home Assistant используется для хранения изображений или других медиа.

Также не забудьте о конфигурации Caddy: /etc/caddy/Caddyfile.

2. Простой скрипт автобэкапа с Restic

Restic — это современная, быстрая и безопасная программа для резервного копирования. Она поддерживает дедупликацию, шифрование и множество бэкендов (S3, SFTP, локальный диск).

2.1. Установка Restic

# Загрузка последней версии Restic (актуально для 2026)
# Проверьте страницу релизов Restic на GitHub для последней версии
wget https://github.com/restic/restic/releases/download/v0.16.4/restic_0.16.4_linux_amd64.bz2 -O restic.bz2
bzip2 -d restic.bz2
sudo mv restic /usr/local/bin/restic
sudo chmod +x /usr/local/bin/restic

2.2. Инициализация репозитория Restic

Мы будем использовать внешний S3-совместимый бэкенд (например, MinIO, Wasabi, Backblaze B2 или AWS S3). Создайте бакет и получите ключи доступа.

# Установите переменные окружения для S3
export AWS_ACCESS_KEY_ID="ВАШ_S3_КЛЮЧ_ДОСТУПА"
export AWS_SECRET_ACCESS_KEY="ВАШ_S3_СЕКРЕТНЫЙ_КЛЮЧ"
export RESTIC_REPOSITORY="s3:s3.your-s3-provider.com/ваш-бакет-для-ha" # Замените на ваш S3-эндпоинт и бакет
export RESTIC_PASSWORD="ВАШ_НАДЕЖНЫЙ_ПАРОЛЬ_ДЛЯ_РЕПОЗИТОРИЯ_RESTIC"

# Инициализируем репозиторий Restic
restic init

Важно: Запишите RESTIC_PASSWORD в безопасном месте!

2.3. Создание скрипта бэкапа

Создайте файл backup_ha.sh в домашнем каталоге вашего пользователя:

nano ~/backup_ha.sh

Вставьте следующее содержимое, заменив переменные на ваши значения:

#!/bin/bash

# Переменные окружения для Restic
export AWS_ACCESS_KEY_ID="ВАШ_S3_КЛЮЧ_ДОСТУПА"
export AWS_SECRET_ACCESS_KEY="ВАШ_S3_СЕКРЕТНЫЙ_КЛЮЧ"
export RESTIC_REPOSITORY="s3:s3.your-s3-provider.com/ваш-бакет-для-ha"
export RESTIC_PASSWORD="ВАШ_НАДЕЖНЫЙ_ПАРОЛЬ_ДЛЯ_РЕПОЗИТОРИЯ_RESTIC"

# Директории для бэкапа
HA_CONFIG_DIR="/home/ваш_пользователь/homeassistant/config"
CADDY_CONFIG_FILE="/etc/caddy/Caddyfile"

# Логирование
LOG_FILE="/var/log/ha_backup.log"

# Функция для логирования
log_message() {
  echo "$(date '+%Y-%m-%d %H:%M:%S') - $1" | sudo tee -a "$LOG_FILE"
}

log_message "Starting Home Assistant backup..."

# Остановка Home Assistant перед бэкапом БД (для консистентности)
# Если вы используете внешнюю БД, этот шаг может быть не нужен или должен быть адаптирован
cd /home/ваш_пользователь/homeassistant
docker compose stop homeassistant
log_message "Home Assistant container stopped."

# Выполнение бэкапа
restic backup \
  "$HA_CONFIG_DIR" \
  "$CADDY_CONFIG_FILE" \
  --verbose \
  --tag "homeassistant-daily" \
  --exclude-file "$HA_CONFIG_DIR/.gitignore" \
  --exclude ".log" \
  --exclude ".sqlite-journal" \
  --exclude "__pycache__" \
  --exclude ".storage" \
  --host "vps-$(hostname)" 2>&1 | sudo tee -a "$LOG_FILE"

# Удаление старых бэкапов (политика: хранить 7 последних ежедневных, 4 еженедельных, 12 ежемесячных, 1 ежегодный)
restic forget \
  --prune \
  --tag "homeassistant-daily" \
  --keep-daily 7 \
  --keep-weekly 4 \
  --keep-monthly 12 \
  --keep-yearly 1 2>&1 | sudo tee -a "$LOG_FILE"

# Запуск Home Assistant после бэкапа
docker compose start homeassistant
log_message "Home Assistant container started."

log_message "Backup finished."

Сделайте скрипт исполняемым:

chmod +x ~/backup_ha.sh

2.4. Добавление скрипта в Cron

Настроим ежедневный запуск скрипта бэкапа в 3 часа ночи.

crontab -e

Добавьте следующую строку в конец файла:

0 3   * /home/ваш_пользователь/backup_ha.sh > /dev/null 2>&1

Примечание: Убедитесь, что переменные окружения для Restic (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, RESTIC_REPOSITORY, RESTIC_PASSWORD) либо прописаны непосредственно в скрипте backup_ha.sh, либо доступны через профиль пользователя, под которым запускается cron (что сложнее). Проще всего вставить их в сам скрипт.

Также убедитесь, что пользователь ваш_пользователь имеет права на запись в /var/log/ha_backup.log (или измените путь к логу).

3. Куда складывать бэкапы

Как показано выше, рекомендуется использовать внешний S3-совместимый сервис для хранения бэкапов. Это обеспечивает географическую удаленность и высокую доступность данных, что критически важно в случае выхода из строя самого VPS.

• S3-совместимые хранилища: Backblaze B2, Wasabi, Amazon S3, DigitalOcean Spaces, Linode Object Storage.
• Другой VPS: Можно настроить Restic для бэкапа на другой VPS по SFTP, если у вас есть второй сервер.

4. Обновления: Rolling vs Maintenance Window

Регулярные обновления важны для безопасности и получения новых функций.

• Обновление Home Assistant:

  Home Assistant выпускает обновления примерно раз в месяц. Для обновления Docker-контейнера:

  
  cd ~/homeassistant
  docker compose pull homeassistant # Загружает новый образ
  docker compose up -d homeassistant # Останавливает старый, запускает новый
  

  Рекомендуется выполнять это в "окно обслуживания" (maintenance window), когда вы можете контролировать процесс и быстро устранить возможные проблемы. Перед обновлением рекомендуется сделать бэкап.

• Обновление ОС и Docker:

  Регулярно обновляйте операционную систему и Docker Engine:

  
  sudo apt update && sudo apt upgrade -y
  

  Это также лучше делать в окно обслуживания, так как некоторые обновления ядра или Docker могут потребовать перезагрузки VPS.

• Обновление Caddy:

  Caddy обновляется вместе с системными пакетами, если вы использовали репозиторий:

  
  sudo apt update && sudo apt upgrade -y
  sudo systemctl reload caddy # После обновления
  

Troubleshooting + FAQ

Home Assistant не запускается или выдает ошибку 502 Bad Gateway

Что проверить:

1. Логи Docker-контейнера Home Assistant: Проверьте, что контейнер Home Assistant запущен и нет критических ошибок в его логах.
2. Статус контейнера: Убедитесь, что контейнер Home Assistant находится в состоянии "running".
3. Логи Caddy: Если Caddy выдает 502, это означает, что он не может достучаться до Home Assistant. Проверьте логи Caddy на предмет ошибок соединения.
4. Доступность порта Home Assistant: Убедитесь, что Home Assistant слушает на порту 8123 внутри VPS (curl http://127.0.0.1:8123).

Как фиксить:

cd ~/homeassistant
docker compose ps # Проверить статус
docker compose logs homeassistant # Проверить логи HA
sudo journalctl -u caddy --no-pager # Проверить логи Caddy

Если в логах Home Assistant есть ошибки конфигурации, исправьте configuration.yaml и перезапустите контейнер. Если Caddy не может соединиться, проверьте порт в Caddyfile и убедитесь, что Home Assistant действительно слушает на 127.0.0.1:8123.

Нет доступа по HTTPS или ошибка SSL

Что проверить:

1. DNS-запись: Убедитесь, что ваша A-запись для домена (например, ha.yourdomain.com) корректно указывает на IP-адрес вашего VPS. Используйте dig ha.yourdomain.com или nslookup ha.yourdomain.com.
2. Брандмауэр (UFW): Убедитесь, что порты 80 (HTTP) и 443 (HTTPS) открыты. Let's Encrypt использует порт 80 для проверки домена.
3. Логи Caddy: Caddy автоматически пытается получить SSL-сертификат. Проверьте его логи на ошибки, связанные с Let's Encrypt.
4. Синтаксис Caddyfile: Ошибка в конфигурации Caddyfile может помешать его запуску или получению сертификата.

Как фиксить:

sudo ufw status verbose # Проверить статус UFW
sudo journalctl -u caddy --no-pager # Проверить логи Caddy
sudo caddy validate --config /etc/caddy/Caddyfile # Проверить синтаксис Caddyfile

Если проблема в DNS, дождитесь обновления записей. Если в UFW, откройте порты. Если в Caddy, исправьте Caddyfile и перезапустите sudo systemctl reload caddy.

Проблемы с интеграциями или обнаружением устройств

Что проверить:

1. Настройки сети Docker: По умолчанию Home Assistant в Docker находится в изолированной сети. Это означает, что он не может напрямую "видеть" устройства в вашей домашней локальной сети.
2. Настройки Home Assistant: Убедитесь, что все интеграции настроены с правильными учетными данными и IP-адресами/хостами.
3. Firewall на VPS: Если вы пытаетесь подключиться к устройствам в вашем доме через VPN или другую сложную сеть, убедитесь, что firewall на VPS не блокирует эти соединения.

Как фиксить:

Для обнаружения локальных устройств вам потребуется настроить VPN-туннель (например, WireGuard) между вашим VPS и вашей домашней сетью, чтобы Home Assistant мог "видеть" локальные IP-адреса. Или использовать MQTT-брокер, который выступает в роли посредника, или облачные интеграции, если они поддерживаются вашими устройствами.

Какой VPS-конфиг минимально подойдёт?

Минимально рекомендуемый конфиг для Home Assistant на VPS — это 2 ядра CPU, 4 ГБ ОЗУ и 80 ГБ SSD-диска. Этого достаточно для небольшой системы умного дома (до 20-30 устройств) с базовыми автоматизациями и историей данных. Однако, если вы планируете активно использовать камеры, сложные скрипты, голосовых помощников или хранить долгую историю, рекомендуется увеличить ресурсы до 4 ядер CPU, 8 ГБ ОЗУ и 160 ГБ SSD для более комфортной работы и запаса на будущее.

Что выбрать — VPS или dedicated для этой задачи?

Для большинства пользователей Home Assistant на VPS является оптимальным выбором. Он предлагает достаточную производительность, гибкость и надежность по более доступной цене, чем dedicated сервер. Dedicated сервер стоит рассматривать только в очень специфических случаях: если у вас сотни устройств, множество IP-камер с видеоаналитикой, вы планируете запускать десятки других ресурсоемких сервисов на том же сервере, или вам нужен полный аппаратный контроль для специфических задач (например, с GPU). В 95% случаев VPS будет более чем достаточно.

Как обновить Home Assistant?

Для обновления Home Assistant, запущенного в Docker, перейдите в каталог с вашим docker-compose.yml (например, ~/homeassistant) и выполните следующие команды:

docker compose pull homeassistant # Загружает последнюю стабильную версию образа Home Assistant
docker compose up -d homeassistant # Останавливает текущий контейнер и запускает новый с обновленным образом

Всегда делайте резервную копию конфигурации перед обновлением.

Как перенести Home Assistant на новый сервер?

Перенос Home Assistant, развернутого с Docker Compose, относительно прост. Вам нужно:

1. Создать полный бэкап вашего текущего каталога ~/homeassistant/config.
2. Скопировать этот бэкап на новый сервер.
3. Установить Docker и Docker Compose на новом сервере.
4. Создать структуру каталогов и файл docker-compose.yml, как описано в этом руководстве.
5. Распаковать бэкап в каталог ~/homeassistant/config на новом сервере.
6. Запустить Home Assistant с помощью docker compose up -d.
7. Настроить DNS и Caddy на новом сервере.

Это подчеркивает преимущество Docker: все зависимости инкапсулированы, и перенос сводится к копированию данных и конфигурации Docker.

Проблемы с производительностью Home Assistant

Что проверить:

1. Использование ресурсов VPS: Используйте htop, docker stats для мониторинга CPU, RAM и дискового I/O.
2. Размер базы данных: Большая база данных Home Assistant (home-assistant_v2.db) может замедлять работу.
3. Количество интеграций и автоматизаций: Слишком много активных интеграций или неоптимизированных автоматизаций могут потреблять ресурсы.

Как фиксить:

Если VPS перегружен, рассмотрите апгрейд ресурсов. Для оптимизации базы данных настройте recorder в configuration.yaml, чтобы исключить ненужные сущности из записи или ограничить срок хранения данных. Проанализируйте свои автоматизации на предмет циклических или ресурсоемких задач. Возможно, некоторые интеграции можно перенести на отдельные устройства (например, Zigbee2MQTT на Raspberry Pi).

Выводы и следующие шаги

Поздравляем! Вы успешно установили и настроили Home Assistant на вашем VPS с использованием Docker и безопасным доступом через HTTPS. Теперь у вас есть полностью контролируемая, приватная и масштабируемая платформа для управления вашим умным домом, доступная из любой точки мира. Это решение дает вам максимальную гибкость и независимость от сторонних сервисов.

Вот несколько следующих шагов, которые помогут вам максимально использовать вашу новую систему:

• Интеграция устройств: Начните добавлять свои умные устройства и сервисы в Home Assistant. Изучите официальную документацию Home Assistant по интеграциям.
• Создание автоматизаций: Используйте мощные инструменты автоматизации Home Assistant для создания сценариев, которые сделают ваш дом умнее и комфортнее.
• Исследование дополнений и кастомных интеграций: Расширяйте функциональность вашей системы с помощью сообщества Home Assistant, изучая доступные дополнения и пользовательские компоненты.
• Мониторинг и оптимизация: Продолжайте мониторить ресурсы вашего VPS, оптимизируйте базу данных и автоматизации для обеспечения стабильной и быстрой работы системы.