Если дома уже работает сетевое хранилище Synology, то отдельный компьютер для умного дома может и не понадобиться: NAS круглосуточно включён, у него надёжные диски и свои средства резервного копирования. Поэтому установка Home Assistant на Synology — частая задача. Способов два, и они принципиально разные: контейнер в Container Manager (бывший пакет Docker) или полноценная виртуальная машина с образом Home Assistant OS в приложении Virtual Machine Manager (VMM). В статье разберём оба варианта, их плюсы и ограничения, а затем подробно пройдём установку Home Assistant на Synology NAS в контейнере и обзорно — в виртуальной машине. Названия пунктов DSM меняются от версии к версии, поэтому там, где мы не уверены в точной формулировке, так и говорим.

1Контейнер или виртуальная машина: что выбрать
| Критерий | Container Manager (Docker) | Virtual Machine Manager (VMM) |
|---|---|---|
| Тип установки Home Assistant | Container | Home Assistant OS |
| Дополнения (add-ons) | Нет, только отдельные контейнеры | Есть, магазин дополнений работает |
| Нагрузка на NAS | Низкая | Выше: выделяются процессор и память |
| Доступность | Большинство моделей с поддержкой контейнеров | Только модели с поддержкой VMM |
| USB-адаптеры (Zigbee и др.) | Зависит от драйверов DSM | Можно пробросить USB-устройство в виртуальную машину |
| Сложность | Средняя | Выше |
Если вам нужны дополнения и «стандартный» Home Assistant, смотрите в сторону VMM. Если хочется лёгкости и вы готовы запускать ESPHome, Mosquitto и другие службы отдельными контейнерами, берите Container Manager. Для большинства домашних сценариев с Wi‑Fi устройствами, облачными интеграциями и сетевыми Zigbee-шлюзами хватит контейнера.
2Что понадобится
- NAS Synology с обновлённой DSM. Container Manager доступен в DSM 7.2 и новее; в более ранних версиях аналогичный пакет назывался Docker. Проверьте свою модель в списке совместимости на сайте производителя.
- Для VMM — модель, которая его поддерживает (как правило, это x86-модели с процессором Intel или AMD, а не младшие линейки и не ARM-модели) и достаточный запас оперативной памяти. Точный перечень сверяйте с таблицей совместимости Synology: мы не называем конкретные модели.
- Том с файловой системой Btrfs или ext4, на котором будет лежать конфигурация. Предпочтительно SSD или хотя бы том, где диски не уходят в спящий режим.
- Доступ к DSM с правами администратора и статический IP-адрес для NAS.
- Доступ из NAS в интернет для загрузки образов.

