Установка Home Assistant в Proxmox VE: HAOS скриптом и вручную, проброс Zigbee

Установка Home Assistant в Proxmox VE: обложка статьи Умный дом

Реклама. ООО «ТАЙМВЭБ.КЛАУД», ИНН 7810945525.

Timeweb

Home Assistant OS (HAOS) — готовая операционная система для умного дома: сам Home Assistant, магазин приложений (аддонов), резервные копии и обновления в один клик. Ставить её на голое железо не обязательно: в виртуальной машине Proxmox она работает так же, а на том же мини-ПК рядом живут роутер, медиасервер и всё остальное.

Ниже — установка Home Assistant в Proxmox: в приоритете скрипт (мой форк на GitFlic — адаптация community-scripts под РФ) и ручной способ без чужих скриптов. Потом — первый запуск, постоянный IP, проброс Zigbee, снимки и типичные ошибки. Проверено в октябре 2026 года на Proxmox VE 9, HAOS 18.3 и Home Assistant 2026.9; на Proxmox VE 8 всё делается так же.

Карточка скрипта в каталоге: Home Assistant OS VM · все скрипты

Почему HAOS в виртуальной машине, а не Docker или Supervised

  • HAOS — единственный полноценный вариант. В 2025 году разработчики объявили способы установки Supervised и Core устаревшими. Приложения (аддоны), встроенные бэкапы и обновления системы из интерфейса есть только в HAOS.
  • Docker-контейнер проще, но урезан. Сам Home Assistant в контейнере работает, а магазина приложений нет: Zigbee2MQTT, Mosquitto, ESPHome придётся ставить и обновлять отдельно.
  • В LXC-контейнер HAOS не ставится. Это целая операционная система со своим ядром, поэтому нужна именно виртуальная машина.
  • Proxmox даёт страховку. Снимок перед крупным обновлением делается за секунды, а если что-то сломалось, откат занимает минуту. Ночные бэкапы всей ВМ — штатная функция.

Что понадобится

Для установки Home Assistant в Proxmox нужно не так много:

  • Компьютер с процессором x86-64 и установленным Proxmox VE 8.0–8.9 или 9.0–9.2 — это версии, которые поддерживает скрипт на момент написания. Для Raspberry Pi и других ARM-плат скрипт не подходит.
  • Свободные ресурсы под ВМ: 2 ядра, 4 ГБ оперативной памяти и 32 ГБ на локальном SSD. Самому Proxmox нужно ещё 1–2 ГБ памяти.
  • Подключение Proxmox к сети кабелем. Сетевой мост поверх Wi-Fi в Proxmox толком не работает.
  • По желанию — USB-адаптер Zigbee, Thread или Z-Wave: Home Assistant Connect ZBT-1, Sonoff ZBDongle и подобные.
  • Сеть на хосте Proxmox. Рекомендуемый скрипт с GitFlic тянет версию и образ в основном с version.home-assistant.io и os-artifacts.home-assistant.io (без VPN). Оригинал community-scripts и ручная установка сильнее зависят от GitHub. Сам Home Assistant при работе и обновлениях всё равно ходит в реестр контейнеров (часто ghcr.io) — если он закрыт, смотрите раздел «Если GitHub не открывается».

Сколько ресурсов выделять, зависит от того, что будет крутиться в Home Assistant:

СценарийvCPUПамятьДиск
Обычный умный дом: датчики, свет, автоматизации24 ГБ32 ГБ
Плюс Zigbee2MQTT, Node-RED, база на годы истории2–44–6 ГБ64 ГБ
Камеры и Frigate с распознаванием объектов48 ГБ64 ГБ и больше
Локальный голосовой помощник (Whisper и Piper)48 ГБ64 ГБ

Языковую модель для голосового помощника разумнее запускать не внутри HAOS, а отдельно — как и на чём, разобрано в статье про локальные ИИ-модели.

Как устроен Home Assistant в Proxmox

Схема: Home Assistant в Proxmox — виртуальная машина HAOS, сетевой мост vmbr0, проброс USB-адаптера и роутер
ВМ подключается к сетевому мосту vmbr0 и получает свой IP в домашней сети, как отдельный компьютер. USB-адаптер Zigbee пробрасывается в ВМ напрямую.

