Home Assistant App: полное руководство по установке и настройке

Приложение Home Assistant не открывает панель управления и показывает ошибку подключения к серверу — чаще всего причина в неверном адресе сервера, введённом при первом запуске, или в том, что телефон находится не в той сети, где работает сам сервер. Это первая вещь, которую нужно проверить: откройте настройки приложения и сверьте указанный URL с фактическим адресом вашего сервера.

Мобильное приложение Home Assistant Companion — официальный клиент экосистемы умного дома для Android и iOS. Оно не является самостоятельным сервером: приложение лишь подключается к уже работающему экземпляру Home Assistant, который развёрнут на домашнем сервере, мини-ПК, Raspberry Pi или другом устройстве. Понимание этого разделения — ключ к диагностике большинства проблем: если приложение «не работает», проблема почти всегда либо в сети, либо в самом сервере.

Что умеет приложение Home Assistant Companion

Клиент открывает веб-интерфейс сервера в удобной обёртке и добавляет функции, недоступные при доступе через обычный браузер. Через приложение вы управляете устройствами, просматриваете дашборды Lovelace, запускаете сценарии и автоматизации.

Кроме базового управления, приложение передаёт на сервер данные с телефона, если вы явно включили соответствующие датчики:

  • 📍 Геолокация — для автоматизаций прихода и ухода из дома;
  • 🔋 Уровень заряда батареи и состояние зарядки;
  • 📶 Состояние сети — Wi-Fi, мобильные данные, имя точки доступа;
  • 🔔 Push-уведомления от сервера через сервис уведомлений;
  • 🏃 Датчики активности — шаги, режим сна и другие, если поддерживаются устройством.
⚠️ Внимание: доступ к геолокации и датчикам телефона предоставляется только по вашему явному разрешению. Если автоматизация по геолокации не срабатывает, первым делом проверьте, не отозвала ли система разрешение на доступ к местоположению «в фоне» — мобильные ОС нередко делают это автоматически для экономии заряда.

Установка приложения на Android и iOS

Установка выполняется стандартно: на Android приложение доступно в Google Play, на iPhone — в App Store. Ищите его по названию Home Assistant — разработчик указан как Home Assistant (или Nabu Casa в зависимости от региона и версии). Перед установкой убедитесь, что скачиваете официальный клиент, а не стороннее приложение с похожим названием.

Перед первым запуском убедитесь, что сервер Home Assistant уже работает и доступен в вашей домашней сети. Проверить это просто: откройте браузер на компьютере, подключённом к той же сети, и перейдите по адресу сервера. Если веб-интерфейс открывается — сервер жив, и приложение сможет к нему подключиться.

Где взять сервер Home Assistant, если его ещё нет

Сервер устанавливается отдельно: на Raspberry Pi, мини-ПК, в виртуальной машине или Docker-контейнере. Официальный способ — Home Assistant OS, образ которого записывается на карту памяти или диск. Подробные инструкции по установке есть в официальной документации проекта — следуйте именно ей для вашей платформы, так как шаги различаются.

Первое подключение к серверу

При первом запуске приложение попытается автоматически найти сервер в локальной сети. Для этого телефон должен быть подключён к той же Wi-Fi сети, где работает сервер. Если обнаружение сработало, вы увидите найденный экземпляр и сможете выбрать его одним нажатием.

Если автопоиск не сработал, адрес вводится вручную. Типичный локальный адрес выглядит так:

http://homeassistant.local:8123

Вместо homeassistant.local может потребоваться прямой IP-адрес сервера, например http://192.168.1.50:8123 — его можно посмотреть в панели управления роутером в списке подключённых устройств. Порт 8123 используется по умолчанию, но если вы меняли его в конфигурации сервера, укажите свой.

☑️ Чек-лист первого подключения

Выполнено: 0 / 5

После указания адреса приложение попросит войти под учётной записью пользователя Home Assistant — той самой, что вы создавали при первоначальной настройке сервера. Затем потребуется назвать устройство: это имя будет использоваться в сервисах уведомлений, например notify.mobile_app_my_phone.

📊 Как вы в основном подключаетесь к Home Assistant с телефона?
Только из домашней Wi-Fi сети
Через Nabu Casa Cloud
Через VPN (WireGuard и др.)
Через внешний URL с пробросом портов

Настройка удалённого доступа

По умолчанию приложение работает только внутри домашней сети. Чтобы управлять домом из любой точки, нужен один из вариантов удалённого доступа. В настройках приложения можно задать два адреса: внутренний URL (для домашней сети) и внешний URL (для доступа извне). Приложение само переключается между ними, определяя, в какой сети находится телефон.

