Поиск по базе знаний

Автоматическое резервное копирование Home Assistant на Яндекс Диск

Надежная система резервного копирования — это фундамент стабильного умного дома. Поскольку Home Assistant обычно работает на картах памяти MicroSD (в случае Raspberry Pi) или твердотельных накопителях SSD, всегда существует риск выхода диска из строя из-за частой перезаписи логов и базы данных. Потеря тщательно настроенной конфигурации, автоматизаций и дашбордов может обернуться часами рутины по восстановлению.

Самый безопасный способ защиты от подобных инцидентов — автоматическая выгрузка бэкапов во внешнее облачное хранилище. Для русскоязычных пользователей оптимальным решением является Яндекс Диск благодаря его высокой скорости работы и доступности. В этой инструкции мы настроим автоматическое создание резервных копий Home Assistant и их защищенную отправку в облако Яндекса.

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

Перед началом интеграции вам понадобятся:

  1. Сервер Home Assistant: У вас должна быть установлена операционная система Home Assistant OS или версия Home Assistant Supervised, так как резервное копирование настраивается через магазин дополнений (Add-ons).
  2. Аккаунт Яндекса: Свободное место на Яндекс Диске (обычно размер архива конфигурации без учета базы данных не превышает 50–200 МБ, поэтому стандартного бесплатного лимита хватит с запасом).
  3. Пароль шифрования: Рекомендуется заранее придумать надежный пароль для шифрования архивов, чтобы злоумышленники не смогли получить доступ к вашим токенам и ключам в случае утечки бэкапа.

Шаг 1. Установка аддона Yandex.Disk Backup

Для выгрузки архивов мы воспользуемся популярным и проверенным аддоном от русскоязычного сообщества.

  1. Откройте веб-интерфейс Home Assistant.
  2. Перейдите в раздел Настройки ➡️ Дополнения (Add-ons) ➡️ нажмите кнопку «Магазин дополнений» в правом нижнем углу.
  3. В правом верхнем углу нажмите на три точки ➡️ выберите «Репозитории» (Repositories).
  4. Добавьте URL-адрес репозитория аддона (например, репозиторий https://github.com/dmitry-kazakov/ha-yandex-disk-backup или аналогичный публичный репозиторий сообщества) и нажмите «Добавить».
  5. После обновления списка найдите в поиске Yandex.Disk Backup и нажмите «Установить».

Шаг 2. Авторизация и получение OAuth-токена

Для безопасного взаимодействия аддона с вашим облачным хранилищем Яндекса без ввода основного пароля от учетной записи используется протокол OAuth.

  1. Перейдите по ссылке авторизации, указанной в документации аддона (обычно это страница регистрации приложений Яндекса).
  2. Войдите под своим аккаунтом Яндекса и разрешите приложению доступ к папке приложений на Яндекс Диске.
  3. Скопируйте сгенерированный длинный токен авторизации (OAuth token).

IMPORTANT

Никогда не публикуйте ваш OAuth-токен в открытых логах и не передавайте его третьим лицам. Он дает полный доступ к выделенной папке на вашем Яндекс Диске. Рекомендуется сохранить его во внутренние секреты Home Assistant (secrets.yaml) под именем yandex_disk_token и вызывать оттуда.

Шаг 3. Настройка конфигурации аддона

После установки перейдите на вкладку «Конфигурация» (Configuration) установленного аддона и заполните основные поля:

token: !secret yandex_disk_token
backup_keep_local: 3
backup_keep_remote: 7
encryption_password: "Ваш_Сверхнадежный_Пароль"
schedule: "0 3 * * *"

Разбор ключевых параметров конфигурации:

  • backup_keep_local: Количество резервных копий, хранящихся локально на диске сервера Home Assistant (для быстрой очистки места).
  • backup_keep_remote: Количество копий, сберегаемых в облаке Яндекса. Более старые копии будут автоматически удаляться.
  • encryption_password: Пароль для шифрования архивов формата .tar.
  • schedule: Время запуска резервного копирования в формате cron. Значение 0 3 * * * означает ежедневный запуск в 3 часа ночи, когда нагрузка на сервер и сеть минимальна.

WARNING

Если ваша база данных умного дома (файл home-assistant_v2.db) разрослась до нескольких гигабайт, процесс создания архива и его загрузки в облако может вызывать зависание системы на слабых микрокомпьютерах вроде Raspberry Pi 3. Обязательно настройте очистку истории (параметр purge_keep_days в интеграции recorder) или исключите базу данных из резервной копии.

Шаг 4. Запуск и интеграция с панелью управления

  1. Вернитесь на вкладку «Информационная панель» аддона и нажмите «Запуск» (Start).
  2. Откройте вкладку «Журнал» (Log) для контроля процесса. Вы должны увидеть сообщения о создании бэкапа, шифровании и успешной отправке архива на Яндекс Диск.
  3. Откройте ваш Яндекс Диск на компьютере или телефоне и найдите там папку Приложения/Home Assistant Backup — в ней должен лежать свежий архив.

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

TIP

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

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

При повреждении системного накопителя следуйте нашей инструкции по аварийному восстановлению Home Assistant после сбоя SD-карты.

Инструкция по настройке

1

Добавление репозитория аддона

Добавьте репозиторий Yandex.Disk Backup в магазин аддонов Supervisor и установите плагин резервного копирования.

2

Получение токена авторизации

Пройдите авторизацию в сервисе Yandex OAuth, чтобы получить уникальный токен доступа для безопасной загрузки архивов на Яндекс Диск.

3

Настройка параметров резервирования

Сконфигурируйте аддон: укажите OAuth-токен, задайте пароль для шифрования архивов и настройте количество сохраняемых копий.

4

Создание расписания и проверка

Настройте автоматический запуск копирования по расписанию, запустите тестовый бэкап и проверьте его появление в облаке.