Home Assistant Samba Share: резервное копирование и доступ к конфигурации

Введение

Samba Share — стандартное дополнение Home Assistant для доступа к файлам системы по сети. На практике его используют в двух основных сценариях: работа с резервными копиями и редактирование конфигурации с компьютера. В статье разобраны установка и настройка Samba Share, проверка работы, реальные сценарии использования и типовые проблемы.

Альтернативные варианты резервного копирования разобраны в статье Backup & Restore в Home Assistant: как сделать резервную копию и восстановление.

Установка и настройка Samba Share

Samba Share устанавливается как обычное дополнение (addon) Home Assistant через раздел «Дополнения» в настройках. После установки дополнение не запускается автоматически — сначала необходимо задать базовые параметры конфигурации.

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

Рекомендуется использовать отдельного пользователя, например homeassistant. Использование предустановленных имён вроде guest в виртуальных и облачных средах часто приводит к конфликтам и ошибкам при запуске.

Если при сохранении конфигурации возникают ошибки, связанные с паролем или невозможностью сохранить настройки, см. раздел «Конфигурация не сохраняется (HIBP timeout)» ниже.

Проверка работы Samba Share

Проверять работу Samba Share корректнее всего из локальной сети.

macOS

На macOS это можно сделать через Finder: в меню Go → Connect to Server… (⌘ + K) указать адрес smb://homeassistant, где homeassistant — это имя машины, на которой установлен Home Assistant. При необходимости вместо имени можно использовать IP-адрес сервера. После подключения сетевые каталоги Home Assistant будут доступны в Finder как обычные папки.

Если вы работаете из командной строки, команда mount | grep smb покажет, в какие каталоги были смонтированы сетевые ресурсы (как правило, в /Volumes). Для доступа к этим каталогам из Terminal или iTerm может потребоваться разрешить приложению доступ к файловой системе в System Settings → Privacy & Security → Full Disk Access, добавив используемый терминал в список разрешённых приложений.

Windows

В Windows достаточно открыть Проводник и в адресной строке указать \\homeassistant или IP-адрес сервера Home Assistant. После ввода имени пользователя и пароля Samba Share отобразится как сетевой ресурс.

Linux

В Linux-системах для проверки удобно использовать утилиту smbclient. Её можно установить, например, на Ubuntu командой apt install smbclient. После установки пакета можно выполнить команду smbclient -L //homeassistant -U homeassistant.

Если в ответ отображается список доступных каталогов (config, backup, media и другие), значит Samba Share работает корректно.

Пример корректного вывода:

Sharename       Type
---------       ----
config          Disk
addons          Disk
backup          Disk
media           Disk
IPC$            IPC

Сценарии использования Samba Share

Резервное копирование Home Assistant

Samba Share удобно использовать для доступа к резервным копиям Home Assistant. По умолчанию резервные копии хранятся в каталоге /backup (расположение может отличаться в зависимости от типа установки). После запуска Samba Share этот каталог становится доступен по сети.

Перенос резервных копий на другое хранилище может выполняться вручную — например, копированием файлов на рабочую станцию или NAS. Также перенос можно автоматизировать, запуская скрипт на рабочей станции, где примонтирован сетевой ресурс Samba Share.

На macOS утилита rsync доступна по умолчанию. Пример команды для копирования резервных копий с примонтированного сетевого ресурса:

rsync -av /Volumes/backup ~/homeassistant-backup

Доступ к конфигурации и файлам

Через Samba Share можно работать с конфигурационными файлами Home Assistant, например configuration.yaml и связанными YAML-файлами.

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

Типовые проблемы и ошибки

Конфигурация не сохраняется (HIBP timeout)

Распространённая ситуация — сообщение:
«Не удалось сохранить конфигурацию дополнения (Unknown error)».

Причина связана с тем, что Home Assistant проверяет заданный пароль через сервис Have I Been Pwned (HIBP). Если сервис недоступен из-за сетевых ограничений или проблем с DNS, сохранение конфигурации Samba Share завершается ошибкой.

Для диагностики достаточно проверить логи Supervisor командой ha supervisor logs. Временное решение — отключить проверку pwned командой ha security options --pwned=false.

После этого конфигурацию Samba Share можно сохранить и запустить.

Проблемы в облаке и виртуальных средах

При запуске Home Assistant в облаке или виртуальной машине возможны дополнительные сложности. Чаще всего они связаны с конфликтом предустановленных пользователей (например, guest), блокировкой портов локальным firewall или особенностями сетевой изоляции у облачного провайдера.

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

ha addons logs core_samba

Samba Share в облачных средах следует рассматривать как инструмент для локального доступа внутри сети, а не как публичный файловый сервис.

Заключение

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

Полезные ссылки

• HIBP timeout — подробный разбор механизма Have I Been Pwned и его влияния на Home Assistant
• Samba — сайт разработчиков Samba с документацией по настройке, эксплуатации и обеспечению безопасности SMB-хранилищ