Home Assistant на ТВ-приставке: установка на TV Box через Armbian

Дешёвая ТВ-приставка на процессоре Amlogic или Rockchip выглядит соблазнительно как сервер для умного дома: она компактная, тихая и недорогая. Тема «Home Assistant на ТВ-приставке» поэтому очень популярна. В статье честно разберём, что реально можно сделать: какие приставки подходят, как поставить Home Assistant на TV Box через Armbian и Docker, где подстерегают риски и когда лучше выбрать другое железо. Вы получите последовательность действий, список проверок и разбор типичных ошибок, но сразу предупредим: это неофициальный путь, и результат зависит от конкретной модели и ревизии платы.

Важно: Home Assistant не поддерживает ТВ-приставки как платформу. Официальных образов Home Assistant OS и инструкций для конкретных моделей приставок нет. Всё описанное ниже — решения энтузиастов и сборки сообщества. Вы действуете на свой риск: возможны нестабильная работа, потеря данных, а при неосторожной записи во встроенную память приставка может превратиться в «кирпич».

1Кратко

• Сервер Home Assistant на Android не запускается: приставке нужен Linux. Практичный путь — сборка Armbian от сообщества на карте или флешке и Home Assistant Container в Docker.
• Многие инструкции в сети предлагают Supervised с обходом проверки системы; этот способ объявлен устаревшим, а ошибки «Unsupported system» в Container не возникают.
• Ищите приставку с 4 ГБ памяти, 32 ГБ и более встроенной памяти, гигабитным Ethernet и 64-битным чипом; всё, что слабее, годится лишь для экспериментов.
• Загружайтесь с карты и не пишите во встроенную память, пока система не проработала стабильно, а оригинальная прошивка не сохранена.
• Для надёжного круглосуточного сервера лучше Raspberry Pi или мини-ПК; приставка — эксперимент и запасной вариант.

2Можно ли установить Home Assistant на ТВ-приставку

Короткий ответ: можно, но не напрямую. Приставки обычно поставляются с Android, часто с урезанной версией для телевизоров. Home Assistant как сервер на Android не запускается; приложение Home Assistant для Android — лишь клиент, подключающийся к уже работающему серверу. Чтобы использовать приставку как сервер, на неё нужно поставить Linux. Для многих моделей на чипах Amlogic (например, серии S905) и Rockchip (например, RK3318) энтузиасты выпускают сборки Armbian, которые загружаются с карты памяти или флешки, не затрагивая родную прошивку.

После установки Linux есть три практических пути:

• Home Assistant Container в Docker — оптимальный вариант для приставок. Он официально поддерживается и не требует Supervisor. Его мы и ставим ниже.
• Supervised на Debian или Armbian. В 2025 году этот способ объявлен устаревшим, поэтому новый сервер на нём лучше не строить. Именно с ним связаны популярные в сети ошибки «Unsupported system» (версия CGroup и операционная система) и приёмы вроде переменной BYPASS_OS_CHECK: это обход проверки, а не правильная настройка.
• Неофициальные образы Home Assistant OS под отдельные приставки. Мы их не разбираем: поддержки у них нет, качество и актуальность разные, а проверить совместимость с вашей ревизией платы заранее трудно.

3Какие приставки подходят и что смотреть перед покупкой

Универсального списка совместимых моделей нет: два экземпляра с одним названием могут иметь разные чипы памяти, Wi-Fi и контроллеры. Ориентируйтесь на процессор и характеристики платы.

Характеристика	Желательно	Почему важно
Процессор	Amlogic серий S905X3, S905X4 и аналоги, у которых есть сборки Armbian; Rockchip RK3318/RK3328 тоже встречаются	без сборки под ваш чип загрузить Linux не получится
Оперативная память	4 ГБ; 2 ГБ — минимум для простой конфигурации	Home Assistant и дополнительные контейнеры потребляют память
Встроенная память	32 ГБ и больше либо внешний SSD	на ней живут система и база данных
Сеть	гигабитный Ethernet	Wi-Fi в Armbian работает не у всех моделей, часть приставок имеет порт 100 Мбит
USB	порты USB 2.0 и USB 3.0	для Zigbee-стика и накопителя; при загрузке с накопителя бывает важен именно порт USB 2.0
Охлаждение	металлический корпус или место под радиатор	пластиковые корпуса сильно греются