Для роутера виртуальная машина выглядит как ещё одно устройство со своим MAC-адресом. Телефон и браузер подключаются к Home Assistant по её IP на порт 8123, а Proxmox в этом не участвует. Скрипт и ручной способ ниже создают одинаковую ВМ: тип машины q35, загрузка через UEFI, диск на контроллере VirtIO SCSI и включённый QEMU Guest Agent — он уже встроен в HAOS.

Установка HAOS скриптом (форк на GitFlic)

База — скрипт HAOS VM из Proxmox VE Helper-Scripts (MIT, раньше tteck). Я его адаптировал под РФ и выложил на GitFlic: kiberlis/haos-vm-ru. Из России ставьте форк: без зависимости от GitHub при установке, актуальный stable, образ в первую очередь с официального CDN Home Assistant.

Что изменено относительно оригинала

ОригиналЭта версия (GitFlic)
Тянет vm-core.func с GitHub при каждом запускеПолностью автономный bash-скрипт
Версия с raw.githubusercontent.comversion.home-assistant.io, запасные зеркала того же JSON
Образ в первую очередь с GitHub ReleasesСначала официальный CDN os-artifacts.home-assistant.io, GitHub только запасной
Версия может отставать от релиза на сайтеВсегда текущий hassos.ova выбранного канала
Телеметрия community-scriptsНет исходящих запросов, кроме версии, контрольной суммы и образа

Откуда берётся версия (канал по умолчанию — stable): version.home-assistant.io, затем зеркала JSON, и только потом raw GitHub. Образ haos_ova-<версия>.qcow2.xz: сначала os-artifacts.home-assistant.io, потом зеркала GitHub Releases (ghfast / gh-proxy / ghproxy.net), в конце сам GitHub. Контрольная сумма сверяется до импорта.

Установка форка (рекомендуется)

  1. В веб-интерфейсе Proxmox выберите узел (например, pve) → Оболочка (Shell).
  2. Вставьте команду и нажмите Enter:
bash -c "$(curl -fsSL 'https://gitflic.ru/project/kiberlis/haos-vm-ru/blob/raw?file=haos-vm.sh')"

Проверить, какую версию и с какого адреса скрипт скачает, без создания ВМ:

bash -c "$(curl -fsSL 'https://gitflic.ru/project/kiberlis/haos-vm-ru/blob/raw?file=haos-vm.sh')" -- --check-latest
  1. В диалоге можно согласиться с дефолтами или открыть Advanced. Советую Advanced — мост и размер диска лучше выбрать явно (шпаргалка ниже).
  2. Если хранилищ несколько, выберите локальное: local-lvm или local-zfs.
  3. Дождитесь строки об успешном завершении. По умолчанию: актуальный stable, 2 CPU / 4096 МБ / диск от 32 ГБ, q35 + UEFI, Guest Agent, один virtio NIC, onboot=1, ВМ стартует сама.

Без диалогов, например на мост vmbr0:

HAOS_ASSUME_YES=1 BRIDGE=vmbr0 STORAGE=local-lvm 
bash -c "$(curl -fsSL 'https://gitflic.ru/project/kiberlis/haos-vm-ru/blob/raw?file=haos-vm.sh')"

Диск меньше 32 ГБ скрипт не ставит: таков размер образа HAOS. Первый старт занимает несколько минут, затем интерфейс на порту 8123; язык «Русский» — в мастере. Подробности и переменные — в README проекта.

Про безопасность. Команда выполняет скрипт из интернета с правами root. Перед запуском можно открыть код на GitFlic. Если такой подход не устраивает — ручной способ ниже.

Удобнее запускать из встроенной оболочки Proxmox, а не по SSH: при SSH оригинальный community-scripts иногда ругается на определение параметров; форк тоже рассчитан на запуск на хосте.

Оригинал community-scripts (если нужен upstream)

Тот же установщик без моих правок: тянет core с GitHub, образ в первую очередь с GitHub Releases, возможна телеметрия. Имеет смысл, только если GitHub стабилен. Команда:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/vm/haos-vm.sh)"

