Ошибка AddonManager install blocked from execution - no host internet connection появляется в Home Assistant при попытке установить или обновить дополнение, когда система Supervisor не может подтвердить наличие интернет-соединения на хосте. Установка блокируется ещё до загрузки файлов, поэтому в журнале видно именно это сообщение, а не ошибку скачивания пакета.
Проблема почти всегда связана не с самим дополнением, а с сетевой конфигурацией сервера: недоступным DNS, неправильным шлюзом, блокировкой проверочного запроса Supervisor или особенностями виртуальной среды. Ниже разберём, как диагностировать причину и устранить её безопасными способами.
Что означает эта ошибка
Supervisor в Home Assistant OS и Supervised-установках периодически проверяет выход в интернет, прежде чем разрешить сетевые операции: установку дополнений, обновления, загрузку резервных копий в облако. Если проверка не проходит, Supervisor переводит себя в состояние «нет подключения» и блокирует выполнение установщика дополнений.
Важно понимать: сообщение говорит о связности хоста, а не контейнеров. Бывает, что интерфейс Home Assistant открывается из локальной сети и даже интеграции работают, но проверочный запрос Supervisor не проходит — например, из-за DNS или фильтрации на маршрутизаторе.
Типичные причины блокировки
Чтобы не перебирать всё подряд, начните с наиболее вероятных источников проблемы:
- 🌐 Нерабочий DNS на хосте — сервер не может разрешить доменные имена, хотя ping по IP-адресу проходит.
- 🚪 Неверный шлюз по умолчанию — характерно для ручной настройки статического IP.
- 🛡️ Фильтрация на роутере или файрволе — блокируются исходящие запросы сервера.
- 🐳 Проблемы сети Docker — актуально для Supervised-установок, где Supervisor работает в контейнере.
- 🔁 Зависший сетевой стек после смены конфигурации — помогает перезапуск Supervisor или хоста.
Если сервер недавно переезжал в другую подсеть, менялся роутер или включался VPN на уровне сети — начинайте проверку именно с этих изменений.
Диагностика сети хоста
Первый шаг — проверить, есть ли у сервера реальный выход в интернет. Для Home Assistant OS откройте терминал через дополнение Terminal & SSH (если оно уже установлено) или подключитесь к консоли устройства напрямую. Для Supervised-установки используйте обычный SSH-доступ к хосту.
Выполните базовые проверки:
ping -c 3 8.8.8.8
ping -c 3 github.com
Логика простая: если первый запрос проходит, а второй нет — проблема в DNS. Если не проходит ни один — проверяйте шлюз, кабель, Wi-Fi или настройки виртуального сетевого адаптера. Если проходят оба, но ошибка в Supervisor остаётся — вероятно, зависла сама проверка связности, и поможет перезапуск.
Посмотреть сетевые параметры хоста в Home Assistant OS можно командой:
ha network infoВ выводе обратите внимание на поля адреса, шлюза (gateway) и DNS-серверов. Пустые или явно неверные значения — прямое указание на источник проблемы.
Исправление DNS и сетевых настроек
Если диагностика показала проблему с DNS или адресацией, настройки можно поправить через CLI. Пример команды для смены DNS на интерфейсе (имя интерфейса смотрите в выводе ha network info):
ha network update eth0 --ipv4-nameserver 8.8.8.8После изменения параметров перезапустите Supervisor, чтобы он повторил проверку связности:
ha supervisor restartЗатем проверьте состояние командой ha supervisor info и повторите установку дополнения. Если установка запустилась — причина была именно в сетевой конфигурации хоста.
☑️ Проверка перед повторной установкой
⚠️ Внимание: командыha network updateменяют конфигурацию хоста. Перед изменениями запишите текущие значения изha network info, чтобы при необходимости вернуть их обратно. Точный синтаксис может отличаться в зависимости от версии — сверяйтесь с выводомha network update --help.
Особенности виртуальных машин и Docker
В виртуальных средах (Proxmox, VirtualBox, VMware) частая причина — режим сетевого адаптера. Если виртуальная машина работает за NAT и хост-система потеряла сеть, гостевая ОС тоже останется без интернета. Возможная проверка — временно переключить адаптер в режим моста (bridged) и посмотреть, получит ли машина адрес от роутера.
Для Supervised-установок дополнительный фактор — сеть Docker. Supervisor и дополнения работают в контейнерах, и если у Docker некорректно настроен DNS или сломан мост docker0, проверка связности будет падать. В этом случае проверьте, выходят ли в интернет обычные контейнеры, и изучите конфигурацию Docker-демона на хосте.
Почему интерфейс работает, а установка блокируется
Веб-интерфейс Home Assistant доступен из локальной сети и не требует интернета. Проверка Supervisor — отдельный исходящий запрос с хоста. Если он блокируется файрволом, DNS или маршрутизацией, вы увидите именно ошибку install blocked from execution, хотя локально всё выглядит рабочим.
Сравнение симптомов и причин
| Симптом | Вероятная причина | Что делать |
|---|---|---|
| Ping по IP есть, по имени нет | Нерабочий DNS | Сменить DNS через ha network update |
| Нет ping вообще | Шлюз, кабель, адаптер ВМ | Проверить сетевые настройки и режим адаптера |
| Сеть есть, ошибка остаётся | Зависшая проверка Supervisor | Перезапустить Supervisor или хост |
| Ошибка только в контейнерах | Сеть Docker | Проверить DNS и мосты Docker на хосте |
| Появилась после смены роутера | Новая подсеть или фильтрация | Сверить шлюз, DNS и правила файрвола |
Когда ничего не помогает
Если все проверки пройдены, а установка по-прежнему блокируется, действуйте последовательно. Сначала полностью перезагрузите хост (не только Supervisor) — это сбрасывает состояние сетевого стека и Docker. Затем сразу после загрузки проверьте журнал Supervisor: ha supervisor logs. Там видно, прошла ли проверка связности и какие ошибки сети фиксируются.
⚠️ Внимание: не спешите переустанавливать систему или править конфигурацию Docker вручную. Сначала зафиксируйте текущее состояние (выводha network info,ha supervisor infoи логи) — это поможет найти причину или получить точную помощь в сообществе Home Assistant.
Отдельный сценарий — работа сервера в сети с жёсткой фильтрацией или корпоративным прокси. В такой среде исходящие запросы могут разрешаться только через прокси, и стандартная проверка Supervisor не пройдёт. Здесь потребуется настройка сети на уровне хоста с учётом требований вашей сетевой политики.
Частые вопросы
Можно ли отключить проверку интернета в Supervisor?
Штатной опции полного отключения проверки связности нет — она встроена в логику Supervisor. Правильный путь — восстановить реальный доступ хоста в интернет, а не обходить проверку.
Дополнения можно установить вручную без интернета?
Официальный механизм установки дополнений требует загрузки образов из сети, поэтому полностью офлайн-установка штатными средствами не предусмотрена. Локальные дополнения (local add-ons) — отдельный сценарий для разработчиков.
Ошибка появилась после обновления Home Assistant — что делать?
Начните с перезапуска Supervisor и хоста, затем проверьте журнал командой ha supervisor logs. Если в логах есть сетевые ошибки, выполните диагностику DNS и шлюза по инструкции выше.
Работает ли эта инструкция для Docker-установки без Supervisor?
Чистая контейнерная установка (Container) не включает Supervisor и магазин дополнений, поэтому такая ошибка там не возникает. Инструкция актуальна для Home Assistant OS и Supervised.
Где посмотреть, видит ли Supervisor интернет?
Выполните ha supervisor info и изучите вывод, а также журнал ha supervisor logs — там отражаются результаты проверок связности и сетевые ошибки.