Среди популярных у энтузиастов приставок называют Vontar X3 и H96 Max X3 на чипе Amlogic S905X3, а также модели на Rockchip RK3318. Это примеры для ориентира, а не гарантия: проверяйте точную ревизию платы. Про приставки на RK3318 встречаются сообщения о нестабильной eMMC и проблемах с токами, поэтому для постоянной работы такой вариант нельзя считать надёжным.

4Стоит ли это делать: честная оценка

Плюсы	Минусы и риски
Низкая стоимость, если приставка уже лежит без дела	Неофициальная платформа: нет гарантий работы и поддержки
Малые размеры и энергопотребление	Ревизии одной модели нередко отличаются «железом» (память, Wi-Fi-чип, контроллер), и сборка может не подойти
Armbian загружается с карты, родная прошивка остаётся нетронутой	Нестабильное питание, перегрев, дешёвая память eMMC и слабая сеть
Подходит для знакомства с Linux и Docker	Обновления ядра и загрузчика ложатся на сообщество и на вас

Если нужна надёжность на годы, выбирайте Raspberry Pi, мини-ПК или другое железо с официальной поддержкой.

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

• Приставка на процессоре, для которого есть сборка Armbian. Точную модель SoC и версию платы проверьте по надписям на плате, в описании производителя или программой-определителем железа в Android.
• Карта microSD или USB-флешка/SSD хорошего качества, не менее 16–32 ГБ. Для постоянной работы лучше внешний SSD, а не карта.
• Компьютер для записи образа и программа записи: Balena Etcher или Raspberry Pi Imager в режиме пользовательского образа.
• Кабель Ethernet. Wi-Fi-чипы приставок часто не поддерживаются в Armbian или работают нестабильно.
• Нормальный блок питания. Слабое питание — частая причина сбоев.
• Доступ в интернет с приставки и, при необходимости, VPN или зеркала для скачивания образов, пакетов и контейнеров.
• Скрепка для кнопки загрузки в отверстии корпуса (на многих моделях вход в загрузку с карты выполняется через неё) и монитор или ТВ с HDMI для первых запусков.

6Шаг 1. Определите модель и найдите подходящую сборку

Это самый ответственный этап. Для приставок на Amlogic сообщество поддерживает сборки Armbian, в том числе универсальные для множества моделей. В каждой сборке используется файл описания оборудования — dtb, и от правильного выбора зависит, заработают ли сеть, USB и память. Для аналогов одного чипа нужный dtb может отличаться, а в некоторых случаях рекомендуют файл от родственной платы, например Odroid C4 для S905X3.

1. Выясните процессор приставки (S905X3, S905W, S912, RK3318 и т. п.) и желательно версию платы.
2. Найдите страницу сборки Armbian для вашего семейства чипов и список совместимых моделей. Читайте обсуждения: там обычно указано, какой dtb подходит к конкретной приставке.
3. Скачайте образ и проверьте контрольную сумму, если она опубликована. Не берите сборки из случайных источников: образ получает полный доступ к вашему оборудованию и сети.

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

7Шаг 2. Подготовьтесь к отступлению

• Не записывайте ничего во внутреннюю память (eMMC), пока не убедились, что система стабильно работает с карты. Загрузка с microSD или USB оставляет Android нетронутым.
• Если позже решите переносить Linux на eMMC, заранее найдите оригинальную прошивку модели и способ её восстановления. Без неё откат может оказаться невозможным.
• Запишите, как включается режим загрузки с внешнего накопителя на вашей модели.

8Шаг 3. Запишите образ Armbian на карту

1. Распакуйте скачанный архив, если образ упакован.
2. Откройте программу записи, выберите файл образа и целевую карту. Убедитесь, что выбрано нужное устройство: данные на нём будут стёрты.
3. Запишите образ и дождитесь проверки.

Выберите файл описания оборудования (dtb)

Во многих сборках для Amlogic после записи образа на разделе загрузки нужно указать, какой dtb использовать. Механизм зависит от сборки: в одних вы правите строку FDT в extlinux/extlinux.conf, в других — переменные в uEnv.txt, в третьих копируете нужный файл под определённым именем. Следуйте инструкции к вашей сборке, общего правила нет. Ошибка в dtb проявляется тем, что приставка не загружается, не поднимает сеть или не видит USB.

9Шаг 4. Загрузите приставку с карты

