Home Assistant на Android: установка и подключение к серверу

Home Assistant Companion устанавливается из Google Play и после ввода URL сервера и авторизации телефон сразу становится «устройством» в HA — передаёт геолокацию, состояние сенсоров и получает push‑уведомления. Ниже — понятная пошаговая инструкция и практические настройки.

Что такое Home Assistant Companion

Home Assistant Companion — официальное Android‑приложение для интеграции смартфона в экосистему Home Assistant. Оно:

• превращает телефон в источник данных (местоположение, заряд батареи, шаги, Bluetooth);
• позволяет получать и управлять push‑уведомлениями и виджетами;
• даёт локальный и (при настройке) удалённый доступ к серверу HA.

Приложение работает с Android 8.0+, поддерживает актуальные функции Android 16 (точная геолокация, фоновые разрешения).

Установка: шаги

1. Откройте Google Play и найдите «Home Assistant» (Companion). Установите приложение (~20 МБ).
2. Запустите приложение. При первом запуске выберите «Ввод URL» и введите адрес вашего сервера (например, http://homeassistant.local:8123 или https://your-domain).
3. При запросе разрешений дайте:
   • Точное местоположение — для геотрекинга зон.
   • Разрешение на отправку уведомлений — для push‑уведомлений.
   • Разрешение на фоновые операции/автозапуск (Android 16) — для надёжной работы в фоне.
4. Если сервер использует самоподписанный сертификат, используйте опцию установки сертификата или временно включите HTTP для первого соединения, затем переключитесь на HTTPS.

Совет: если сервер недоступен по имени, используйте локальный IP (например, 192.168.1.50:8123) для отладки.

Подключение к серверу и основные настройки

1. Авторизация: в приложении откроется экран авторизации HA в браузерном WebView. Введите учётные данные HA и подтвердите.
2. Долгоживущий токен: для ручной интеграции создайте токен в HA: Настройки → Профиль → Долгоживущие токены. Обычно не обязателен, но полезен для скриптов и внешних интеграций.
3. Устройство в HA: после входа телефон появится в разделе «Устройства» как Companion App и начнёт отправлять сенсоры.
4. Полезные настройки в приложении:
   • Геолокация: включите «Точное местоположение» и настройте частоту обновлений по батарее/точности.
   • Сенсоры: активируйте дополнительные датчики (шаги, освещённость) если нужны автоматизации.
   • Уведомления: настройте каналы уведомлений на Android для разных приоритетов.
   • Виджеты: добавьте виджет HA на рабочий стол для быстрого доступа к скриптам/сценам.
5. Удалённый доступ: для безопасного удалённого доступа используйте Nabu Casa или настроьте HTTPS + проброс портов/реверс прокси. Никогда не открывайте HTTP без шифрования в Интернет.

Примеры автоматизаций на основе телефона

• При возвращении в зону «Дом» включать свет: триггер — переход в зону, действие — включить группу света.
• Если заряд батареи телефона <20% — отправить уведомление и отключить ненужные энергозатратные устройства.
• NFC‑тег + Tasker: сканирование тега запускает сценарий открытия двери или включает ночной режим.

Частые ошибки

• «Сервер недоступен»: проверьте локальный IP, firewall, правильность порта (8123) и работоспособность HA.
• Нет геолокации: включите «Точное местоположение» в Android и разрешите доступ в фоне.
• Уведомления не приходят: разрешите автозапуск и фоновую работу для приложения; проверьте каналы уведомлений Android.
• Проблемы с HTTPS: убедитесь, что сертификат корректен, или установите доверенный сертификат на сервер.

FAQ

• Нужно ли создавать токен в приложении? Токен обычно не нужен для обычной авторизации через UI, но полезен для API‑доступа и интеграций.
• Можно ли использовать несколько телефонов? Да — каждый телефон появляется отдельным устройством в HA; создавайте зоны и правила для членов семьи.
• Как снизить расход батареи от трекинга? Настройте реже обновления геолокации или переключитесь на менее точный режим для экономии энергии.

Начните с установки и базового подключения — за 20–40 минут вы получите полный контроль над устройствами и сможете создать первые полезные автоматизации.