Устанавливаем Home Assistant на Orange Pi: полное руководство

Опубликовано: 05.09.2025

Это подробная пошаговая инструкция по установке Home Assistant (HA) на одноплатные компьютеры Orange Pi. Мы рассмотрим два практически применимых и актуальных пути:

Home Assistant Container (Docker) — надёжный, полностью поддерживаемый способ на любом Linux (рекомендуется для Orange Pi);
Home Assistant Supervised на Debian 12 — даёт Supervisor и магазин Add‑ons, но требует строгого соответствия требованиям и считается более требовательным к окружению.

Почему мы не используем «Home Assistant OS» (готовый образ) прямо на Orange Pi? На 2025 год официальных образов HAOS для плат Orange Pi нет; наиболее бесшовный вариант — это Docker или Supervised на Debian 12.

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

Железо

Orange Pi (подойдут 64‑битные модели: Zero 2/2W/3/3B/5/5B/5 Plus, 3 LTS и др.).
Карта microSD A2/U3 на 16–64 ГБ (или eMMC/SSD для постоянной установки).
Блок питания нужной мощности (часто 5V 3A или USB‑C PD — смотрите спецификацию вашей платы).
Проводной Ethernet желательно для первого старта.

ПО и инструменты

Образ ОС для вашей платы (обычно Armbian или официальный Debian от Orange Pi).
Утилита записи образа: balenaEtcher или Raspberry Pi Imager.
Терминал и SSH‑клиент.

2) Выбор стратегии установки

Способ	Подходит для Orange Pi	Add‑ons	Обновления	Сложность
Home Assistant Container (Docker)	Да (рекомендовано)	Нет (заменяем контейнерами)	Docker‑пул и тэг `stable`	Низкая/Средняя
Home Assistant Supervised (Debian 12)	Да	Да (Supervisor)	Через Supervisor	Средняя/Высокая
Home Assistant Core (Venv)	Да	Нет	Pip/venv вручную	Средняя
Home Assistant OS (образ)	Нет (нет официальных образов для Orange Pi)	Да	Авто	—

Если вам важны «дополнения» (Mosquitto, Zigbee2MQTT, Node‑RED и т. п.) и единая точка управления — берите Supervised (на чистом Debian 12). Если нужна максимальная надёжность и простота — Container плюс «дополнения» как отдельные Docker‑контейнеры.

3) Подготовка Orange Pi

Скачайте образ ОС под конкретную модель:
- Armbian (Bookworm, CLI) — хорошо поддерживает большинство Orange Pi.
- Официальный Debian (Server) от Orange Pi — годится, если планируете Supervised.
Запишите образ на microSD с помощью balenaEtcher.
Первый запуск: вставьте карту, подключите Ethernet и питание.
Первичная настройка:
- Зайдите по SSH (у Armbian логин root или root/1234 — при первом входе попросят сменить; у официального Debian обычно orangepi/orangepi).
- Обновите систему:sudo apt update && sudo apt upgrade -y
- (Опц.) Перенос на eMMC/SSD: в Armbian используйте armbian-install (или nand-sata-install в старых версиях), следуйте мастеру.
- (Опц.) Назначьте статический IP через nmtui (NetworkManager) или в вашем роутере.

4) Путь A — Home Assistant Container (Docker)

Это полностью поддерживаемый метод и оптимальный выбор для Orange Pi.

4.1 Установка Docker

# Обновление и пакеты полезного минимума

sudo apt update && sudo apt install -y ca-certificates curl gnupg lsb-release

# Установка Docker (официальный скрипт)

curl-fsSL https://get.docker.com | sh

# (Опц.) Разрешить запуск Docker команд без sudo для текущего пользователя

sudo usermod -aG docker $USER

# Затем перелогиньтесь (или: newgrp docker)

# Плагин docker compose

sudo apt install -y docker-compose-plugin

Проверьте:

docker —version

docker compose version

4.2 Создание каталога и Compose

sudomkdir-p /opt/homeassistant/{config,media}

sudotee /opt/homeassistant/docker-compose.yml >/dev/null <<‘YAML’

services:

homeassistant:

container_name: homeassistant

image: ghcr.io/home-assistant/home-assistant:stable

restart: unless-stopped

network_mode: host