Дальше диалог тот же: Default или Advanced. Настройки моста и диска — как в таблице ниже. Если команда зависает на загрузке с GitHub, возвращайтесь к форку на GitFlic или к ручной установке.

Какие настройки выбрать в режиме Advanced

Установка HAOS в Proxmox: шпаргалка по настройкам скрипта haos-vm в режиме Advanced
Зелёным отмечено то, что стоит поменять. Остальное можно оставить как есть.
  • Disk Size. Хватит 32 ГБ, но база истории и бэкапы со временем растут. Если места на SSD много, ставьте 64 ГБ. Увеличить диск потом тоже можно — об этом в разделе про ошибки.
  • Disk Cache. Режим Write Through надёжнее при внезапном отключении питания: запись считается завершённой только после того, как данные дошли до диска. Платить за это приходится скоростью записи, но для Home Assistant это почти незаметно. Если сервер стоит на ИБП, можно оставить None.
  • CPU Model. Host передаёт виртуальной машине все инструкции процессора — так быстрее работают Frigate, Whisper и шифрование. KVM64 нужен только для живой миграции между разными серверами кластера.
  • Bridge. Обычно это vmbr0. Если интернет у вас раздаёт виртуальный OpenWrt, выберите его LAN-мост — подробности ниже.

Проверьте кэш диска после скрипта

Важная деталь, которую легко пропустить. В текущей версии скрипта выбор Disk Cache показывается в итоговой сводке, но не попадает в настройки диска: диск подключается с кэшем по умолчанию, то есть None. Проверить и исправить можно за минуту.

  1. Выключите ВМ: Выключение (Shutdown) справа вверху.
  2. Откройте ВМ → Оборудование (Hardware) → Жёсткий диск (scsi0) → Изменить.
  3. В поле Кэш выберите Write through. Галочки Discard и SSD emulation оставьте включёнными.
  4. Нажмите OK и запустите ВМ.

То же самое из оболочки Proxmox. Номер ВМ и имя диска возьмите из вывода первой команды:

qm config 100 | grep scsi0
# scsi0: local-lvm:vm-100-disk-1,discard=on,size=32G,ssd=1
qm shutdown 100
qm set 100 --scsi0 local-lvm:vm-100-disk-1,discard=on,ssd=1,cache=writethrough
qm start 100

Ручная установка HAOS без скрипта

Здесь используется официальный образ HAOS для KVM (файл .qcow2) — тот самый, который предлагает официальная страница установки Home Assistant. Proxmox работает на KVM, поэтому образ подходит, но отдельной инструкции для Proxmox на официальном сайте нет: там описаны только VirtualBox, Unraid и KVM через virt-manager.

Ручной способ даёт ту же ВМ, только каждую команду вы видите и понимаете. Номер актуальной версии посмотрите на странице релизов HAOS и подставьте его в первую строку. Вместо local-lvm укажите своё хранилище.

VER=18.3
VMID=100
STORAGE=local-lvm

cd /var/tmp
wget https://github.com/home-assistant/operating-system/releases/download/$VER/haos_ova-$VER.qcow2.xz
xz -d haos_ova-$VER.qcow2.xz

qm create $VMID --name homeassistant --machine q35 --bios ovmf 
  --cores 2 --memory 4096 --cpu host --ostype l26 
  --net0 virtio,bridge=vmbr0 --scsihw virtio-scsi-pci 
  --agent enabled=1 --onboot 1 --tablet 0
qm set $VMID --efidisk0 $STORAGE:0,efitype=4m,pre-enrolled-keys=0
qm disk import $VMID haos_ova-$VER.qcow2 $STORAGE --format raw

Последняя команда напишет имя импортированного диска, например local-lvm:vm-100-disk-1. Подключите его, сделайте загрузочным, увеличьте до нужного размера и запустите ВМ:

qm set $VMID --scsi0 $STORAGE:vm-$VMID-disk-1,discard=on,ssd=1,cache=writethrough
qm set $VMID --boot order=scsi0
qm resize $VMID scsi0 32G
qm start $VMID
rm haos_ova-$VER.qcow2