1. Выключите приставку и отключите питание.
2. Вставьте карту или накопитель, подключите Ethernet и HDMI.
3. В зависимости от модели: зажмите скрепкой кнопку в отверстии AV-разъёма или корпуса, подайте питание и держите несколько секунд; либо воспользуйтесь функцией загрузки с внешнего накопителя в Android-прошивке (если она есть); либо загрузка с карты запускается автоматически. Способ различается между моделями и сборками.
4. Дождитесь загрузки Armbian. При первом запуске система создаёт разделы, ключи SSH и может перезагрузиться.

Если приставка снова загружает Android, режим загрузки с карты не включился: повторите процедуру или проверьте инструкцию сборки. Если зависла на логотипе, попробуйте другой порт USB (лучше USB 2.0), другую карту и другой dtb.

10Шаг 5. Первый вход и базовая настройка Armbian

Найдите IP-адрес приставки в списке клиентов роутера и подключитесь по SSH:

ssh root@192.168.1.80

В актуальных образах Armbian при первом входе система просит сменить пароль, создать обычного пользователя, выбрать язык и часовой пояс. Начальные значения и порядок вопросов уточняйте в документации к вашей сборке, а любой пароль по умолчанию меняйте сразу. Затем обновите систему:

sudo apt update
sudo apt upgrade -y

Часовой пояс, имя хоста и сетевые параметры можно настроить утилитой armbian-config, если она есть в вашей сборке. Закрепите за приставкой постоянный IP-адрес в роутере по MAC-адресу.

Проверьте температуру и стабильность

Дайте приставке поработать несколько часов и проверьте температуру процессора (в Linux она доступна через /sys/class/thermal). Корпуса многих приставок греются; если температура стабильно высокая, поставьте радиатор или обеспечьте приток воздуха.

cat /sys/class/thermal/thermal_zone0/temp

Значение выводится в тысячных долях градуса Цельсия: число 55000 означает 55 градусов.

11Шаг 6. Установите Docker

Armbian построен на Debian или Ubuntu, поэтому Docker ставится по официальной инструкции для вашего дистрибутива либо установочным скриптом проекта:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Прежде чем запускать любой скрипт, откройте и прочитайте его. После установки проверьте:

sudo docker run --rm hello-world
docker compose version

Если загрузка с серверов Docker недоступна из вашей сети, может потребоваться VPN или зеркало реестра. Для Home Assistant требуется Docker Engine версии 23.0.0 или новее, свежий скрипт ставит подходящую.

12Шаг 7. Запустите Home Assistant Container

Создайте каталог и файл Compose. Минимальная конфигурация:

sudo mkdir -p /opt/homeassistant/config
sudo nano /opt/homeassistant/compose.yaml

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /opt/homeassistant/config:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    stop_grace_period: 60s
    privileged: true
    network_mode: host
    environment:
      TZ: Europe/Moscow

Параметры:

• network_mode: host нужен для автообнаружения устройств; публиковать порты при этом не нужно.
• privileged: true нужен для доступа к оборудованию, например Bluetooth.
• каталог /opt/homeassistant/config хранит всю конфигурацию и базу, его вы будете копировать при резервном копировании.

Запуск:

cd /opt/homeassistant
sudo docker compose up -d

Образ Home Assistant публикуется для ARM 64-бит (aarch64), поэтому на 64-битном Armbian он запустится. Подождите несколько минут (на слабом железе первый запуск дольше) и откройте:

http://192.168.1.80:8123

Подставьте адрес своей приставки. Порт — 8123. Откроется мастер: создайте пользователя, укажите название дома, расположение и часовой пояс.

13Шаг 8. Подключите Zigbee-стик и другие устройства

Вставьте Zigbee-координатор в USB-порт приставки (лучше через короткий удлинитель, подальше от USB 3.0 и Wi-Fi) и найдите стабильный путь:

ls -l /dev/serial/by-id/

Затем пробросьте устройство в контейнер через раздел devices в файле Compose и примените изменения командой sudo docker compose up -d. USB-контроллеры в приставках бывают капризными, а питание порта слабым: если стик отваливается, подключите его через активный USB-хаб с внешним питанием. Встроенный Bluetooth приставки в Armbian работает не всегда, надёжнее внешний USB-адаптер.

14Перенос системы на eMMC или SSD

Загрузка с карты хороша для проверки, но карта изнашивается от записи базы. Постоянная схема — один из трёх вариантов.

Схема	Плюсы	Минусы
Система на microSD	Android остаётся нетронутым, легко откатить	карта быстро изнашивается
Система на eMMC	быстрее карты, не занимает порты	риск потерять оригинальную прошивку, ограниченный ресурс записи
Загрузка с карты или eMMC, система на USB SSD	лучший ресурс и скорость, Android можно не трогать	нужен накопитель и порт, питание SSD

