HACS
Home Assistant Community Store - это мощный менеджер дополнений, который позволяет легко устанавливать и управлять пользовательскими интеграциями, темами оформления и другими дополнениями для Home Assistant.
Что такое HACS?
Home Assistant Community Store
HACS - это бесплатный менеджер дополнений с открытым исходным кодом, разработанный сообществом Home Assistant. Он предоставляет удобный интерфейс для установки, обновления и управления пользовательскими интеграциями, темами оформления, картами Lovelace, скриптами автоматизации и другими дополнениями, которые не включены в стандартный дистрибутив Home Assistant.
- Простой и удобный интерфейс на русском языке
- Автоматические обновления установленных дополнений
- Доступ к тысячам пользовательских интеграций
- Управление темами оформления и карточками Lovelace
- Полная интеграция с Home Assistant
Возможности HACS
Пользовательские интеграции
Устанавливайте интеграции с устройствами, которые не поддерживаются официально
Темы оформления
Меняйте внешний вид Home Assistant с помощью красивых тем
Карты Lovelace
Добавляйте новые типы карточек для ваших дашбордов
Автоматизации
Готовые скрипты и шаблоны автоматизаций от сообщества
Скрипты Python
Устанавливайте пользовательские скрипты на Python
Плагины приложений
Расширяйте функционал мобильного приложения
Установка HACS
⚠️ Перед началом установки
Убедитесь, что у вас есть доступ к терминалу Home Assistant через SSH или вы используете Home Assistant OS с доступом к консоли. Вам также потребуется активный аккаунт GitHub для генерации токена.
-
Создание GitHub токена
Перейдите на GitHub и создайте персональный токен доступа:
1. Зайдите на https://github.com/settings/tokens
2. Нажмите "Generate new token" → "Generate new token (classic)"
3. Введите описание (например: "HACS for Home Assistant")
4. Установите срок действия (No expiration или выберите дату)
5. Выберите права: ✅ repo (полный доступ к репозиториям)
6. Нажмите "Generate token"
7. Скопируйте токен (он больше не будет показан!) -
Загрузка установочного скрипта
Подключитесь к Home Assistant через SSH и выполните следующую команду:
wget -O - https://get.hacs.xyz | bash -💡 Совет
Эта команда автоматически определит ваш тип установки Home Assistant и загрузит правильную версию HACS.
-
Перезагрузка Home Assistant
После завершения установки перезагрузите Home Assistant:
В веб-интерфейсе: Настройки → Система → Перезагрузить
Или через терминал:
hassio.host.reload -
Настройка HACS в интерфейсе
После перезагрузки выполните финальную настройку:
- Откройте Home Assistant и нажмите на "HACS" в боковом меню
- Пройдите мастер настройки (нажмите "Next")
- Прочтите и примите условия использования
- Выберите типы дополнений, которые хотите использовать
- Вставьте ваш GitHub токен, когда будет предложено
- Дождитесь завершения регистрации
Использование HACS
Поиск дополнений
Откройте HACS и выберите нужную категорию. Используйте строку поиска для быстрого поиска дополнений по названию или описанию.
Установка
Нажмите на интересующее дополнение, ознакомьтесь с описанием и нажмите "Загрузить". Следуйте инструкциям на экране.
Обновление
Перейдите в раздел "Магазин" → "Обновления". HACS покажет все доступные обновления для установленных дополнений.
Настройка
После установки некоторых дополнений требуется дополнительная настройка через configuration.yaml или в разделе интеграций.
Популярные дополнения
Home Assistant Xiaomi Home
Интеграция для устройств Xiaomi
Полноценная интеграция для работы с устройствами экосистемы Xiaomi, включая шлюзы, датчики, розетки и освещение.
Xiaomi Miot Auto
Автоматическое обнаружение устройств Xiaomi
Продвинутая интеграция с автоматическим обнаружением устройств Xiaomi через протокол MIoT с поддержкой автоматизации.
Card Mod
Модификация карточек Lovelace
Мощный инструмент для кастомизации карточек Lovelace с помощью CSS. Позволяет полностью изменить внешний вид любых карточек.
UI Lovelace Minimalist
Минималистичный UI для дашбордов
Набор карточек и компонентов для создания красивых и минималистичных дашбордов в стиле Apple HomeKit.
Dark Sky
Альтернатива для погоды
Красивая карточка погоды с подробным прогнозом, анимациями и поддержкой различных провайдеров данных о погоде.
Решение проблем
🔴 HACS не появляется в меню
Убедитесь, что вы перезагрузили Home Assistant после установки. Если проблема сохраняется, проверьте логи на наличие ошибок.
🔴 Ошибка "GitHub token not valid"
Проверьте, что токен скопирован правильно и имеет права "repo". Создайте новый токен и попробуйте снова.
🔴 Дополнения не устанавливаются
Проверьте подключение к интернету и убедитесь, что у вас достаточно свободного места на диске. Некоторые дополнения могут требовать дополнительных зависимостей.
💡 Полезные советы
- Регулярно обновляйте HACS до последней версии
- Читайте описания дополнений перед установкой
- Проверяйте совместимость с вашей версией Home Assistant
- Делайте резервные копии перед установкой новых дополнений
- Используйте ветку "main" для стабильных версий
Полезные ресурсы
Официальная документация
Полная документация HACS с примерами и руководствами по установке и использованию.
Посетить сайтСообщество HACS
Присоединяйтесь к сообществу HACS для получения помощи, обмена опытом и обсуждения дополнений.
GitHub DiscussionsСообщить о проблеме
Нашли баг или ошибку? Сообщите о проблеме разработчикам через GitHub Issues.
GitHub Issues