Параметр pre-enrolled-keys=0 важен: он создаёт UEFI без ключей Secure Boot, а с включённым Secure Boot HAOS не загрузится. Если создаёте ВМ через мастер в веб-интерфейсе, на вкладке «Система» снимите галочку «Предустановить ключи» (Pre-Enroll keys).

Если GitHub не открывается

У многих провайдеров GitHub работает с перебоями. Для установки ВМ сначала используйте форк на GitFlic: версия и образ идут через version.home-assistant.io и os-artifacts.home-assistant.io. Ниже — проверка доступа и что делать, если недоступны GitHub/ghcr уже после установки (обновления аддонов и ядра). Сначала проверьте из оболочки Proxmox:

curl -sI -m 10 https://github.com | head -1
curl -sI -m 10 https://ghcr.io/v2/ | head -1

Любой ответ с кодом HTTP, даже 401 или 405, значит, что адрес доступен. Если команда молчит 10 секунд и ничего не выводит, доступа нет. Дальше всё зависит от того, что именно не открывается.

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

  1. Скачайте файл haos_ova-18.3.qcow2.xz (около 490 МБ) со страницы релизов HAOS. Берите именно вариант ova в формате qcow2.xz.
  2. Сверьте контрольную сумму: на странице релиза рядом с файлом указан SHA256. В Windows посчитать её можно командой certutil -hashfile haos_ova-18.3.qcow2.xz SHA256, в Linux и macOS — sha256sum или shasum -a 256. Для версии 18.3 сумма начинается с fae6a728.
  3. Скопируйте файл на Proxmox в папку /var/tmp. Из Windows удобно через WinSCP по протоколу SFTP под пользователем root, из Linux и macOS — командой ниже.
  4. Дальше выполните команды ручной установки, пропустив строку с wget.
scp haos_ova-18.3.qcow2.xz root@192.168.1.10:/var/tmp/

Не открывается ghcr.io. Это серьёзнее, и честно предупредить об этом важно. В образе HAOS есть только сама система и Supervisor, а основной контейнер Home Assistant (несколько сотен мегабайт) скачивается при первом запуске из ghcr.io. Оттуда же приходят обновления Home Assistant и приложений. Без доступа к ghcr.io установка остановится на экране подготовки, а в журнале Supervisor появятся ошибки загрузки образа. Посмотреть журнал можно в консоли ВМ командой supervisor logs.

Готового обходного пути на стороне Home Assistant нет: адрес реестра в Supervisor не меняется. Если ghcr.io у вашего провайдера недоступен, первую установку придётся делать там, где доступ есть. Например, если у вас два провайдера или подключение через другой канал связи. Уже установленный Home Assistant продолжит работать и без ghcr.io, но не сможет обновляться и ставить новые приложения.

Первый запуск и мастер настройки

  1. Откройте ВМ → Консоль. Когда HAOS загрузится, на экране появится приветствие с адресом вида http://192.168.1.50:8123. Тот же IP виден на вкладке Сводка — его показывает Guest Agent.
  2. Откройте этот адрес в браузере. Первые 5–20 минут Home Assistant готовится и скачивает компоненты — на экране будет надпись о подготовке. Это нормально, ВМ не перезагружайте.
  3. Создайте учётную запись владельца. Если вы переезжаете, например с Raspberry Pi, выберите восстановление из резервной копии — HAOS вернёт все настройки, интеграции и историю.
  4. Укажите расположение дома на карте, часовой пояс, единицы измерения и решите, отправлять ли анонимную аналитику. От местоположения зависят автоматизации «я дома / меня нет» и восход-закат.
  5. На последнем шаге Home Assistant покажет найденные в сети устройства. Добавлять их сразу не обязательно — это можно сделать позже в разделе Настройки → Устройства и службы.

Постоянный IP-адрес для Home Assistant

