Это старая версия документа!
Содержание
Настройка интеграции Matrix в Home Assistant
<note warning> Важное предупреждение: Вы указали пароль в открытом виде. Никогда не делитесь паролями в чатах! Рекомендуется:
- Сменить пароль для аккаунта @ha:chat.2admina.ru
- Использовать
!secretдля хранения чувствительных данных
</note>
📋 Шаг 1: Подготовка secrets.yaml
Создайте или отредактируйте файл /config/secrets.yaml:
# Добавьте сюда ваши данные matrix_user: "@ha:chat.2admina.ru" matrix_password: "ваш_пароль"
⚙️ Шаг 2: Настройка configuration.yaml
Добавьте в /config/configuration.yaml:
matrix: homeserver: https://chat.2admina.ru username: !secret matrix_user password: !secret matrix_password rooms: - "!your_room_id:chat.2admina.ru"
🔄 Шаг 3: Перезагрузка Home Assistant
- Перейдите в Настройки → Система → Перезагрузка
- Нажмите Перезагрузить конфигурацию (или перезапустите весь сервер)
После перезагрузки интеграция появится в Настройки → Устройства и службы.
📬 Использование уведомлений
В автоматизациях:
service: notify.matrix data: message: "Привет из Home Assistant!" target: "!your_room_id:chat.2admina.ru"
Отправка изображения:
service: notify.matrix data: message: "Движение обнаружено!" data: file: "/config/www/snapshot.jpg"
<note>
⚠️ Для отправки файлов из внешних папок добавьте в configuration.yaml:
homeassistant: allowlist_external_dirs: - "/config/www"
</note>
🎯 Обработка команд из Matrix
Создайте автоматизацию для реакции на команды:
trigger: - platform: event event_type: matrix_command event_data: command: "статус" action: - service: notify.matrix data: message: "Система работает в штатном режиме."
🔐 Рекомендации по безопасности
- Используйте отдельный аккаунт для бота, не ваш личный.
- Ограничьте права бота: не давайте права администратора в комнатах.
- Проверьте SSL: если сервер использует самоподписанный сертификат, установите
verify_ssl: false(менее безопасно). - Регулярно меняйте пароль и обновляйте
secrets.yaml.
🛠️ Альтернатива: кастомная интеграция
Если официальная интеграция не поддерживает все нужные функции (E2EE, медиа), можно рассмотреть Matrix Chat custom component:
matrix_custom: homeserver: https://chat.2admina.ru access_token: "ваш_токен"
Токен доступа можно получить в клиенте Element: Настройки → Помощь и информация → Токен доступа.
❓ Устранение неполадок
| Проблема | Решение |
|---|
| Не подключается к серверу | Проверьте verify_ssl, URL homeserver |
| Не видит команды | Убедитесь, что бот добавлен в комнату и комнаты указаны в конфиге |
| Ошибка аутентификации | Проверьте логин/пароль, возможно сервер требует токен |
| Не отправляет уведомления | Проверьте, что default_room существует и бот в нём состоит |
Логи интеграции: Настройки → Система → Журналы → Фильтр: homeassistant.components.matrix
Нужна помощь с конкретной ошибкой? Пришлите лог — помогу разобраться! 🤖✨
