Урок 4. Wi-Fi, Native API, шифрование и локальная сеть

Чему вы научитесь

Составлять безопасную логическую цепочку подключения устройства к Home Assistant.

Wi-Fi обеспечивает транспорт

ESPHome-устройство должно подключиться к подходящей сети, чтобы работать с Home Assistant по IP. Проверяйте диапазон частот и возможности платы, DHCP, разрешённый маршрут между сегментами, DNS/mDNS и ограничения изоляции клиентов. «Вижу SSID» ещё не означает, что API доступно из нужной подсети.

При нескольких VLAN IoT допускается отдельный защищённый сегмент с контролируемым доступом Home Assistant к устройствам. Не стоит ради удобства открывать все направления в домашней сети.

Native API и MQTT

Native API — распространённый способ локального обмена ESPHome с Home Assistant. MQTT может применяться в подходящих сценариях, но это другой путь интеграции и не обязательная зависимость Native API. Сначала определите, какой протокол используют интеграции.

Для Native API нужна отдельная настройка api. Шифрование с уникальным ключом снижает риск несанкционированного чтения и управления. Устройства ESPHome не предназначены для размещения напрямую в небезопасных публичных сетях.

Диагностика по уровням

Если узел не появляется в Home Assistant, проверьте питание, подключение Wi-Fi, IP-адрес, маршрут/межсетевой экран, mDNS или ручное добавление, API-ключ, а потом журналы. Не меняйте всё одновременно.

Здесь полезно отличать «устройство офлайн», «есть IP, но нет соединения API» и «соединение API есть, но датчик неправильно описан в YAML». Это три разных слоя неисправности.

Самопроверка: сформулируйте результат своими словами, а затем пройдите вопросы ниже. Если устройство или программа не доступны, выполните задание на бумаге или в учебном тренажёре.