3Вариант 1. Home Assistant в Container Manager
Шаг 1. Устанавливаем Container Manager
Откройте Центр пакетов, найдите Container Manager и нажмите «Установить». Если на NAS стоит DSM 7.1 или старше, пакет называется Docker, и интерфейс отличается (там вместо проектов используются контейнеры и образы, а проекты появились позже). Дальнейшие шаги описаны для Container Manager.
Шаг 2. Готовим папки
- Откройте Панель управления → Общие папки и создайте общую папку
docker, если её ещё нет. Расположите её на нужном томе. - В File Station внутри
dockerсоздайте папкуhomeassistant, а в ней папкуconfig.
Полный путь к конфигурации на NAS будет примерно таким: /volume1/docker/homeassistant/config. Номер тома у вас может отличаться: /volume1, /volume2 и так далее.
Шаг 3. Создаём проект
- В Container Manager откройте раздел «Проект» и нажмите «Создать».
- Введите имя проекта, например
homeassistant, и выберите путь — папку/docker/homeassistant. - В качестве источника выберите создание файла
docker-compose.ymlи вставьте следующий текст:
services:
homeassistant:
container_name: homeassistant
image: "ghcr.io/home-assistant/home-assistant:stable"
volumes:
- /volume1/docker/homeassistant/config:/config
- /etc/localtime:/etc/localtime:ro
restart: unless-stopped
network_mode: host
environment:
TZ: Europe/Moscow
Замените путь к тому и часовой пояс на свои. Параметр network_mode: host позволяет Home Assistant видеть устройства в вашей сети и использовать порт 8123 напрямую. Параметр privileged: true из документации Home Assistant нужен для доступа к USB и Bluetooth; на NAS обычно ни то ни другое не используется, поэтому мы его не включаем, но при необходимости его можно добавить.
- Дальше мастер предложит настроить веб-портал (его можно пропустить) и покажет итоговые параметры. Нажмите «Готово».
- Container Manager скачает образ и запустит проект. Это займёт несколько минут.
Когда контейнер перейдёт в состояние работы, откройте в браузере адрес http://IP-вашего-NAS:8123. Если вы увидели приветственный экран Home Assistant, всё получилось: создайте учётную запись владельца и пройдите мастер.
Если порт 8123 занят другой службой на NAS, контейнер не запустится или интерфейс будет недоступен: в режиме host порт сменить настройкой проекта нельзя, придётся освободить занятый порт или менять настройку Home Assistant в разделе http файла configuration.yaml:
http:
server_port: 8124
Шаг 4. Ограничения образа на NAS
Образ с реестра ghcr.io может загружаться медленно или не загружаться вовсе, в зависимости от вашего провайдера и региона. Тогда помогут повторные попытки, другое время суток или зеркало реестра, которое вы используете легально; настраивается оно в параметрах Container Manager (раздел реестра). Конкретные кнопки в этой части интерфейса меняются, поэтому ищите пункт про реестр и зеркала.
Если после запуска появляется ошибка о несовместимости архитектуры, значит, ваш NAS построен на процессоре ARM и вы взяли неподходящий образ. Официальный образ Home Assistant существует для основных архитектур, включая aarch64, так что стандартный тег обычно подходит, но убедитесь, что используете именно официальный образ, а не стороннюю сборку.
Шаг 5. Что с USB-адаптерами
Здесь у Synology есть неприятная особенность: DSM не включает драйверы всех USB-последовательных адаптеров. Для многих популярных Zigbee-координаторов (на микросхемах CP210x, CH340, CDC-ACM) устройства в /dev могут не появиться без сторонних драйверов или ручной загрузки модулей. Это зависит от модели NAS и версии DSM, и мы не гарантируем, что у вас получится. Практичные решения:
- Использовать сетевой (Ethernet или Wi‑Fi) Zigbee-координатор: он подключается к Home Assistant по TCP и не требует USB на NAS.
- Вынести радио на отдельное маленькое устройство.
- Выбрать вариант с виртуальной машиной: USB-устройство пробрасывается в VM средствами VMM.
Шаг 6. HTTPS через обратный прокси DSM
DSM умеет работать обратным прокси, что удобно для доступа к Home Assistant по доменному имени. Путь в меню может отличаться в разных версиях DSM: обычно это Панель управления → Портал для входа → Дополнительно → Обратный прокси. Создайте правило: источник — HTTPS, ваше доменное имя, порт 443; назначение — HTTP, localhost, порт 8123. Обязательно включите передачу WebSocket: в настройках правила есть вкладка с пользовательскими заголовками, где доступна кнопка создания заголовков для WebSocket. Без неё интерфейс будет открываться, но не будет обновляться.
Затем Home Assistant нужно разрешить работу за прокси. В configuration.yaml добавьте:
http:
use_x_forwarded_for: true
trusted_proxies:
- 127.0.0.1
- 192.168.1.10
Здесь вместо 192.168.1.10 укажите адрес вашего NAS, с которого прокси отправляет запросы. Какой именно адрес увидит Home Assistant, можно определить по ошибке «запрос от прокси не из списка доверенных» в журнале: в сообщении виден адрес-источник. После правки перезапустите Home Assistant. Открывать NAS целиком в интернет только ради Home Assistant не стоит: используйте VPN или защищённый туннель, включите двухфакторную аутентификацию и обновляйте систему. Подробнее этот вопрос разобран в статье про удалённый доступ.
Шаг 7. Обновление и резервные копии
Обновить Home Assistant в Container Manager можно так: остановите проект, загрузите свежий образ тега stable (в разделе образов есть действие обновления) и пересоберите проект. В новых версиях Container Manager у проекта есть действие, которое пересобирает и обновляет образ; если вы не нашли его, воспользуйтесь командной строкой по SSH:
cd /volume1/docker/homeassistant
sudo docker compose pull
sudo docker compose up -d
Команда docker compose на DSM доступна после установки Container Manager, но в старых версиях вместо неё использовалась docker-compose с дефисом. Для SSH сначала включите службу в панели управления (раздел терминала и SNMP), а после работы отключите.
Резервное копирование на NAS удобно: папка конфигурации лежит на томе, который можно защитить снимками Btrfs (приложение Snapshot Replication) или Hyper Backup. Наличие снимка не заменяет резервную копию на другом устройстве. Для согласованности лучше делать копию при остановленном контейнере или хотя бы убедиться, что снимок не пришёлся на момент записи базы.
Дополнительные службы
Как и в любой установке Container, дополнений нет. ESPHome, Mosquitto и Zigbee2MQTT запускаются отдельными проектами Container Manager. Пример ESPHome:
services:
esphome:
container_name: esphome
image: ghcr.io/esphome/esphome
volumes:
- /volume1/docker/esphome/config:/config
- /etc/localtime:/etc/localtime:ro
restart: unless-stopped
network_mode: host
Интерфейс ESPHome будет доступен на порту 6052. Помните: первую прошивку платы вы всё равно делаете с компьютера по USB, а дальше обновляете по воздуху.
4Вариант 2. Home Assistant OS в Virtual Machine Manager
Этот способ даёт полноценный Home Assistant OS с Supervisor и дополнениями. Общая схема такая, а точные формулировки в интерфейсе VMM зависят от версии пакета.
- Установите Virtual Machine Manager из Центра пакетов. Если пакета нет в списке, ваша модель его не поддерживает.
- Скачайте образ Home Assistant OS. На странице установки Home Assistant есть раздел с образами для виртуальных машин. Для VMM подходит образ в формате QCOW2 (для KVM) или VMDK. Берите только с официального сайта проекта. Образ приходит в сжатом виде (обычно
.xz), перед импортом его нужно распаковать любым архиватором, умеющим работать с XZ. - Добавьте образ в VMM. В VMM есть раздел для образов, где можно загрузить образ диска с компьютера или с общей папки NAS. Укажите тип образа «диск» и выберите расположение хранилища.
- Создайте виртуальную машину. В мастере создания выберите импорт из образа диска. Типичные параметры: 2 виртуальных ядра, 2–4 ГБ оперативной памяти (по требованиям Home Assistant OS минимум около 2 ГБ, больше — для комфортной работы с дополнениями), диск — импортированный образ. Тип прошивки выберите UEFI, поскольку образы Home Assistant OS для x86-64 ожидают EFI-загрузку.
- Сеть. Подключите виртуальную машину к сети NAS так, чтобы она получала адрес от вашего роутера (режим моста или «сеть по умолчанию» с доступом в локальную сеть; название режима зависит от настроек VMM). От этого зависит, увидит ли Home Assistant ваши устройства и обнаружит ли его телефон. Если VM окажется во внутренней изолированной сети, обнаружение работать не будет.
- Запустите машину. Дождитесь загрузки (несколько минут, на консоли VMM будет виден процесс). Затем откройте
http://homeassistant.local:8123или IP-адрес VM, найденный в списке клиентов роутера. Первая настройка идёт несколько минут. - Автозапуск. В свойствах VM включите автозапуск вместе с NAS, чтобы после перезагрузки умный дом поднимался сам.
Для USB-адаптера в свойствах виртуальной машины можно добавить USB-устройство, подключённое к NAS. Это удобный способ, когда сами драйверы DSM адаптер не поддерживают. Но учтите, что Home Assistant OS внутри VM увидит адаптер как подключённый напрямую, и вам придётся выбрать порт в настройках интеграции (ZHA или Zigbee2MQTT).
Виртуальная машина потребляет выделенные ресурсы постоянно: оперативная память резервируется, нагрузка на процессор от неё есть всегда. На маломощных NAS с 2 ГБ памяти это ощутимо мешает основным задачам хранилища.
5Рекомендации по работе на NAS
- Не размещайте конфигурацию Home Assistant на томе, где диски часто засыпают: база данных пишется постоянно, а пробуждение дисков вызывает задержки и износ. По возможности используйте SSD-том или кэш.
- Уменьшите объём истории в
recorder, если том общий с другими задачами: параметрpurge_keep_daysзадаёт срок хранения. - Зарезервируйте IP-адрес NAS и виртуальной машины в роутере.
- Следите за обновлениями DSM: крупное обновление системы может перезапустить службы. Автозапуск проекта обеспечивает параметр
restart: unless-stopped. - Не давайте контейнеру лишних прав: оставляйте
privilegedвыключенным, пока он не нужен.
6Типичные ошибки и решения
Контейнер сразу останавливается
Откройте журнал проекта в Container Manager. Частые причины: неверный путь к папке конфигурации (проверьте номер тома), занятый порт 8123 или отсутствие прав на папку. Убедитесь, что папка существует и доступна на запись.
Образ не скачивается
Проверьте доступ NAS в интернет и DNS, повторите попытку позже. Если проблема сохраняется, настройте зеркало реестра в параметрах Container Manager (точное расположение зависит от версии) или обратитесь к провайдеру.
Интерфейс открывается, но Home Assistant не находит устройства
Проверьте режим network_mode: host. Без него автообнаружение по mDNS и SSDP не работает. В случае VMM проверьте, что виртуальная машина находится в вашей локальной сети, а не в отдельной.
Ошибка 400 после настройки обратного прокси
Это ответ Home Assistant на запрос от недоверенного прокси. Добавьте адрес прокси в trusted_proxies и включите use_x_forwarded_for, как показано выше, затем перезапустите.
Интерфейс через прокси висит или не обновляется
Не включена передача WebSocket в правиле обратного прокси DSM. Добавьте соответствующие заголовки в настройках правила.
Виртуальная машина не загружается
Проверьте, что выбран тип прошивки UEFI и образ распакован из архива. Неверный формат диска или BIOS вместо UEFI приводят к чёрному экрану без загрузки.
Медленная работа
На NAS с маломощным процессором и HDD интерфейс может тормозить. Проверьте нагрузку в мониторе ресурсов DSM, перенесите конфигурацию на SSD, сократите историю и отключите ненужные интеграции.
7Итог
Home Assistant на Synology запускается двумя способами. Контейнер в Container Manager проще и легче, но без дополнений и с возможными сложностями с USB-адаптерами. Виртуальная машина в VMM даёт полноценный Home Assistant OS с магазином дополнений, но доступна не на всех моделях и требует выделенных ресурсов. Выберите вариант по своим задачам, заранее разберитесь с резервным копированием и доступом снаружи, а если пункт меню в вашей версии DSM отличается от описанного, ориентируйтесь на смысл шага и справку Synology.
Вопросы и ответы
Какой способ установки Home Assistant на Synology лучше?
Container Manager проще и легче, но без дополнений. Виртуальная машина VMM с образом HAOS даёт магазин дополнений, но доступна не на всех моделях и требует выделенных ресурсов.
Во всех ли NAS Synology есть Virtual Machine Manager?
Нет, пакет поддерживается не всеми моделями. Список совместимости смотрите на сайте Synology для своей модели.
Как работает USB Zigbee-адаптер на Synology?
DSM не содержит драйверов для всех USB-адаптеров, поэтому в контейнере адаптер может не появиться. Проще использовать сетевой Zigbee-координатор или пробросить USB в виртуальную машину VMM.
Почему интерфейс за обратным прокси DSM не работает?
Обычно не включена передача WebSocket в правиле прокси или адрес прокси не указан в trusted_proxies в configuration.yaml. Добавьте оба параметра и перезапустите Home Assistant.
Где хранить конфигурацию Home Assistant на NAS?
В общей папке на томе с SSD или хотя бы на томе, где диски не уходят в спящий режим. Папку защитите снимками Btrfs и копиями на другое устройство.



