Различия

Показаны различия между двумя версиями страницы.

--- start:public:hamatrix [2026/04/18 20:53] – создано sek
+++ start:public:hamatrix [2026/04/18 21:13] (текущий) – sek
@@ Строка 1: / Строка 1: @@
-Настройка интеграции Matrix в Home Assistant
+====== Настройка интеграции Matrix в Home Assistant ======
-⚠️ Важное предупреждение: Вы указали пароль в открытом виде. Никогда не делитесь паролями в чатах! Рекомендуется:
-Сменить пароль для аккаунта @ha:chat.2admina.ru
+<note warning>
-Использовать !secret для хранения чувствительных данных
+**Важное предупреждение:** Вы указали пароль в открытом виде. Никогда не делитесь паролями в чатах! Рекомендуется:
-📋 Шаг 1: Подготовка secrets.yaml
+  * Сменить пароль для аккаунта @ha:chat.2admina.ru
-Создайте или отредактируйте файл /config/secrets.yaml:
+  * Использовать ''!secret'' для хранения чувствительных данных
-yaml
+</note>
-⚙️ Шаг 2: Настройка configuration.yaml
+===== 📋 Шаг 1: Подготовка secrets.yaml =====
-Добавьте в /config/configuration.yaml:
+Создайте или отредактируйте файл ''/config/secrets.yaml'':
-yaml
-12345678910111213141516171819
+<code yaml>
-🔄 Шаг 3: Перезагрузка Home Assistant
+# Добавьте сюда ваши данные
-Перейдите в Настройки → Система → Перезагрузка
+matrix_homeserver: "https://chat.2admina.ru"
-Нажмите Перезагрузить конфигурацию
+matrix_username: "@ha:chat.2admina.ru"
-Или перезапустите весь сервер
+matrix_password: "********"  # ⚠️ замените на новый пароль!
-После перезагрузки интеграция появится в Настройки → Устройства и службы.
+matrix_room: "#ваша_комната:chat.2admina.ru"
-📬 Использование уведомлений
+</code>
+===== ⚙️ Шаг 2: Настройка configuration.yaml =====
+Добавьте в ''/config/configuration.yaml'':
+<code yaml>
+# Основная интеграция Matrix
+matrix:
+  homeserver: !secret matrix_homeserver
+  username: !secret matrix_username
+  password: !secret matrix_password
+  verify_ssl: true  # если у вас самоподписанный сертификат, установите false
+  rooms:
+    - !secret matrix_room  # комнаты для прослушивания команд
+  commands:  # опционально: команды для обработки
+    - word: статус
+      name: ha_status
+    - word: перезагрузка
+      name: ha_restart
+# Платформа уведомлений
+notify:
+  - name: matrix_notify
+    platform: matrix
+    default_room: !secret matrix_room
+</code>
+===== 🔄 Шаг 3: Перезагрузка Home Assistant =====
+  * Перейдите в **Настройки** → **Система** → **Перезагрузка**
+  * Нажмите **Перезагрузить конфигурацию** (или перезапустите весь сервер)
+После перезагрузки интеграция появится в **Настройки** → **Устройства и службы**.
+===== 📬 Использование уведомлений =====
 В автоматизациях:
-yaml
+<code yaml>
-123456789101112
+automation:
+  - alias: "Уведомление в Matrix при срабатывании датчика"
+    triggers:
+      - trigger: state
+        entity_id: binary_sensor.motion_door
+        to: "on"
+    actions:
+      - action: notify.matrix_notify
+        data:
+          message: "🚪 Движение у входной двери!"
+            format: "html"  # опционально: поддержка базового HTML
+</code>
 Отправка изображения:
-yaml
+<code yaml>
+action: notify.matrix_notify
-⚠️ Для отправки файлов из внешних папок добавьте в configuration.yaml:
+data:
-yaml
+  message: "📷 Снимок с камеры"
-🎯 Обработка команд из Matrix
+    images:
+      - /config/www/camera/snapshot.jpg
+</code>
+<note>
+⚠️ Для отправки файлов из внешних папок добавьте в ''configuration.yaml'':
+<code yaml>
+homeassistant:
+  allowlist_external_dirs:
+    - /config/www/camera
+</code>
+</note>
+===== 🎯 Обработка команд из Matrix =====
 Создайте автоматизацию для реакции на команды:
-yaml
+<code yaml>
-1234567891011
+automation:
-🔐 Рекомендации по безопасности
+  - alias: "Обработка команды !статус"
-Используйте отдельный аккаунт для бота, не ваш личный
+    triggers:
-www.home-assistant.io
+      - trigger: event
-Ограничьте права бота: не давайте права администратора в комнатах
+        event_type: matrix_command
-Проверьте SSL: если https://chat.2admina.ru использует самоподписанный сертификат, установите verify_ssl: false (менее безопасно)
+        event_data:
-Регулярно меняйте пароль и обновляйте secrets.yaml
+          command: ha_status
-🛠️ Альтернатива: кастомная интеграция
+    actions:
-Если официальная интеграция не поддерживает все нужные функции (E2EE, медиа), можно рассмотреть Matrix Chat custom component
+      - action: notify.matrix_notify
-community.home-assistant.io
-:
+          message: "✅ Home Assistant работает нормально. Версия: {{ states('sensor.home_assistant_version') }}"
-yaml
+</code>
-Токен доступа можно получить в клиенте Element: Настройки → Помощь и информация → Токен доступа
+===== 🔐 Рекомендации по безопасности =====
-❓ Устранение неполадок
+  * Используйте **отдельный аккаунт** для бота, не ваш личный.
-Проблема
+  * **Ограничьте права бота**: не давайте права администратора в комнатах.
-Решение
+  * **Проверьте SSL**: если сервер использует самоподписанный сертификат, установите ''verify_ssl: false'' (менее безопасно).
-Не подключается к серверу
+  * Регулярно меняйте пароль и обновляйте ''secrets.yaml''.
-Проверьте verify_ssl, URL homeserver
-Не видит команды
+===== 🛠️ Альтернатива: кастомная интеграция =====
-Убедитесь, что бот добавлен в комнату и комнаты указаны в конфиге
+Если официальная интеграция не поддерживает все нужные функции (E2EE, медиа), можно рассмотреть [[https://home-assistant.io|Matrix Chat custom component]]:
-Ошибка аутентификации
-Проверьте логин/пароль, возможно сервер требует токен
+<code yaml>
-community.home-assistant.io
+# После установки в /config/custom_components/
-Не отправляет уведомления
+matrix_chat:
-Проверьте, что default_room существует и бот в нём состоит
+  homeserver: !secret matrix_homeserver
-Логи интеграции: Настройки → Система → Журналы → Фильтр: homeassistant.components.matrix
+  user_id: !secret matrix_username
+  access_token: !secret matrix_access_token  # токен вместо пароля
+  verify_ssl: true
+</code>
+Токен доступа можно получить в клиенте Element: **Настройки** → **Помощь и информация** → **Токен доступа**.
+===== ❓ Устранение неполадок =====
+^ Проблема ^ Решение ^
+| Не подключается к серверу | Проверьте verify_ssl, URL homeserver |
+| Не видит команды | Убедитесь, что бот добавлен в комнату и комнаты указаны в конфиге |
+| Ошибка аутентификации | Проверьте логин/пароль, возможно сервер требует токен |
+| Не отправляет уведомления | Проверьте, что default_room существует и бот в нём состоит |
+**Логи интеграции:** Настройки → Система → Журналы → Фильтр: ''homeassistant.components.matrix''
 Нужна помощь с конкретной ошибкой? Пришлите лог — помогу разобраться! 🤖✨