На первый взгляд Home Assistant кажется удобной и простой системой — всё настраивается буквально в пару кликов. Но когда нужно сделать что-то нестандартное или по-настоящему тонко настроить систему, вам обязательно напомнят о загадочном файле configuration.yaml.
Давайте разберёмся, зачем он нужен, как с ним работать и почему большинству пользователей о нём пока можно не волноваться.
Файл configuration.yaml: сердце ручной настройки Home Assistant
Этот файл, который почти всегда лежит в папке config на сервере Home Assistant, — список инструкций на языке YAML. Сам формат называли когда-то «Yet Another Markup Language», позже расшифровали как «YAML Ain’t Markup Language».
YAML — это максимально понятный человеку код, где важно соблюдать отступы, а вся структура создана для удобства чтения и редактирования. В Home Assistant через YAML оформляют не только интеграции, но и автоматизации, сценарии, темы и многое другое. Хотя бы поверхностное понимание, что такое энтити и параметры, тут, конечно, пригодится.
Главная причина самому залезть в configuration.yaml — это настройка автоматизаций или интеграций, которые нельзя сделать стандартным интерфейсом Home Assistant.
Бóльшая часть стандартных интеграций подключается прямо через удобные панели веб-интерфейса Home Assistant. Но если хочется чего-то особенного — например, модуль из Community Store или поддержку редкой техники — без редактирования configuration.yaml не обойтись. Всё, что вы там пропишете, заработает после перезапуска системы.
Иногда всё просто: скопировал пару строк — и готово. Но бывает, что придётся детальнее описывать параметры под свои нужды, чтобы интеграция работала как надо. Например, мне однажды захотелось добавить общественный транспорт: настроил интеграцию, указал нужный API, прописал остановки и расписание — всё это руками, прямо в YAML.
Есть и фишки: через configuration.yaml вы сможете полностью менять внешний вид интерфейса, делать быстрые ссылки на важные разделы и подстраивать платформу «под себя».
В этот файл можно подключить отдельные YAML-файлы с вашими автоматизациями, сценариями, скриптами и темами. Большинству это не понадобится, но если хочется — возможностей для экспериментов предостаточно.
Как редактировать configuration.yaml (и ничего не сломать)
Для редактирования configuration.yaml достаточно самого обычного текстового редактора — главное, иметь доступ к нужной папке. Обычно это /config/ на сервере, а если вы используете Docker — ищите /homeassistant/.
Если Home Assistant стоит, к примеру, на Raspberry Pi или виртуальной машине, добраться до файла бывает не так просто. Здесь выручит официальное дополнение File editor.
Установить его легко: зайдите в «Настройки» > «Дополнения», найдите File editor в магазине. После установки запускайте File editor через меню «Настройки» > «Дополнения» > «File editor» > «Открыть веб-интерфейс». Я, например, вынес себе отдельную кнопку для быстрого доступа.
При запуске File editor первым делом открывается именно configuration.yaml. Добавляйте нужные строки, добавляйте свои комментарии (через #) — так потом всегда легко вспомните, что и зачем вы написали. Всё готово? Просто сохраните изменения, нажав на красную иконку внизу страницы.
Чтобы изменения начали работать, перезапустите Home Assistant. Это тоже просто: меню «Настройки», три точки в верхнем углу, «Перезапустить Home Assistant».
Подпишитесь на рассылку: простые советы для Home Assistant каждую неделю
Есть и другой способ: расшарьте папку /homeassistant/ по сети через дополнение Samba share. Тогда configuration.yaml можно открыть и отредактировать с любого компьютера в вашей сети самым обычным редактором — быстро и удобно.
Не лезьте в configuration.yaml — пока это действительно не понадобится!
Как видите, подавляющему большинству пользователей configuration.yaml вообще почти не нужен — на каждый день хватает привычных кнопок в удобном интерфейсе.
Бывает, конечно, что понадобится редкая интеграция или устройство, иначе не подключить или не настроить. Не бойтесь — если придётся, работать с этим файлом не страшно: это не баг и не что-то неправильное, а просто способ раскрыть новые возможности вашей системы.
Главное — всегда делайте резервную копию Home Assistant. Тогда любые эксперименты с configuration.yaml можно легко откатить обратно одним кликом!
Если вам понравилась эта статья, подпишитесь, чтобы не пропустить еще много полезных статей!
Премиум подписка - это доступ к эксклюзивным материалам, чтение канала без рекламы, возможность предлагать темы для статей и даже заказывать индивидуальные обзоры/исследования по своим запросам!Подробнее о том, какие преимущества вы получите с премиум подпиской, можно узнать здесь
Также подписывайтесь на нас в:
- Telegram: https://t.me/gergenshin
- Youtube: https://www.youtube.com/@gergenshin
- Яндекс Дзен: https://dzen.ru/gergen
- Официальный сайт: https://www-genshin.ru