Home Assistant в Proxmox: установка виртуальной машины HAOS

Home Assistant в Proxmox запускают как виртуальную машину с образом Home Assistant OS (HAOS): вы импортируете диск в формате qcow2, включаете UEFI (OVMF), выделяете 2 vCPU, 4 ГБ памяти и 32 ГБ диска. Такая схема сохраняет все возможности HAOS (add-on’ы, резервные копии) и добавляет снимки состояния и удобный перенос между серверами. Рассмотрим установку вручную и через готовый скрипт, а также проброс USB-стика Zigbee.

1Зачем HAOS в Proxmox

Если дома уже работает сервер на Proxmox VE, отдельная машина для Home Assistant не нужна. Преимущества виртуализации очевидны: перед обновлением можно сделать снимок ВМ и откатиться за минуту, бэкапы виртуальных машин делаются средствами Proxmox, а на том же хосте живут другие службы (NAS, видеонаблюдение, DNS). Минус один — зависимость от хоста: если сервер выключится, умный дом остановится вместе с ним.

Параметр ВМ	Значение
BIOS	OVMF (UEFI)
Машина (machine)	q35
Процессор	2 ядра, тип host
Память	4096 МБ (2048 минимум)
Диск	32 ГБ и больше, шина SCSI или VirtIO
Сеть	VirtIO, мост vmbr0
EFI-диск	Без предустановленных ключей Secure Boot
Автозапуск	Start at boot включён

2Установка вручную по шагам

Скачайте образ HAOS для KVM/Proxmox (файл с расширением .qcow2.xz) со страницы установки на сайте home-assistant.io и распакуйте его на узле Proxmox.
Создайте виртуальную машину без носителя: ОС — «Do not use any media», BIOS — OVMF, снимите галочку «Pre-Enroll keys» для EFI-диска.
Параметры системы: Machine — q35, контроллер SCSI — VirtIO SCSI. Диск, созданный мастером, удалите после создания ВМ.
Выделите ядра и память по таблице выше, сеть — VirtIO на мост vmbr0.
В консоли хоста импортируйте образ командой qm importdisk 100 haos_ova.qcow2 local-lvm, заменив 100 на номер вашей ВМ, а хранилище — на своё.
В свойствах ВМ найдите неподключённый диск (Unused Disk), добавьте его как SCSI или VirtIO и сделайте первым в порядке загрузки в разделе Options → Boot Order.
Включите автозапуск и запустите ВМ. Через несколько минут откройте http://homeassistant.local:8123 или http://IP:8123.

Размер диска можно позже увеличить через интерфейс Proxmox, а затем система сама расширит раздел при следующей загрузке.

3Установка скриптом сообщества

Для Proxmox существуют скрипты сообщества (Proxmox VE Helper-Scripts), которые скачивают образ, создают ВМ и настраивают параметры одной командой в консоли хоста. Это экономит время, но запуск скриптов из интернета от root требует доверия к источнику. Прочитайте скрипт перед запуском, а для критичных систем предпочитайте ручной способ.

Нет времени возиться с виртуализацией? Мы можем настроить Home Assistant под ключ на вашем Proxmox-сервере, включая пробросы и резервные копии.

4Проброс USB-стика Zigbee

Zigbee-координатор (например, Sonoff ZBDongle-E или SLZB) подключается к хосту, а потом пробрасывается в ВМ. В интерфейсе Proxmox откройте раздел Hardware ВМ → Add → USB Device и выберите устройство по идентификатору вендор/продукт, а не по порту: так проброс переживёт переподключение в другой порт. После перезапуска ВМ в Home Assistant появится последовательный порт для интеграции ZHA или для add-on’а Zigbee2MQTT.

Если вам нужна надёжность, рассмотрите сетевые координаторы (Ethernet или Wi-Fi): они не привязаны к конкретному хосту и не страдают от помех USB. Такой вариант упрощает миграцию ВМ между узлами кластера.

5Снимки, резервные копии и обновления

Перед обновлением ядра Home Assistant сделайте снимок ВМ в Proxmox (без сохранения памяти) и ещё создайте штатную резервную копию Home Assistant. Снимок откатывает систему целиком за минуту, а бэкап Home Assistant спасёт данные, если хранилище хоста повреждено. Настройте регулярное резервное копирование ВМ на другой диск или сетевое хранилище с помощью встроенных заданий Proxmox. Ещё лучше иметь копию на отдельном физическом устройстве.

6Типичные проблемы

ВМ не загружается и висит в UEFI-оболочке. Не выбран загрузочный диск или включены предустановленные ключи Secure Boot. Проверьте порядок загрузки и пересоздайте EFI-диск без ключей.
Нет сети. Проверьте, что адаптер подключён к мосту, и что DHCP на роутере выдаёт адрес.
Zigbee-стик пропадает. Используйте проброс по идентификатору устройства и качественный удлинитель USB.
Диск мал. Расширьте диск в Proxmox и перезагрузите ВМ.

