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

1Что понадобится
- Установленный Home Assistant (HAOS, Container, Core или виртуальная машина) и включённый сервер.
- Компьютер или смартфон в той же локальной сети, что и сервер: подключённый к тому же роутеру по Wi-Fi или кабелю.
- Доступ к настройкам роутера, если потребуется найти IP-адрес сервера.
- Для первой настройки: терпение. Первый запуск может занять заметное время, так как система загружает и устанавливает компоненты.
2Главное: адрес и порт по умолчанию
Веб-интерфейс Home Assistant работает по порту 8123 по протоколу HTTP. Это порт Home Assistant по умолчанию. Поэтому типичные адреса выглядят так:
http://homeassistant.local:8123— адрес по имени, который работает в большинстве сетей благодаря службе mDNS;http://192.168.1.50:8123— адрес по IP (число подставьте своё; пример условный);http://имя-устройства:8123— иногда срабатывает по имени, если роутер умеет разрешать имена локальных устройств.
Обратите внимание на http, а не https: без дополнительной настройки шифрования соединение идёт по обычному HTTP. Если ввести https://, страница не откроется, и это одна из самых частых ошибок.

3Шаг 1. Откройте интерфейс по имени
- Убедитесь, что сервер включён и прошло достаточно времени после старта. На слабом железе первый запуск требует терпения: если страница не открывается сразу, подождите и обновите её.
- В адресной строке браузера введите
http://homeassistant.local:8123и нажмите Enter. - Если открылась страница создания учётной записи (первый вход) или форма входа, адрес правильный.
Имя homeassistant.local разрешается через mDNS (Bonjour/Avahi). В macOS, iOS и современных Linux оно работает почти всегда. В Windows поддержка бывает нестабильной, особенно в старых версиях системы и в сетях с изолированными сегментами. Если имя не находится, переходите к следующему шагу: это признак проблемы с именем, а не с самим сервером.
4Шаг 2. Найдите IP-адрес сервера
Когда имя не работает, нужен IP-адрес. Способов несколько.
Через роутер
- Откройте веб-интерфейс роутера (адрес обычно указан на наклейке на корпусе).
- Найдите список подключённых устройств: он называется «клиенты», «DHCP-аренды» или похоже (зависит от модели).
- Ищите устройство с именем
homeassistantлибо по производителю платы или компьютера. Если не уверены, выключите сервер на минуту и посмотрите, какой клиент исчез из списка. - Запишите IP-адрес и откройте
http://этот-адрес:8123.
Через консоль самого сервера
Если к серверу подключены монитор и клавиатура, на экране консоли HAOS сразу отображаются сведения об адресе. Там же доступны команды CLI. Адреса можно посмотреть командой:
ha network info
В выводе найдите IPv4-адрес сетевого интерфейса.
Через сканирование сети
Бесплатные сканеры сети для компьютера и смартфона показывают все устройства с адресами и именами. Это хороший вариант, когда доступ к роутеру ограничен. Используйте их только в своей сети.
5Шаг 3. Закрепите IP-адрес
Адрес, который выдал роутер автоматически, может измениться после перезагрузки. Это ломает закладки, мобильное приложение и интеграции. Поэтому его нужно зафиксировать.
- В роутере найдите раздел резервации адресов DHCP (называется «статические аренды», «привязка по MAC» и тому подобное).
- Привяжите MAC-адрес сервера к нужному IP.
- Перезагрузите сервер и убедитесь, что адрес остался прежним.
Альтернатива — задать статический адрес в самом Home Assistant: «Настройки», «Система», «Сеть» (в разных версиях путь может отличаться), либо командой CLI на HAOS. Но для большинства случаев проще и надёжнее резервация на роутере: меньше риск потерять доступ из-за опечатки.
6Шаг 4. Войдите в интерфейс
При первом входе вы увидите мастер начальной настройки. Он предложит создать учётную запись владельца: имя, логин и пароль. Запомните их или сохраните в менеджере паролей. Затем мастер спросит название дома, расположение, часовой пояс и единицы измерения. После этого система покажет обнаруженные устройства и предложит добавить их.
В следующие разы вы будете видеть обычную форму входа. Введите логин и пароль, поставьте галочку «Оставаться в системе», если вход выполняется с личного устройства. В мобильном приложении потребуется указать тот же адрес сервера: об этом подробнее в статье об удалённом доступе.
7Нюансы для разных способов установки
| Способ установки | Адрес по умолчанию | Что учесть |
|---|---|---|
| Home Assistant OS на физическом устройстве | http://homeassistant.local:8123 |
Нужен кабель или настроенный Wi-Fi, адрес лучше зарезервировать |
| Виртуальная машина | Тот же, но адрес зависит от режима сети | Для доступа из локальной сети используйте сетевой мост (bridge), а не NAT |
| Docker (Container) | http://IP-хоста:8123 |
Нужен проброс порта или режим сети host; имя homeassistant.local может не работать |
| Core в виртуальном окружении | http://IP-хоста:8123 |
Адрес — хоста, где запущена служба; следите за брандмауэром |
Для Docker типичная ошибка: порт не проброшен наружу. В режиме сети host Home Assistant сам слушает порт хоста. При использовании сети bridge нужно явно опубликовать порт 8123, и тогда он станет доступен на адресе хоста. Для виртуальных машин проверьте, что сетевой адаптер подключён в режиме моста, иначе устройство получит адрес из внутренней сети гипервизора, недоступный остальным.
8Как изменить порт
Менять порт обычно не нужно. Но если 8123 занят другой службой или хочется другой номер, это делается в файле конфигурации:
http:
server_port: 8123
Подставьте нужное значение вместо 8123. После изменения проверьте конфигурацию (в HAOS командой ha core check либо в «Инструменты разработчика», вкладка YAML) и перезапустите систему: ha core restart либо через интерфейс. Затем используйте новый адрес с новым портом.
Оговорка: в Home Assistant OS и при использовании Supervisor смена порта в конфигурации может приводить к сбоям во взаимодействии компонентов или не работать как ожидается, поэтому на HAOS её лучше не трогать. Для Docker проще оставить порт внутри контейнера прежним и поменять внешний через настройки публикации порта.
9Доступ через домен, прокси и HTTPS
Если вы планируете открывать интерфейс по доменному имени и через обратный прокси, потребуется дополнительная настройка. Без неё Home Assistant отвечает на запросы через прокси ошибкой «400: Bad Request».
http:
use_x_forwarded_for: true
trusted_proxies:
- 192.168.1.10
Вместо примера укажите IP-адрес вашего прокси. Дополнительно проверьте раздел «Настройки», «Система», «Сеть»: там задаются внутренний и внешний адреса Home Assistant. Эти значения используют интеграции и мобильное приложение. Полную схему удалённого доступа с HTTPS и VPN мы разбираем в статье об удалённом доступе к Home Assistant, не открывайте порт 8123 в интернет на роутере без защиты. Передавать пароль по голому HTTP через интернет небезопасно.
10Если вы забыли пароль
Для Home Assistant OS есть консольная команда сброса пароля пользователя. Синтаксис вида:
ha auth reset --username имя --password новый_пароль
Выполнять её нужно в консоли HAOS или через доступ по SSH (дополнение терминала). Формат аргументов проверьте командой ha auth reset --help, потому что он может отличаться в вашей версии. Не забудьте затем сменить пароль на постоянный в профиле пользователя.
11Типичные ошибки и решения
| Симптом | Причина | Решение |
|---|---|---|
| Страница не открывается сразу после установки | Первый запуск ещё идёт | Подождите и обновите страницу, проверьте индикаторы активности устройства |
| homeassistant.local не находится | Не работает mDNS в вашей системе или сети | Используйте IP-адрес сервера и порт 8123 |
| Браузер пишет, что соединение не защищено, или не открывается | Введён https вместо http | Используйте http://, если HTTPS не настраивали |
| Адрес был рабочим, а теперь нет | Роутер выдал другой IP | Найдите новый адрес в списке клиентов, зарезервируйте его |
| Docker: порт недоступен | Не опубликован порт 8123 или стоит брандмауэр | Проверьте режим сети контейнера, правила брандмауэра хоста |
| Виртуальная машина недоступна из сети | Сеть в режиме NAT | Переключить адаптер на мост (bridge) |
| 400: Bad Request при входе через прокси | Прокси не добавлен в доверенные | Настроить use_x_forwarded_for и trusted_proxies |
| Телефон и сервер в разных сетях | Гостевая сеть, разные подсети, изоляция клиентов | Подключить телефон к той же сети или отключить изоляцию клиентов в роутере |
| Нет доступа извне | Порт не открыт, нет белого IP | Использовать VPN или специальный сервис удалённого доступа |
12Как проверить доступность порта
Если интерфейс не открывается, проверьте, слушает ли сервер порт. С компьютера под Windows в PowerShell подойдёт команда:
Test-NetConnection 192.168.1.50 -Port 8123
Подставьте свой IP. Результат «TcpTestSucceeded: True» означает, что порт доступен и проблема в браузере, адресе или протоколе. Если «False», проверьте питание, кабель, адрес и брандмауэр. Для Linux и macOS аналогичную проверку делают через утилиту nc. Если сервер не отвечает даже на ping, ищите причину на уровне сети, а не Home Assistant.
13Мобильное приложение и доступ вне дома
Мобильное приложение Home Assistant при первом запуске ищет сервер в локальной сети автоматически. Если этого не произошло, введите адрес вручную в формате http://IP-адрес:8123. Помните, что телефон должен находиться в той же сети. Для доступа из мобильной сети понадобится внешний адрес и защищённое соединение. Внутренний и внешний адреса можно указать в настройках приложения и в разделе сетевых настроек самого Home Assistant. Приложение переключается между ними само, в зависимости от того, подключён ли телефон к домашней сети.
14Адрес в разных частях системы
Адрес Home Assistant встречается не только в браузере. Он нужен в мобильном приложении, в интеграциях с обратными адресами (например, для голосовых помощников), в настройках внешних сервисов и скриптах. Если вы часто меняете сервер или IP, это превращается в проблему, поэтому и рекомендуется закреплять IP-адрес или пользоваться локальным именем, а в настройках роутера создать для сервера постоянную запись.
Если в вашей сети работает собственный DNS-сервер или локальный резолвер, можно добавить запись вида ha.home.lan, которая указывает на адрес сервера, и пользоваться этим именем с портом 8123. Это надёжнее mDNS, так как не зависит от особенностей операционной системы клиента. Проверьте, что имя разрешается со всех устройств, с которых вы собираетесь входить.
15Безопасность входа
- Используйте длинный уникальный пароль и храните его в менеджере паролей.
- Включите двухфакторную аутентификацию в профиле пользователя, если она доступна в вашей версии.
- Не создавайте общих учётных записей: заведите отдельного пользователя каждому члену семьи.
- Не пробрасывайте порт 8123 на роутере напрямую в интернет. Для внешнего доступа используйте VPN или защищённый сервис с HTTPS.
- Следите за обновлениями: старые версии могут содержать уязвимости.
16Несколько пользователей
Добавлять пользователей можно в разделе «Настройки», «Люди» (в некоторых версиях пользователи вынесены в отдельную вкладку этого раздела). Учётная запись без прав администратора видит только интерфейс и не может менять настройки. Это удобно для домочадцев: они управляют светом, но не могут случайно удалить интеграцию. Права администратора давайте только тем, кто понимает последствия изменений.
17Проверка после смены адреса
Если вы заменили роутер, переехали в другую подсеть или перенесли Home Assistant на новое устройство, адрес мог измениться. Тогда пройдитесь по списку: откройте интерфейс по новому адресу, обновите адрес в мобильном приложении, проверьте внутренний и внешний URL в сетевых настройках, а также внешние сервисы и интеграции, где адрес прописан вручную. Если используется обратный прокси, обновите в нём адрес целевого сервера. Такой короткий чек-лист избавляет от долгих поисков причины, почему «всё вдруг перестало открываться».
18Что делать, если вход заблокирован
После нескольких неудачных попыток ввода пароля Home Assistant может временно блокировать адрес, с которого они поступали, и сообщать об этом в уведомлениях. Подождите некоторое время и повторите вход с правильными данными. Если вы входите через обратный прокси, проверьте, что настроена передача реального адреса клиента, иначе блокировка может срабатывать на адрес самого прокси и затрагивать всех пользователей. Если страница входа открывается, но после ввода данных возвращает на форму, очистите cookie для этого адреса или откройте интерфейс в окне инкогнито: так вы исключите проблему устаревшей сессии в браузере.
19Итог
Запомните главное: интерфейс Home Assistant открывается по адресу http://homeassistant.local:8123 или http://IP-адрес:8123. Порт по умолчанию 8123, протокол HTTP. Если имя не находится, возьмите IP-адрес в списке клиентов роутера и закрепите его резервацией. Для Docker и виртуальных машин проверьте режим сети, а при работе через прокси добавьте его в доверенные. Порт без нужды не меняйте, а наружу в интернет его без защиты не открывайте.
Вопросы и ответы
Какой порт у Home Assistant по умолчанию?
Веб-интерфейс работает на порту 8123 по протоколу HTTP. Типичный адрес: http://homeassistant.local:8123 или http://IP-адрес:8123.
Почему не открывается homeassistant.local?
Имя разрешается через mDNS, а он работает не во всех системах и сетях, особенно в Windows и сегментированных сетях. Найдите IP-адрес сервера в списке клиентов роутера и откройте его с портом 8123.
Как узнать IP-адрес Home Assistant?
Посмотрите список подключённых устройств в роутере, выполните команду ha network info в консоли HAOS или воспользуйтесь сканером сети. Затем зарезервируйте адрес, чтобы он не менялся.
Можно ли поменять порт Home Assistant?
Можно, задав server_port в разделе http файла конфигурации, но обычно это не требуется. На HAOS порт лучше не менять, а в Docker проще изменить внешний порт при публикации.
Почему вместо интерфейса появляется ошибка 400 при входе через прокси?
Home Assistant отклоняет запросы от прокси, которого нет в списке доверенных. Включите use_x_forwarded_for и укажите адрес прокси в trusted_proxies.