privileged: true

environment:

— TZ=Europe/Berlin # замените на ваш часовой пояс

volumes:

— /opt/homeassistant/config:/config

— /etc/localtime:/etc/localtime:ro

— /run/dbus:/run/dbus:ro # для интеграций, работающих через D-Bus (Bluetooth и т.п.)

devices:

— /dev/ttyUSB0:/dev/ttyUSB0 # Zigbee/Z-Wave стики (подставьте реальные устройства)

— /dev/ttyACM0:/dev/ttyACM0

YAML

Запуск:

cd /opt/homeassistant

sudo docker compose up -d

Через несколько минут интерфейс будет доступен на http://<IP‑OrangePi>:8123/.

4.3 «Дополнения» как контейнеры

Mosquitto (MQTT):

sudomkdir-p /opt/mosquitto/{config,data,log}

sudotee /opt/mosquitto/config/mosquitto.conf >/dev/null <<‘CONF’

listener 1883

allow_anonymous true

persistence true

persistence_location /mosquitto/data/

log_dest file /mosquitto/log/mosquitto.log

CONF

sudo docker run -d—name mosquitto —restart unless-stopped \

-p1883:1883 -v /opt/mosquitto/config:/mosquitto/config \

-v /opt/mosquitto/data:/mosquitto/data -v /opt/mosquitto/log:/mosquitto/log \

eclipse-mosquitto:latest

Zigbee2MQTT (пример для стика на /dev/ttyUSB0):

sudomkdir-p /opt/zigbee2mqtt/data

sudotee /opt/zigbee2mqtt/docker-compose.yml >/dev/null <<‘YAML’

services:

zigbee2mqtt:

image: koenkk/zigbee2mqtt

container_name: zigbee2mqtt

restart: unless-stopped

network_mode: host

environment:

— TZ=Europe/Berlin

volumes:

— /opt/zigbee2mqtt/data:/app/data

devices:

— /dev/ttyUSB0:/dev/ttyUSB0

YAML

cd /opt/zigbee2mqtt && sudo docker compose up -d

Portainer (удобно наблюдать контейнеры):

sudo docker volume create portainer_data

sudo docker run -d-p9000:9000 -p8000:8000 —name=portainer —restart=always \

-v /var/run/docker.sock:/var/run/docker.sock \

-v portainer_data:/data \

portainer/portainer-ce:latest

После запуска добавьте интеграции MQTT/Zigbee2MQTT в Home Assistant, укажите mqtt://localhost:1883, настройте сети Zigbee, привяжите устройства.

5) Путь B — Home Assistant Supervised (Debian 12 Bookworm)

Даёт Supervisor и каталог Add‑ons, но важно строго соблюдать требования. Настоятельно рекомендуется чистый Debian 12 без лишних сервисов.

5.1 Чистая установка Debian 12

Для Orange Pi используйте официальный Debian Server от производителя или Armbian (Bookworm), но лучший вариант для Supervised — чистый Debian 12.
Включите NetworkManager, отключите конфликтующие менеджеры сети.

5.2 Установка зависимостей

sudo apt update && sudo apt upgrade -y

sudo apt install -y \

apparmor apparmor-utils avahi-daemon ca-certificates curl dbus jq \

network-manager socat udisks2 \

systemd-journal-remote systemd-resolved

5.3 Docker CE

curl-fsSL https://get.docker.com | sh

5.4 Установка OS Agent (выберите актуальную версию и архитектуру `aarch64`)

# Пример: скачайте .deb с страницы релизов и установите

# (ссылку на последнюю версию смотрите в релизах os-agent)

sudo dpkg -i os-agent_*_linux_aarch64.deb

Проверьте службу haos-agent/os-agent.

5.5 Установка Home Assistant Supervised

Два способа (выберите один):

A. Через .deb пакет инсталлятора

wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb

sudo apt install ./homeassistant-supervised.deb

В процессе запросит machine type — для Orange Pi на 64‑бит ARM обычно используют qemuarm-64 или generic-aarch64.

B. Через скрипт

wget https://raw.githubusercontent.com/home-assistant/supervised-installer/master/installer.sh -O installer.sh

sudobash installer.sh —machine qemuarm-64

5.6 Первый вход