7Хранилище и сеть: на что обратить внимание

Образ HAOS занимает небольшое место, но база данных растёт со временем. Размещайте диск ВМ на SSD: на жёстком диске запуск и обработка истории будут медленными. Тип хранилища (LVM-thin, ZFS, каталог) на работу Home Assistant влияет слабо, зато на ZFS вы получите удобные снимки и контроль целостности. Если используете ZFS, оставьте достаточно оперативной памяти хосту для кэша.

С сетью проще: подключайте ВМ к мосту, который смотрит в вашу домашнюю подсеть. Тогда Home Assistant будет находиться в одном сегменте с умными устройствами, и сработают mDNS, SSDP и широковещательные протоколы. Если вы разделяете сеть на VLAN (например, отдельный сегмент для IoT), заранее продумайте, как будет проходить обнаружение устройств между сегментами, и откройте нужные порты на файрволе.

8Миграция существующей установки в Proxmox

Если Home Assistant уже работает на Raspberry Pi или другом железе, переезд в Proxmox занимает около получаса. Порядок такой.

На старой системе создайте полную резервную копию и скачайте её на компьютер.
Создайте в Proxmox новую ВМ с HAOS и дождитесь первого запуска.
На экране первоначальной настройки выберите восстановление из резервной копии и загрузите файл.
Выключите старый Home Assistant, чтобы два экземпляра не конфликтовали (одинаковые устройства Zigbee и MQTT не должны управляться одновременно).
Перенесите Zigbee-стик, пробросьте его в ВМ и проверьте, что сеть Zigbee поднялась.

Zigbee-координатор при переносе чувствителен: у ZHA и Zigbee2MQTT есть собственные резервные копии сети, поэтому перед отключением старой системы сохраните и их. Тогда устройства не придётся перепрягать заново.

9Отказоустойчивость и питание

Главная особенность виртуализации — зависимость умного дома от одного сервера. Подключите хост к ИБП и настройте корректное выключение при длительном отключении электричества, иначе возможна порча файловой системы. Включите опцию автозапуска ВМ с небольшой задержкой, чтобы сеть и хранилище успели подняться раньше Home Assistant. Если у вас кластер из нескольких узлов Proxmox, можно настроить высокую доступность, но для одного дома это, как правило, избыточно: достаточно регулярных копий и запасного мини-ПК, на который можно быстро восстановить систему.

Если после настройки хочется довести сценарии до идеала, а времени нет, можно заказать автоматизацию на заказ.

Не забывайте периодически проверять свободное место на хранилище: переполненный диск хоста останавливает все виртуальные машины сразу, включая Home Assistant.

10Пример конфигурации виртуальной машины

Если вы настраиваете ВМ из консоли, в файле /etc/pve/qemu-server/100.conf (номер замените на свой) основные параметры выглядят примерно так:

bios: ovmf
machine: q35
cores: 2
memory: 4096
onboot: 1
scsihw: virtio-scsi-pci
scsi0: local-lvm:vm-100-disk-1,size=32G
efidisk0: local-lvm:vm-100-disk-0,efitype=4m
net0: virtio=BC:24:11:AA:BB:CC,bridge=vmbr0

Значения хранилищ и MAC-адрес у вас будут свои. Править этот файл вручную нужно только при необходимости, в остальных случаях используйте веб-интерфейс Proxmox.

11Частые вопросы

Чем HAOS в ВМ отличается от LXC-контейнера?

В LXC обычно запускают Home Assistant Container или Core, и add-on’ов там нет. Полноценную систему с Supervisor и магазином дополнений даёт именно виртуальная машина с HAOS.

Сколько ресурсов выделять?

Для типичного дома достаточно 2 vCPU и 4 ГБ памяти. Если планируете Frigate или много камер, нужны дополнительные ресурсы и, возможно, проброс GPU или ускорителя.

Как сделать бэкап всей ВМ?

Используйте задание Backup в Datacenter → Backup. Режим snapshot позволяет копировать работающую ВМ без остановки.

Можно ли пробросить Bluetooth-адаптер?

Да, как и USB-стик: добавьте USB-устройство в ВМ. Встроенный Bluetooth хоста пробросить сложнее, проще взять отдельный адаптер.

12Итог

HAOS в Proxmox — удобный вариант для тех, у кого уже есть сервер: вы получаете полный набор функций, снимки и простой перенос. Следите за пробросом USB и порядком загрузки UEFI, и установка пройдёт без проблем. Готовые сценарии для дома можно собрать в конструкторе автоматизаций.