HACS (Home Assistant Community Store) — это магазин пользовательских интеграций, карточек и тем для Home Assistant. Он нужен, чтобы ставить то, чего нет в стандартной поставке: Yandex Smart Home для Алисы, Xiaomi Miot Auto, Local Tuya, красивые карточки Mushroom и многое другое. Установка HACS занимает 10–15 минут: скачать скрипт, перезагрузить Home Assistant, добавить интеграцию и авторизоваться через GitHub.
1Что такое HACS и зачем он нужен
В Home Assistant есть официальные интеграции, которые проверяет команда проекта. Всё остальное создаёт сообщество, и без HACS такие компоненты пришлось бы ставить вручную копированием файлов в каталог custom_components и следить за обновлениями самостоятельно. HACS автоматизирует этот процесс: показывает каталог, устанавливает, предупреждает об обновлениях и обновляет по нажатию кнопки.
| Категория в HACS | Что внутри | Пример |
|---|---|---|
| Интеграции | Новые подключения устройств и сервисов | Yandex Smart Home, Xiaomi Miot Auto, Local Tuya |
| Frontend (интерфейс) | Карточки, темы, иконки для дашбордов | Mushroom, Mini Graph Card |
| Автоматизации | Готовые наборы и Blueprints | Различные шаблоны автоматизаций |
| Темы | Оформление интерфейса | Тёмные и светлые темы |
2Что нужно перед установкой
- Работающий Home Assistant (HAOS, Supervised или Container).
- Аккаунт на GitHub: HACS использует его для авторизации и скачивания.
- Доступ к GitHub с вашего сервера. В России GitHub обычно открывается, но иногда загрузки идут медленно или обрываются; в таком случае помогает настройка прокси или VPN на роутере.
- Включённый режим продвинутого пользователя в профиле (для удобной работы с дополнениями).
- Резервная копия системы перед установкой.
3Установка HACS в Home Assistant OS
Актуальные команды всегда проверяйте на сайте hacs.xyz в разделе загрузки, так как способ установки иногда обновляется. Типичный порядок для HAOS такой.
- Установите add-on Terminal & SSH из магазина дополнений и запустите его.
- Откройте терминал add-on’а и выполните команду установки с сайта hacs.xyz; она скачивает файлы в каталог
custom_components/hacs. - Перезагрузите Home Assistant полностью («Настройки» → «Система» → кнопка питания → «Перезагрузить Home Assistant»).
- Откройте «Настройки» → «Устройства и службы» → «Добавить интеграцию» и выберите HACS.
- Согласитесь с условиями и перейдите по ссылке авторизации GitHub. Введите код, который покажет Home Assistant, и подтвердите доступ.
- Дождитесь окончания загрузки каталога. В боковом меню появится пункт HACS.
wget -O - https://get.hacs.xyz | bash -Команда выше — пример из документации: перед запуском скриптов из интернета в терминале всегда проверяйте, что адрес принадлежит официальному сайту проекта. Для Docker-установки порядок похожий, но команду нужно выполнять внутри контейнера или в смонтированном каталоге конфигурации.
Нет времени разбираться? Мы можем настроить Home Assistant под ключ, установить HACS и нужные интеграции.
4Как установить интеграцию через HACS
- Откройте HACS в боковом меню и выберите нужную категорию.
- Нажмите кнопку поиска и введите название (например, «Yandex Smart Home»).
- Откройте карточку компонента, прочитайте описание и нажмите «Скачать».
- Выберите версию (обычно последняя стабильная) и подтвердите.
- Перезагрузите Home Assistant, если об этом просит HACS.
- Добавьте интеграцию в «Устройства и службы» или настройте её по инструкции автора.
Если нужного репозитория нет в каталоге, его можно добавить вручную: меню HACS → «Пользовательские репозитории», вставьте адрес репозитория GitHub и выберите тип. Делайте так только для проектов, в которых вы уверены.
5Какие интеграции из HACS стоит попробовать
| Компонент | Назначение |
|---|---|
| Yandex Smart Home (dext0r) | Управление Home Assistant голосом через Алису |
| Xiaomi Miot Auto | Расширенная поддержка устройств Xiaomi |
| Local Tuya / Tuya Local | Локальное управление Tuya |
| Frigate (интеграция) | Подключение системы видеонаблюдения Frigate |
| Mushroom, Mini Graph Card | Современные карточки дашборда |
| Adaptive Lighting | Автоматическая подстройка света под время суток |
| Alarmo | Система охранной сигнализации |
Не ставьте всё подряд: каждый пользовательский компонент — потенциальный источник ошибок после обновления ядра. Выбирайте проекты с активной разработкой, большим числом звёзд на GitHub и свежими релизами.
6Обновления и безопасность
HACS показывает доступные обновления в интерфейсе. Перед обновлением ядра Home Assistant убедитесь, что установленные компоненты совместимы: прочитайте описания выпусков. Пользовательские интеграции работают с теми же правами, что и сам Home Assistant, поэтому используйте только проверенные репозитории, читайте код и не устанавливайте компоненты с сомнительных страниц.
Если интеграция ломает систему после обновления, зайдите в «Настройки» → «Система» → «Журналы», найдите ошибку, а затем удалите или откатите компонент через HACS и перезагрузите систему. Именно поэтому важно иметь резервную копию.
Для автоматизаций, использующих компоненты HACS, удобно воспользоваться конструктором автоматизаций. А если нужно что-то сложное — например, связка Алисы и сценариев, — закажите автоматизацию на заказ.
7Частые проблемы
- Ошибка авторизации GitHub. Проверьте время на сервере и доступность GitHub; повторите вход.
- Не загружается каталог. Возможны ограничения доступа к GitHub или лимит запросов. Подождите и повторите, при необходимости используйте прокси.
- HACS не появляется в меню. Не выполнена полная перезагрузка или файлы скопированы не в тот каталог.
- Интеграция не появляется после установки. Перезагрузите систему и очистите кэш браузера.
8Blueprints и дашборды из HACS
Кроме интеграций, в HACS есть карточки интерфейса и шаблоны автоматизаций (Blueprints). Карточки вроде Mushroom делают дашборд аккуратным и современным, а Mini Graph Card красиво показывает графики температуры и энергии. Установив карточку, добавьте её на дашборд через режим редактирования: HACS сам регистрирует ресурсы, и в большинстве случаев вручную ничего прописывать не нужно.
Если после установки карточки вы видите ошибку «Custom element doesn’t exist», очистите кэш браузера и приложения Companion и перезагрузите страницу. Это самая частая проблема после установки новых frontend-компонентов.
9Как следить за совместимостью
Ядро Home Assistant выходит каждый месяц, и иногда в нём меняются внутренние интерфейсы, на которых построены пользовательские компоненты. Чтобы не оказаться в ситуации, когда после обновления половина интеграций не работает, придерживайтесь простой дисциплины. Перед обновлением ядра читайте список изменений и раздел критических изменений. Обновляйтесь не в первый день релиза, а через неделю-две, когда выйдут исправления. Перед каждым обновлением создавайте полную резервную копию. После обновления проверяйте журнал на предмет ошибок пользовательских компонентов и обновляйте их через HACS до последней версии.
Ведите короткий список установленных компонентов с причиной, зачем каждый нужен. Через полгода вы сможете убрать то, чем не пользуетесь, и система станет стабильнее и быстрее.
10Как подготовиться к удалению компонента
Прежде чем убирать пользовательскую интеграцию, отключите все автоматизации и дашборды, которые её используют, и удалите саму интеграцию в «Устройства и службы». Только после этого удаляйте файлы через HACS и перезагружайте систему. Если сначала удалить файлы, в журнале появятся ошибки о недоступных сущностях, а часть записей в реестре останется «сиротами». Чистая последовательность избавляет от лишних сообщений и делает систему аккуратнее.
11Частые вопросы
Безопасен ли HACS?
Сам магазин безопасен, но пользовательские компоненты — это стороннее ПО с широкими правами. Выбирайте популярные проекты с открытым кодом.
Нужен ли HACS новичку?
Не сразу. Сначала освойте стандартные интеграции. HACS понадобится, когда вам потребуется конкретный компонент, например для Алисы или расширенной поддержки Xiaomi.
Можно ли использовать HACS в Docker?
Да. Он ставится в каталог custom_components вашей конфигурации, как и в других вариантах установки. Add-on-версии магазина в Container нет.
Как удалить HACS?
Удалите интеграцию HACS в «Устройства и службы», затем каталог custom_components/hacs и перезагрузите систему. Установленные через него компоненты останутся, но обновлять их придётся вручную.
12Итог
HACS расширяет возможности Home Assistant, но требует аккуратности. Устанавливайте только то, что нужно, делайте резервные копии перед обновлениями и следите за совместимостью.