Откройте http://<IP‑OrangePi>:8123/, дождитесь подготовки контейнеров Supervisor и Core (пару минут). Если видите предупреждения «Unsupported», проверьте:

ОС — Debian 12;
включены systemd, NetworkManager, AppArmor;
нет конфликтующих сетевых менеджеров и «левых» контейнеров.

Замечание. Supervised ожидает, что это «апплианс»: машину лучше не использовать для посторонних сервисов (всё — через Supervisor/Add‑ons).

6) Доступ снаружи и HTTPS (опционально)

Варианты:

Роутер: проброс порта 8123 на IP Orange Pi + DDNS.
Reverse proxy в Docker (Caddy/NGINX) с автоматическим Let’s Encrypt (80/443 → 8123). Пример Caddy:

# Caddyfile (пример)

ha.example.com {

reverse_proxy 127.0.0.1:8123

}

Cloudflare Tunnel — доступ без открытых портов.

В Home Assistant включите «Использовать прокси» и «Доверенные прокси», если работаете через обратный прокси.

7) Резервные копии и миграции

Container: копируйте каталог /opt/homeassistant/config (или где хранится /config). Удобно делать ежедневный tar и отправку на NAS/S3.
Supervised: используйте встроенные Backups (фулл/частичные), храните оффсайт (NAS/облако).
Перенос между методами возможен через Restore из бэкапа.

8) Частые вопросы и нюансы Orange Pi

USB‑донглы Zigbee/Z‑Wave не появляются: проверьте ls -l /dev/serial/by-id/; добавьте соответствующее устройство в devices: контейнера.
Bluetooth: требует D‑Bus — см. монтирование /run/dbus:/run/dbus:ro в Compose.
eMMC/SSD установка: на Armbian используйте armbian-install для переноса с microSD.
Падение питания/SD‑карты: используйте качественный БП и карты A2/U3; для надёжности переходите на eMMC/SSD.
Температура: поставьте радиатор/кулер, особенно для Orange Pi 5/5 Plus.

9) Мини‑шпаргалка команд

# Логи Home Assistant (Container)

sudo docker logs -f homeassistant

# Обновление HA (Container)

cd /opt/homeassistant

sudo docker compose pull && sudo docker compose up -d

# Обновление Zigbee2MQTT

cd /opt/zigbee2mqtt

sudo docker compose pull && sudo docker compose up -d

# Проверка служб (Debian/Supervised)

systemctl status NetworkManager

aapparmor_status

# Резервная копия конфигурации (Container)

sudo tar -czf /opt/ha-backup-$(date +%F).tar.gz -C /opt/homeassistant config

10) Когда какой способ выбирать

Container (Docker) — простой, стабильный, гибкий; «дополнения» ставим как обычные контейнеры.
Supervised (Debian 12) — берите, если нужен Supervisor/магазин Add‑ons и готовы следовать требованиям (чистый Debian, AppArmor, NetworkManager и т.д.).

11) Полезные замечания по состоянию на 2025 год

Supervised официально поддерживается только на Debian 12; другие ОС ведут к статусу «Unsupported».
Команда Home Assistant объявила о постепенной эволюции установочных методов (в т.ч.

Думал на протяжении 6s

Готово! Я собрал для вас сверх-подробную инструкцию по установке Home Assistant на Orange Pi — с двумя проверенными путями (Docker/Container и Supervised на Debian 12), примерами docker-compose, настройкой Zigbee2MQTT/MQTT, резервным копированием и типичными проблемами. Откройте документ справа на холсте: «Home Assistant на Orange Pi: полное руководство (2025)».

Ключевые ориентиры и источники, на которые я опирался:

Официальные варианты установки и страница Home Assistant Container (Linux) — что даёт контейнерный способ и как его ставить.
Поддержка и требования для Supervised (в т.ч. список допустимых --machine значений и упор на Debian 12).
Скрипт/пакет supervised-installer и его проверки окружения (NetworkManager, AppArmor, Docker и т.д.).
Актуальные изменения по установочным методам в 2025 (депрекация отдельных вариантов и курс на упрощение миграций).

Умный дом, ЭлектроникаОдноплатный компьютер, Умный дом

Inreviews — самое интересное о технологиях, гаджетах и умном доме

Обзоры электроники и гаджетов