Home Assistant Cloud от Nabu Casa дает ссылку для удаленного доступа к Home Assistant. Для подключения войдите в аккаунт и включите Remote access в настройках Cloud.
Что понадобится
Для основного пути хватит работающего Home Assistant, подключения к нему из домашней сети и аккаунта Cloud.
- Подписка Home Assistant Cloud платная и необязательная - по документации Home Assistant полностью работает и без нее.
- Свой домен поверх Cloud требует домена во владении и Home Assistant 2023.9.0 или новее (условия Nabu Casa).
Подключение через Nabu Casa
Cloud сам готовит сертификат для удаленного подключения. Его туннель работает без настройки обратного прокси - промежуточного сервера, который принимает внешний трафик и передает его Home Assistant.
Шаг 1. Вход в аккаунт
Откройте раздел Настройки → Home Assistant Cloud (Settings > Home Assistant Cloud). С существующим аккаунтом просто выполните вход. Для нового аккаунта нажмите Start your free 1 month trial, заполните Email address и Password, затем подтвердите кнопкой Start trial.
Шаг 2. Включение Remote access
Находясь в домашней сети, снова откройте Настройки → Home Assistant Cloud (Settings > Home Assistant Cloud), убедитесь, что вход выполнен, и включите переключатель Remote access. Дождитесь, пока облако подготовит сертификат, и сохраните показанный адрес - это ссылка для входа извне.
Адреса для доступа
Задайте внешний и внутренний адреса в сетевых настройках или в YAML.
Шаг 3. Внешний адрес
Откройте Настройки → Система → Сеть (Settings > System > Network). В блоке Home Assistant URL выберите вариант Internet и впишите уже настроенный внешний URL, либо включите Use Home Assistant Cloud - адрес Nabu Casa подставится автоматически. Нажмите Save.
Шаг 4. Внутренний адрес
В файле configuration.yaml внутри блока homeassistant: задайте internal_url - адрес из локальной сети, например http://192.168.0.10:8123. Здесь же описывается external_url для доступа из интернета.
В обоих значениях допускаются только протокол, имя хоста и порт, путь в URL указывать нельзя. Некоторые настройки из configuration.yaml отображаются в интерфейсе серым; чтобы редактировать их там, удалите соответствующие записи из YAML.
HTTPS и обратный прокси
Для прямого TLS (шифрования соединения) укажите пути к сертификату и ключу, а для обратного прокси настройте доверие к нему.
Шаг 5. HTTP-сервер
В Настройки → Система → Сеть (Settings > System > Network) откройте HTTP server и проверьте фактическое значение Server port вместо предположений.
| Тип установки | Порт |
|---|---|
| Новая установка Home Assistant OS (HAOS), с версии 2026.8 | 80 |
| HAOS, установленный до 2026.8 | прежний порт, обычно 8123 |
| Остальные типы установки | 8123 |
Для прямого TLS укажите в SSL certificate path и SSL key path абсолютные пути к сертификату и закрытому ключу, например /ssl/fullchain.pem и /ssl/privkey.pem.
Для классического обратного прокси включите Trust X-Forwarded-For и добавьте в Trusted proxies IP-адрес прокси или его сеть в формате CIDR (записи диапазона IP-адресов); укажите именно адрес сети. Без этого запросы блокируются.
Сохранение настроек HTTP-сервера перезапускает Home Assistant. Администратор должен подтвердить изменения в течение 5 минут, иначе настройки откатятся к прежним.
До версии 2026.8 эти параметры жили в блоке http: файла configuration.yaml. После обновления блок импортируется в интерфейс, а в разделе Settings > System > Repairs появляется уведомление. Проверьте импортированные значения в сетевых настройках, при запросе подтвердите их, удалите старый блок и перезапустите Home Assistant - уведомление пропадает, когда блока http: больше нет. Подробности - в документации интеграции HTTP.
Другие способы
Для самостоятельного доступа используйте проброс порта с шифрованием или VPN - защищенное сетевое соединение. В Cloud можно подключить свой поддомен и разрешить включение доступа со страницы аккаунта.
Свой поддомен на Cloud
В аккаунте Nabu Casa откройте Services, выберите Custom domain, введите имя поддомена и нажмите Next. У DNS-провайдера создайте обе записи CNAME (псевдонимы доменного имени) с точными значениями Name и Value из интерфейса. Нажимайте Check DNS, пока обе записи не пройдут проверку, затем нажмите Save и перезапустите Home Assistant, чтобы начал работать обновленный сертификат. Для Cloudflare обе записи должны быть в режиме DNS only, а некорректный DNSSEC (защита записей DNS) может мешать проверке.
Проброс порта
Пробросьте на роутере порт на настроенный Server port Home Assistant и обязательно зашифруйте трафик - сам по себе открытый порт небезопасен. При динамическом публичном IP помогает динамический DNS, например DuckDNS. Проверьте, не выдает ли провайдер адрес через CG-NAT (общий внешний адрес для многих абонентов) вместо выделенного IP. Подробности - в документации об удаленном доступе.
VPN
Tailscale или ZeroTier One создают защищенный канал до домашней сети. Сначала установите VPN-соединение, затем открывайте Home Assistant; без поднятого канала датчики приложения Companion обновляться не будут.
Включение доступа со страницы аккаунта
На странице аккаунта Nabu Casa кнопка Open Home Assistant подключает удаленный доступ - при условии, что заранее включен переключатель Allow external activation of remote access. Рядом отображается Remote address, ссылка для входа. Из автоматизаций то же делают службы cloud.remote_connect и cloud.remote_disconnect.
Старая статья про DuckDNS
Официальная статья 2017 года описывает автоматическую выдачу и продление сертификатов Let’s Encrypt через проверку DNS-01 по записи домена с опцией accept_terms, установленной в true. Ее YAML-пример с ключами http:, ssl_certificate и ssl_key устарел - сейчас настройки HTTP-сервера задаются в интерфейсе сетевых настроек. Выдача сертификата и доступность сервера из интернета остаются разными задачами.
Частые проблемы
Выберите строку по симптому или тексту ошибки. У пользователей форума помогали перечисленные решения; число веток относится к проблеме, а не к подтверждениям каждого решения.
| Симптом | Что помогало пользователям | Ветки |
|---|---|---|
Обратный прокси не проходит проверку доверия - Received X-Forwarded-For header from an untrusted proxy 127.0.0.1 | Указать правильный доверенный прокси. Дать прокси статический IP в отдельной Docker-сети и доверять этому адресу. До 2026.8 настройки передачи заголовков и доверенных прокси задавали в configuration.yaml с перезапуском; теперь используйте HTTP server. | 4 |
Приложение Companion не подключается по Nabu Casa - Unable to retrieve external auth | Включить Use Home Assistant Cloud в настройках сервера приложения - у пользователя приложение заработало, но виджеты продолжили сбоить. Другой вариант - отключить переключатель Cloud и ввести URL Home Assistant Cloud вручную. Также помогали обновление Home Assistant с возвратом локального URL и включением Use Home Assistant Cloud либо сброс приложения Android и настройка заново вне домашней сети. | 2 |
| Companion подставляет неподходящий внутренний или внешний адрес | Обновить внутренний URL приложения. Указать Internal URL как IP:8123. Ввести полное доменное имя вручную. Также помогала правка доверенных прокси с повторным заданием локального и публичного адресов; вместо прежнего configuration.yaml настройки прокси теперь находятся в HTTP server. | 4 |
Статус Cloud расходится с фактическим доступом или обновлением датчиков - Failed to Send | Выйти из Nabu Casa, полностью перезагрузить Home Assistant и войти снова. Отключить и заново включить удаленный доступ для повторной попытки подготовки сертификата. Либо перезапустить Home Assistant. | 3 |
Home Assistant уходит в режим восстановления после настройки SSL - Recovery Mode Activated. | Использовать пути к сертификатам внутри /config и перезапустить браузер. Подробный разбор - режим восстановления после настройки SSL. | 2 |
Прокси не находит Home Assistant по настроенному адресу - Unable to connect. Retrying | Указать в forward hostname (адресе Home Assistant для прокси) IP-адрес Home Assistant. Обновить IP-адрес в конфигурации прокси. | 2 |
Локальный доступ ломается после настройки внешнего HTTPS-адреса - Invalid local network URL - You have configured an HTTPS certificate in Home Assistant. This means that your internal URL needs to be set to a domain covered by the certificate. | Поставить AdGuard Home, переписывать домен DuckDNS на IP Home Assistant, настроить DNS роутера и пользоваться только внешним URL. | 3 |
Прокси ломает загрузку интерфейса и приложений (apps, прежнее название - аддоны) - Failed to get a0d7b954_grafana logs, Failed to fetch | Настроить в nginx location для websocket (постоянного двустороннего соединения) и заголовки прокси. Либо заменить самодельный NGINX на стандартную конфигурацию. | 5 |
Частые вопросы
Почему в настройках нет пункта Home Assistant Cloud?
Раздел может отсутствовать после удаления default_config. В этом случае добавьте cloud: в файл configuration.yaml, чтобы вернуть настройки облачной интеграции Home Assistant Cloud. При последующем входе в аккаунт учитывайте регистр символов в его имени - имя аккаунта Cloud чувствительно к регистру букв.
Где хранится закрытый ключ сертификата Cloud?
Закрытый ключ сертификата Cloud хранится только на вашей системе Home Assistant. Cloud шифрует трафик от конца до конца сертификатом Let’s Encrypt. При этом облачный сервис может блокировать удаленный доступ для небезопасных версий Home Assistant. Обновление до безопасной версии восстанавливает доступ; порядок обновления описан в отдельном гайде.
Работают ли через Cloud аддоны?
Да, через Cloud доступны приложения с поддержкой Ingress - механизма встроенного доступа к приложениям Home Assistant. При таком подключении они используют авторизацию и шифрование веб-интерфейса Home Assistant. В нынешних материалах Home Assistant эти приложения называются apps, а в прежних - аддонами.