СпособСложностьОсобенности
Home Assistant Cloud (Nabu Casa)МинимальнаяПлатная подписка, настройка в пару кликов, поддерживает разработчиков проекта
VPN (WireGuard, Tailscale)СредняяТрафик идёт через зашифрованный туннель, сервер не виден из интернета
Проброс портов + HTTPSВысокаяТребует домена, сертификата и грамотной настройки безопасности
Обратный прокси (Nginx и др.)ВысокаяГибкая схема, но требует опыта администрирования
⚠️ Внимание: открывать порт 8123 в интернет без HTTPS и надёжной аутентификации небезопасно — панель управления вашим домом станет доступна посторонним. Если выбираете прямой доступ, обязательно настройте сертификат, сложные пароли и при возможности двухфакторную аутентификацию. Для большинства пользователей безопаснее облачная подписка или VPN.

Настройка уведомлений и датчиков

После подключения на сервере автоматически появляется интеграция Mobile App, а вместе с ней — сервис уведомлений для вашего телефона. Отправить тестовое уведомление можно через инструменты разработчика на сервере:

service: notify.mobile_app_имя_телефона

data:

message: "Тестовое уведомление"

Если уведомление не приходит — проверьте, не заблокированы ли уведомления приложения на уровне системы телефона, и не выгружает ли система приложение из памяти. На Android агрессивные режимы энергосбережения нередко «убивают» фоновые процессы, из-за чего push-уведомления задерживаются или теряются. Добавьте приложение в исключения оптимизации батареи.

Датчики телефона включаются в настройках приложения, в разделе управления сенсорами. Включайте только те, что реально используются в автоматизациях: каждый активный датчик отправляет обновления на сервер и немного увеличивает расход батареи. Частоту обновления геолокации тоже можно регулировать — более редкие обновления экономят заряд, но автоматизации прихода домой будут срабатывать с задержкой.

Типичные ошибки и их решение

Разберём симптомы, с которыми пользователи сталкиваются чаще всего, и порядок безопасной диагностики:

  • 🔌 «Не удаётся подключиться к серверу» — проверьте адрес и порт, убедитесь, что сервер запущен и открывается в браузере с того же телефона;
  • 🌐 Работает дома, но не работает вне дома — не настроен или неверно указан внешний URL, либо не работает выбранный способ удалённого доступа;
  • 🔕 Не приходят уведомления — проверьте системные разрешения, оптимизацию батареи и сам сервис notify через тестовое сообщение;
  • 📍 Не обновляется геолокация — нет разрешения на фоновый доступ к местоположению либо датчик отключён в настройках приложения;
  • 🔄 Приложение просит войти заново — возможно, истёк токен авторизации или менялся адрес сервера; обычно помогает повторный вход.

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

⚠️ Внимание: перед сбросом настроек приложения или его переустановкой убедитесь, что помните адрес сервера и данные учётной записи. После переустановки на сервере появится новая регистрация устройства, и старые сервисы уведомлений в автоматизациях придётся обновить вручную.

Виджеты и быстрые действия

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

На Android также доступны элементы управления в шторке быстрых настроек и интеграция с системным меню устройств, на iOS — виджеты и поддержка Siri Shortcuts для запуска сценариев голосом. Эти функции заметно ускоряют повседневное управление: включить свет или запустить сценарий «Ухожу из дома» можно в одно касание.

Часто задаваемые вопросы

Работает ли приложение Home Assistant без сервера?

Нет. Приложение — это клиент, который подключается к уже работающему серверу Home Assistant. Сервер нужно установить отдельно: на Raspberry Pi, мини-ПК, в Docker или виртуальной машине.

Почему приложение не находит сервер автоматически?

Чаще всего телефон подключён к другой сети (например, к мобильному интернету или гостевому Wi-Fi), либо автоматическое обнаружение блокируется настройками роутера. В этом случае введите адрес сервера вручную в формате http://IP-адрес:8123.

Как управлять домом вне домашней сети?

Настройте удалённый доступ: облачная подписка Home Assistant Cloud, VPN-туннель (например, WireGuard или Tailscale) или внешний HTTPS-доступ с доменом и сертификатом. Затем укажите внешний URL в настройках приложения.

Почему уведомления приходят с задержкой?

Наиболее вероятная причина — системное энергосбережение телефона, которое ограничивает фоновую работу приложения. Добавьте Home Assistant в исключения оптимизации батареи и проверьте, что уведомления разрешены на уровне системы.

Разряжает ли приложение аккумулятор телефона?

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