Перенос выполняют встроенными средствами Armbian: в сборках для Amlogic это обычно утилита armbian-install, в других — nand-sata-install; набор пунктов зависит от сборки. Перед записью во внутреннюю память сохраните оригинальную прошивку и прочитайте документацию вашей сборки. Если не уверены, оставайтесь на схеме с SSD.

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

Симптом	Вероятная причина	Что сделать
Приставка грузит Android, а не карту	не включён режим загрузки с внешнего носителя	повторить процедуру со скрепкой или проверить инструкцию сборки
Зависание на логотипе	неверный dtb, не тот образ, несовместимая карта	выбрать другой dtb, перезаписать образ, сменить карту и порт USB
Нет сети	неверный dtb, нет драйвера Wi-Fi	использовать Ethernet, проверить dtb
Перезагрузки и зависания	питание, перегрев, медленная карта	заменить блок питания, добавить радиатор, перейти на SSD
Контейнер не стартует по архитектуре	32-битная система	проверить uname -m и перейти на 64-битную сборку
Ошибка «Unsupported system» в Supervised	версия cgroup или ОС не из списка	для нового сервера перейти на Container, а не обходить проверку

Приставка не загружается с карты

• Проверьте, что образ предназначен для вашего чипа и записан без ошибок.
• Попробуйте другую карту или флешку: не все накопители видны загрузчику.
• Проверьте выбор dtb и попробуйте другой из рекомендованных для модели.
• Убедитесь, что вы правильно входите в режим загрузки с внешнего носителя.

Home Assistant долго запускается

Слабые приставки с 1–2 ГБ памяти тяжело справляются с большими интеграциями. Отключите лишние, не запускайте тяжёлые сервисы (видеонаблюдение с распознаванием) и ограничьте срок хранения истории параметром purge_keep_days в настройках recorder.

Контейнер не стартует по ошибке архитектуры

Проверьте разрядность командой uname -m: для штатного образа нужен результат aarch64. Если вы видите armv7l, система 32-битная, и лучше перейти на 64-битную сборку.

16Резервные копии и эксплуатация

Платформа неофициальная, поэтому резервные копии особенно важны. Регулярно копируйте каталог /opt/homeassistant/config на другой компьютер или сетевое хранилище. Если приставка выйдет из строя, вы поднимете Home Assistant на другом железе: достаточно перенести каталог конфигурации и запустить тот же контейнер. Образ обновляется командами docker compose pull и docker compose up -d. Обновления системы Armbian выполняйте осторожно, особенно ядра и загрузчика: после них приставка может перестать загружаться.

17Альтернативы приставке

Прежде чем тратить вечера на подбор dtb и сборок, оцените другие варианты.

Вариант	Официальная поддержка	Особенности
Raspberry Pi 4 или 5	да	готовый образ HAOS, установка за час
Мини-ПК или старый ноутбук	да	предсказуемо, запас производительности
Виртуальная машина на NAS или сервере	да	если вы уже работаете с виртуализацией
ТВ-приставка с Armbian	нет	дёшево, но с риском и ручной настройкой

Отдельно о частом заблуждении: поставить Home Assistant прямо на Android-приставку нельзя. Но на самой приставке можно запустить официальное приложение Home Assistant или открыть панель управления в браузере, получив настенный экран для управления домом. Сервер при этом работает на другом устройстве. Это самый простой способ применить ненужную приставку без риска для прошивки.

18Когда остановиться

Если вы потратили несколько часов и приставка так и не загрузилась с карты, не продолжайте вслепую: ищите точную ревизию платы, читайте обсуждения вашей модели и не пробуйте прошивать загрузчик или внутреннюю память без оригинального образа и понимания процедуры восстановления. Лучше вернуть приставку на штатную систему и выбрать поддерживаемое оборудование, чем получить нерабочее устройство.

19Итог

Home Assistant на ТВ-приставке — рабочий, но неофициальный путь. Надёжнее всего поставить на приставку Armbian из сборки сообщества с загрузкой с карты или SSD, а Home Assistant запустить в контейнере Docker, не прибегая к устаревшему Supervised. Не трогайте встроенную память без плана восстановления, используйте проводную сеть и хорошее питание, выбирайте dtb строго для своей модели и регулярно копируйте каталог конфигурации. Если нужен спокойный круглосуточный сервер без экспериментов, берите Raspberry Pi или мини-ПК.