Адрес Home Assistant не должен меняться: на него завязаны приложение на телефоне, интеграции и проброс доступа извне. Есть два способа:

  • Резервирование DHCP на роутере — рекомендую. MAC-адрес ВМ есть в Proxmox: Оборудование → Сетевое устройство (net0). В настройках роутера закрепите за ним нужный IP. Все настройки сети остаются в одном месте.
  • Статический IP в самом Home Assistant. Настройки → Система → Сеть, раздел IPv4 → Статический. Укажите адрес, маску, шлюз и DNS. Адрес выбирайте вне диапазона DHCP роутера, иначе будет конфликт.

Проброс USB-адаптера Zigbee или Thread

Чтобы Home Assistant видел Zigbee-адаптер, вставленный в сервер, его нужно передать в ВМ.

  1. Вставьте адаптер в USB-порт сервера.
  2. Откройте ВМ → Оборудование → Добавить → USB-устройство.
  3. Выберите Использовать идентификатор поставщика/устройства USB (Use USB Vendor/Device ID) и найдите адаптер в списке.
  4. Выключите и снова включите ВМ. Простой перезагрузки изнутри HAOS бывает недостаточно.
  5. Home Assistant обнаружит адаптер и предложит настроить ZHA. Если предпочитаете Zigbee2MQTT — поставьте его как приложение. Какой координатор оставить и какие датчики брать, разобрано в статье Zigbee в Home Assistant.

Проброс по Vendor/Device ID переживает смену USB-порта. Исключение — два одинаковых адаптера: тогда пробрасывайте по порту. Сетевым координаторам с Ethernet, вроде SLZB-06, проброс не нужен вовсе: Home Assistant подключается к ним по IP. Так же через USB-устройство можно передать в ВМ Bluetooth-адаптер — встроенный Bluetooth мини-ПК обычно тоже висит на USB.

Снимки и резервные копии

Главный плюс Home Assistant в Proxmox — страховка от неудачных обновлений и сбоев диска. Пользуйтесь ей с первого дня:

  • Снимок перед крупным обновлением. ВМ → Снимки → Сделать снимок. Если после обновления что-то сломалось, кнопка «Откат» вернёт всё за минуту. Снимки работают на local-lvm (LVM-thin) и ZFS. Не копите их месяцами: старые снимки занимают место и замедляют диск.
  • Ночные бэкапы всей ВМ. Центр обработки данных → Резервное копирование → Добавить: выберите ВМ, расписание и режим «Снимок». Благодаря Guest Agent файловая система перед копированием «замораживается», и копия получается целостной. Храните бэкапы на другом диске или NAS.
  • Бэкапы самого Home Assistant. Они нужны для переезда на другое железо и восстановления отдельных настроек. Удобно отправлять их в облако — см. статью про бэкапы Home Assistant в Google Drive.

Сам HAOS и Home Assistant обновляйте как обычно, из интерфейса: Настройки → Система → Обновления. Пересоздавать ВМ или менять образ вручную не нужно.

Если интернет раздаёт виртуальный OpenWrt

Если Proxmox у вас работает ещё и роутером, как в статье про OpenWrt в Proxmox, ВМ Home Assistant должна смотреть в локальную сеть, а не в провайдера. В той схеме vmbr0 — это WAN, а локальная сеть — vmbr1. Поэтому в скрипте в поле Bridge укажите vmbr1, а для уже созданной ВМ поменяйте мост в Оборудование → Сетевое устройство (net0). Иначе Home Assistant окажется снаружи и не увидит устройства дома.

Частые ошибки и как их исправить

  • «This version of Proxmox VE is not supported». Скрипт проверяет версию Proxmox и не пускает слишком новые. Подождите обновления скрипта или поставьте HAOS вручную — способ выше от версии не зависит.
  • ВМ не загружается, в консоли «Access Denied» или «Failed to load Boot0001». Включён Secure Boot. Перезагрузите ВМ, нажмите Esc во время загрузки, откройте Device Manager → Secure Boot Configuration, снимите галочку и сохраните настройки. Другой вариант — пересоздать EFI-диск с pre-enrolled-keys=0.
  • «Подготовка Home Assistant» висит больше часа. Почти всегда это нет доступа к ghcr.io: Supervisor не может скачать контейнер Home Assistant. Проверьте командой supervisor logs в консоли ВМ и прочитайте раздел «Если GitHub не открывается».
  • ВМ не получает IP. Проверьте, что выбран правильный мост и что сам Proxmox подключён кабелем. В консоли HAOS команда network info покажет состояние сети.
  • Не открывается homeassistant.local:8123. Это имя работает через mDNS, а его поддерживают не все роутеры и не все устройства. Открывайте по IP.
  • Закончилось место на диске. Увеличьте диск командой qm resize 100 scsi0 +32G или кнопкой «Действие с диском → Изменить размер». При следующей загрузке HAOS сам расширит свой раздел.
  • Интерфейс тормозит при нескольких камерах. Добавьте ядра и память в Оборудование. Для Frigate подключите ускоритель: Coral TPU или встроенную графику Intel.

