Мобильное приложение Home Assistant Companion не подключается к серверу при вводе внешнего адреса — самая частая жалоба новых пользователей, и в большинстве случаев причина кроется не в самом приложении, а в отсутствии настроенного удалённого доступа (HTTPS, DuckDNS, Nabu Casa или VPN). Прежде чем искать сбой, проверьте, открывается ли ваш сервер в браузере телефона по тому же адресу: если страница недоступна и там, проблема в сетевой части, а не в приложении.
Официальное приложение Home Assistant Companion доступно для Android и iOS и выполняет две задачи: даёт доступ к интерфейсу умного дома и превращает смартфон в источник данных — геопозицию, уровень заряда, состояние сети. Ниже разберём установку, подключение, настройку уведомлений и типичные ошибки.
Установка приложения на Android и iOS
Приложение распространяется через официальные магазины: Google Play для Android и App Store для iOS. Ищите его по названию «Home Assistant» — разработчик указан как Home Assistant (для Android также существует вариант установки через F-Droid, но сборка там может отличаться по набору функций, в частности по работе push-уведомлений).
Перед установкой убедитесь, что сервер Home Assistant уже развёрнут и доступен в локальной сети. Само приложение не является сервером — оно лишь клиент, поэтому без работающего экземпляра Home Assistant настроить его не получится.
- 📱 Проверьте, что телефон и сервер находятся в одной Wi-Fi сети при первичной настройке — это сильно упрощает обнаружение.
- 🔄 Обновите операционную систему смартфона, если приложение не устанавливается: старые версии Android и iOS могут не поддерживаться.
- 🌐 Убедитесь, что веб-интерфейс сервера открывается в браузере телефона по адресу вида
http://homeassistant.local:8123или по IP-адресу.
Первое подключение к серверу
При первом запуске приложение попытается автоматически найти сервер в локальной сети. Если обнаружение сработало, вы увидите название вашего экземпляра — достаточно выбрать его и авторизоваться под своей учётной записью Home Assistant. Если автопоиск не сработал, адрес можно ввести вручную.
Для ручного ввода используйте тот же URL, что и в браузере: для локального доступа это обычно http://192.168.x.x:8123 или http://homeassistant.local:8123. Обратите внимание на протокол: если вы настроили HTTPS, адрес должен начинаться с https://, иначе подключение завершится ошибкой.
☑️ Проверка перед первым подключением
⚠️ Внимание: не публикуйте сервер в интернет по открытому HTTP без шифрования. Если нужен доступ извне, настройте HTTPS через обратный прокси, используйте подписку Home Assistant Cloud (Nabu Casa) или подключайтесь через VPN (например, WireGuard или Tailscale). Это защитит ваши учётные данные и управление домом от перехвата.
Настройка удалённого доступа
Удалённый доступ — главный камень преткновения. В приложении можно задать два адреса: внутренний URL (для домашней сети) и внешний URL (для доступа из любой точки). Приложение само переключается между ними в зависимости от того, к какой сети подключён телефон.
Есть несколько рабочих способов организовать внешний доступ. Какой выбрать — зависит от вашего провайдера, роутера и готовности разбираться с сетевыми настройками.
| Способ | Сложность | Особенности |
|---|---|---|
| Home Assistant Cloud (Nabu Casa) | Минимальная | Платная подписка, настройка в пару кликов, поддерживает разработку проекта |
| DuckDNS + Let's Encrypt | Средняя | Бесплатно, требует проброса портов на роутере |
| VPN (WireGuard, Tailscale) | Средняя | Трафик идёт через зашифрованный туннель, порты открывать не нужно |
| Обратный прокси (Nginx, Caddy) | Высокая | Гибкая конфигурация, требует собственного домена |
После настройки внешнего доступа откройте в приложении раздел настроек сервера и впишите оба адреса. Проверить результат просто: отключите Wi-Fi на телефоне и попробуйте открыть интерфейс через мобильный интернет.
Push-уведомления на смартфон
Одна из ключевых функций приложения — уведомления от автоматизаций. Сервер отправляет их через сервис notify, имя которого формируется автоматически при регистрации устройства (обычно notify.mobile_app_имя_телефона).
Пример простого вызова уведомления из автоматизации или из инструментов разработчика:
service: notify.mobile_app_my_phone
data:
title: "Внимание"
message: "Датчик протечки сработал в ванной"
На Android и iOS уведомления поддерживают дополнительные параметры: кнопки действий, изображения, приоритет, звук. Набор возможностей зависит от платформы — точный перечень поддерживаемых полей смотрите в официальной документации Companion App, так как он меняется от версии к версии.
Датчики смартфона в Home Assistant
Приложение умеет передавать на сервер данные с телефона: местоположение, уровень заряда батареи, состояние Wi-Fi, шаги, режим «не беспокоить» и другие параметры. Включается это в настройках приложения, в разделе управления датчиками — каждый сенсор активируется отдельно.
Геопозиция особенно полезна для автоматизаций присутствия: включение отопления, когда вы едете домой, или проверка, что все ушли и можно ставить дом на охрану. Учтите, что точность и частота обновления координат зависят от настроек геолокации телефона и ограничений операционной системы на фоновую работу.
- 📍 Для отслеживания местоположения выдайте приложению разрешение на геолокацию «всегда», иначе обновления будут приходить только при открытом приложении.
- 🔋 Датчик батареи удобно использовать для напоминаний о зарядке телефона.
- 🚶 Часть датчиков (например, счётчик шагов) доступна не на всех устройствах — зависит от аппаратных возможностей.
⚠️ Внимание: постоянная передача геопозиции увеличивает расход заряда батареи. Если заметили быструю разрядку, настройте в приложении режим обновления местоположения — например, только при значительном перемещении, если такая опция предусмотрена вашей версией.
Почему геопозиция обновляется с задержкой
Операционные системы намеренно ограничивают фоновый доступ к GPS для экономии энергии. Android и iOS могут приостанавливать приложение, если оно долго не открывалось. Помогает отключение оптимизации батареи для приложения и выдача постоянного разрешения на геолокацию, но полностью мгновенных обновлений в фоне добиться не всегда возможно — это ограничение платформы, а не Home Assistant.
Типичные проблемы и их решение
Разберём ситуации, с которыми пользователи сталкиваются чаще всего. Начните диагностику с простого: откройте тот же адрес сервера в браузере телефона. Если и там ошибка — причина в сети или сервере, а не в приложении.
Приложение не находит сервер в локальной сети? Возможные причины: телефон подключён к гостевой Wi-Fi сети с изоляцией клиентов, mDNS заблокирован роутером, либо сервер слушает нестандартный порт. Решение — ввести адрес вручную в формате http://IP:8123.
Ошибка сертификата при подключении по HTTPS обычно означает, что сертификат самоподписанный или выписан на другой домен. Приложение требует валидный сертификат для внешнего HTTPS-доступа — с самоподписанным сертификатом подключение может не работать без дополнительных ухищрений. Проще всего использовать Let's Encrypt или Nabu Casa.
- 🔁 Очистите кэш приложения или переустановите его, если интерфейс зависает на экране загрузки после обновления сервера.
- 🔑 Проверьте, не истёк ли токен авторизации: выйдите из учётной записи в приложении и войдите заново.
- 📶 Убедитесь, что в настройках сервера приложения корректно указаны оба URL — внутренний и внешний.
Виджеты, быстрые действия и Wear OS
Помимо основного интерфейса, приложение предлагает дополнительные способы управления. На Android доступны виджеты рабочего стола для запуска сцен и быстрые действия по долгому нажатию на иконку. На iOS есть поддержка шорткатов и интеграция с Siri через приложение «Команды».
Для часов на Wear OS существует отдельное приложение-компаньон, позволяющее управлять устройствами с запястья. Набор функций зависит от версии — сверяйтесь с официальной документацией. Владельцам Apple Watch доступно отображение избранных действий через соответствующее приложение на часах.
Настраиваются быстрые действия в разделе приложения, посвящённом виджетам и ярлыкам: вы выбираете сцену, скрипт или устройство, и они появляются на рабочем столе телефона. Это удобно для сценариев вроде «выключить всё» или «открыть ворота» — без необходимости открывать полный интерфейс.
Часто задаваемые вопросы
Приложение Home Assistant платное?
Само приложение бесплатно и распространяется с открытым исходным кодом. Платной является опциональная подписка Home Assistant Cloud (Nabu Casa), которая упрощает удалённый доступ и интеграцию с голосовыми ассистентами, но без неё приложение полностью работоспособно.
Почему приложение не подключается через мобильный интернет?
Через мобильный интернет работает только внешний адрес. Проверьте, настроен ли у вас удалённый доступ (HTTPS, Nabu Casa или VPN) и указан ли внешний URL в настройках сервера внутри приложения. Локальный адрес вида 192.168.x.x вне домашней сети работать не будет.
Как отправить уведомление на конкретный телефон?
Каждый телефон при подключении регистрирует свой сервис уведомлений вида notify.mobile_app_имя_устройства. Используйте его в автоматизации, указав текст в параметре message. Точное имя сервиса можно посмотреть в разделе «Инструменты разработчика» → «Сервисы».
Почему быстро разряжается батарея после установки приложения?
Возможная причина — включённое постоянное отслеживание геопозиции с высокой частотой обновлений. Зайдите в настройки датчиков приложения и снизьте частоту обновления местоположения или отключите ненужные сенсоры.
Можно ли пользоваться приложением без сервера Home Assistant?
Нет. Приложение — это клиент, который подключается к существующему серверу Home Assistant. Сначала необходимо развернуть сервер (на Home Assistant OS, в Docker, на Raspberry Pi или другом устройстве), и только потом подключать к нему мобильное приложение.