Инструменты пользователя

Инструменты сайта


start:public:hamatrix

Это старая версия документа!


Настройка интеграции 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

Нужна помощь с конкретной ошибкой? Пришлите лог — помогу разобраться! 🤖✨

start/public/hamatrix.1776521118.txt.gz · Последнее изменение: sek