Доступ к Home Assistant из интернета

Не пробрасывайте порт 8123 на роутере напрямую: интерфейс окажется открыт всему интернету. Безопаснее туннель или Zero Trust-доступ. Варианты без белого IP разобраны в статьях про CloudPub для Home Assistant и OpenZiti. Отдельную камеру-звонок можно вывести на дашборд по инструкции про Aqara G4 и go2rtc.

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

Чем HAOS отличается от Home Assistant в Docker?

В HAOS есть магазин приложений, встроенные резервные копии и обновление системы из интерфейса. В Docker работает только сам Home Assistant, а Zigbee2MQTT, MQTT-брокер и прочее придётся ставить и обновлять отдельно.

Можно ли поставить HAOS в LXC-контейнер?

Нет. HAOS — полноценная операционная система со своим ядром, ей нужна виртуальная машина. В LXC можно запустить только Home Assistant в Docker, без приложений.

Сколько памяти выделить Home Assistant в Proxmox?

Для обычного умного дома хватает 4 ГБ. С камерами, Frigate или локальным голосовым помощником лучше 8 ГБ.

Безопасно ли запускать скрипт установки HAOS?

Из РФ рекомендую форк на GitFlic (haos-vm-ru): код открытый, без телеметрии community-scripts, версия и образ в первую очередь с version.home-assistant.io и официального CDN os-artifacts.home-assistant.io. Оригинал community-scripts тоже открытый, но сильнее зависит от GitHub. Перед запуском код можно прочитать. Если не хотите скрипты с правами root — ручная установка ниже даёт ту же ВМ.

Нужно ли включать Write Through?

Это защита базы данных от повреждения при внезапном отключении питания. Если сервер работает без ИБП, включите. Учтите, что текущая версия скрипта не применяет этот выбор к диску — проверьте вкладку «Оборудование».

Как перенести Home Assistant с Raspberry Pi в Proxmox?

Сделайте полную резервную копию на Raspberry Pi и скачайте её. Установите HAOS в Proxmox и на первом экране выберите восстановление из резервной копии. Zigbee-адаптер переставьте в сервер и пробросьте в ВМ.

Что делать, если GitHub не открывается?

Образ HAOS можно скачать на другом компьютере, сверить контрольную сумму и скопировать на Proxmox, а дальше поставить вручную. Но при первом запуске и при обновлениях Home Assistant скачивает компоненты из ghcr.io, и без доступа к нему установка не завершится.

Как обновлять Home Assistant в Proxmox?

Как обычно, из интерфейса Home Assistant: «Настройки → Система → Обновления». Перед крупным обновлением сделайте снимок ВМ в Proxmox.

Работает ли это на Proxmox VE 9?

Да. И скрипт, и ручной способ работают на Proxmox VE 8 и 9. Скрипт проверяет версию и может не запуститься на слишком свежем выпуске — тогда поможет ручная установка.

Читайте также

Коротко: Home Assistant в Proxmox ставится одной командой или десятком своих, работает как отдельный компьютер в домашней сети и при этом защищён снимками и бэкапами Proxmox. После установки проверьте кэш диска, закрепите IP и пробросьте Zigbee-адаптер. Если что-то не получилось, опишите свою схему в комментариях — разберёмся.

Рубрики: Умный дом Proxmox

Подписаться на новые статьи

Каналы и RSS. Без почты и рассылок.

Оцените статью
Добавить комментарий