Home Assistant OS VM для Proxmox (РФ, без VPN)

Автономный установщик Home Assistant OS для Proxmox VE. Версия не зашита: при каждом запуске скрипт берёт актуальный stable и скачивает образ с источников, которые открываются из РФ без VPN.

Основан на community-scripts Home Assistant OS VM (MIT).

Документация

Пошаговая инструкция: Home Assistant OS в Proxmox VE — зачем HAOS, а не Docker; выбор CPU/RAM/диска; установка этим скриптом; первый запуск и мастер; постоянный IP; проброс Zigbee/Thread; снимки и типичные ошибки. Скрипт в этом репозитории создаёт только виртуальную машину; статья нужна, чтобы после установки настроить сеть, USB и бэкапы, а не гадать по консоли Proxmox.

Каталог установщиков: Скрипты Proxmox для РФ — список адаптированных community-scripts под запуск в России без VPN: зеркала APT и образов, готовые команды для Proxmox VE и исходники на GitFlic.

Примечания VM: Имя (RU) · VM → Web → Catalog → Source → Guide (тот же порядок полей, что у CT; ASCII из‑за API Proxmox).

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

Откуда берётся версия

Канал по умолчанию — stable. Номер читается из поля hassos.ova в момент установки:

1. https://version.home-assistant.io/stable.json
2. зеркала raw.githubusercontent.com/home-assistant/version (ghfast, gh-proxy, ghproxy.net)
3. raw.githubusercontent.com напрямую

Beta и dev доступны в расширенных настройках или через HAOS_CHANNEL. Номер можно зафиксировать вручную (HAOS_VERSION), иначе каждый запуск ставит то, что канал считает текущим релизом.

Откуда скачивается образ

Файл haos_ova-<версия>.qcow2.xz, по порядку:

1. https://os-artifacts.home-assistant.io — официальный CDN Home Assistant, не GitHub
2. https://ghfast.top — зеркало GitHub Releases
3. https://gh-proxy.com
4. https://ghproxy.net
5. https://github.com/home-assistant/operating-system — если доступен напрямую

Контрольная сумма SHA256SUMS сверяется до импорта. Для зеркал GitHub сумма обязательна. Если GitHub недоступен, образ с официального CDN принимается после проверки, что это целый xz-архив.

Установка

На хосте Proxmox VE:

bash -c "$(curl -fsSL 'https://gitflic.ru/project/kiberlis/haos-vm-ru/blob/raw?file=haos-vm.sh')"

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

bash haos-vm.sh --check-latest

Параметры по умолчанию

• актуальный stable на момент запуска
• 2 CPU / 4096 MB / диск 32 GB
• машина q35, UEFI (OVMF), virtio-scsi, QEMU Guest Agent
• сеть: один virtio NIC; мост выбирается из списка vmbr* на хосте (или BRIDGE=...)
• onboot=1, VM запускается после создания

Образ — готовый диск Home Assistant OS, не установщик. Первый старт занимает несколько минут, затем интерфейс открывается на порту 8123. Язык «Русский» выбирается на первом экране мастера.

Пример без диалогов

HAOS_ASSUME_YES=1 BRIDGE=vmbr0 STORAGE=local-lvm \
  bash haos-vm.sh

Переменные: HAOS_CHANNEL (stable, beta, dev), HAOS_VERSION, HAOS_URL, STORAGE, VMID, VM_NAME (имя VM в Proxmox, по умолчанию homeassistant; не HOSTNAME — это имя узла), CORE_COUNT, RAM_SIZE, DISK_SIZE, BRIDGE, MAC, VLAN, MTU, START_VM (yes/no), ONBOOT (0/1), CPU_TYPE (пусто или host), HAOS_ASSUME_YES=1.

Диск меньше 32 GB скрипт не ставит: таков размер образа HAOS, Proxmox не умеет его уменьшать. Больший размер расширяется, гостевая система забирает место при первой загрузке.

После установки

1. Дождитесь, пока VM получит адрес (скрипт пробует показать его сам).
2. Откройте http://<IP-адрес-VM>:8123 и пройдите мастер. Язык — Русский.
3. Дальше Home Assistant обновляет ОС и ядро сам, с того же канала, через os-artifacts.home-assistant.io. Повторно ставить VM для этого не нужно.

Требования

• Proxmox VE 8.x или 9.x, amd64
• около 32 GB свободного места на выбранном storage и место под сжатый образ (~0.5 GB) в /var/lib/vz
• доступ хотя бы к version.home-assistant.io и os-artifacts.home-assistant.io
• curl, xz, whiptail — недостающее скрипт ставит через apt

Лицензия

MIT (upstream community-scripts / tteck + адаптация).