Trassir: интеграция с Home Assistant и умным домом

Trassir: интеграция с Home Assistant и умным домом

Коротко: если у вас установлен Trassir как сервер видеонаблюдения и вы хотите, чтобы события камер, тревоги и управление оборудованием работали в связке с Home Assistant — это реально и обычно проще, чем кажется. Ниже — понятные варианты интеграции, практические схемы, пошаговый пример и чек‑лист перед запуском.

Что такое Trassir и зачем его связывать с Home Assistant

Trassir — российская платформа для записи, управления и аналитики видеопотоков (серверы, регистраторы, клиенты). Умеет хранить записи, детектировать движение, реагировать на входы/выходы, управлять PTZ и интегрироваться с внешними системами через API, веб‑скрипты и уведомления. Home Assistant дает гибкую автоматизацию умного дома: освещение, оповещения, сценарии безопасности. Связка Trassir + Home Assistant позволяет: - получать события (движение, вход по датчику) и автоматически включать свет/записывать видео/посылать уведомления; - показывать камеры в интерфейсе умного дома; - управлять внешними реле/шлюзами на основе видеоаналитики.

Основные способы интеграции

- RTSP/ONVIF — самый простой путь для показа видео в Home Assistant. Камеру подключают напрямую или через Trassir, а в HA добавляют как generic или ONVIF‑камеру. - HTTP/Webhook — Trassir умеет отправлять HTTP‑запросы при тревоге. Home Assistant принимает webhook и запускает автоматизацию. - MQTT Bridge — сторонние скрипты или готовые мосты переводят события Trassir в MQTT‑топики; HA читает их как сенсоры. - Trassir API / SDK (Python) — для глубокой интеграции: чтение метаданных, контроль PTZ, работа с архивом. - Trassir Cloud / WebSocket — для облачных нотификаций и удалённого доступа (зависит от лицензии).

Три типичные архитектуры

Схема	Как работает	Плюсы	Минусы
RTSP → HA, Trassir для записи	Камеры стримят в Trassir; в HA берём RTSP напрямую	Низкая задержка в HA, независимость от Trassir API	Двойная нагрузка на сеть и камеры
Trassir → Webhook/MQTT → HA	Trassir отправляет события в HA (webhook) или MQTT	Экономия трафика: в HA только события/снимки	Нужна настройка вебхуков или MQTT‑моста
API/SDK → Прямая интеграция	Скрипт опрашивает Trassir, управляет PTZ и архивом	Гибкая логика, доступ к метаданным	Нужны навыки разработки и поддержка

Пошаговая настройка: Trassir → Home Assistant через webhook + RTSP для видео

1. В Home Assistant создайте webhook‑триггер (Automation → Trigger type: Webhook). Сохраните ID webhook. 2. В Trassir откройте настройку события (действие при тревоге). Добавьте действие «Отправить HTTP‑запрос» с URL домашнего HA: https://адрес_ha/api/webhook/ваш_webhook_id Метод POST, JSON с нужными полями, например: { "camera":"FrontDoor", "event":"motion", "time":"%TIME%" } 3. В HA настройте автоматизацию, которая реагирует на webhook: записать метаданные, снять snapshot с камеры, включить свет и уведомить пользователя. Пример YAML‑логики в автоматизации:

trigger:
  - platform: webhook
    webhook_id: ваш_webhook_id
action:
  - service: camera.snapshot
    target:
      entity_id: camera.frontdoor
    data:
      filename: '/config/www/snapshots/frontdoor.jpg'
  - service: notify.mobile_app
    data:
      title: "Движение у двери"
      message: "Проверьте камеру"
      data:
        image: '/local/snapshots/frontdoor.jpg'

4. Для видео в интерфейсе HA добавьте камеру как generic с source = rtsp://user:pass@ip:554/stream (или используйте ONVIF для автонастройки). Если много камер — включите camera proxy в HA, чтобы не открывать десятки RTSP подключений в интерфейсе пользователя. 5. Тестируйте: проверьте, что Trassir отправляет запрос, HA отвечает 200, и что snapshot создаётся. Убедитесь в корректных часах на всех устройствах (NTP).

Как управлять PTZ и входами/выходами

- PTZ: лучше использовать ONVIF напрямую из Home Assistant к камере, если это возможно. Если PTZ контролируется только через Trassir, используйте его API/SDK или отправляйте команды через скрипт на сервере, который общается с Trassir. - Входы/выходы (I/O): Trassir может читать физические входы и посылать события в HA (webhook/MQTT). Для включения внешних реле можно либо управлять ими через HA напрямую (через Z‑wave, Zigbee, Modbus), либо посылать команды в Trassir, чтобы он переключал выходы.

Практические советы и типичные ошибки

- Не тянуть все камеры в HA через RTSP, если у вас слабый сервер — используйте snapshot‑подход или только ключевые камеры. - Используйте HTTPS и токены для webhooks, чтобы не открывать HA без защиты. - Учтите аутентификацию: Trassir обычно поддерживает Basic auth и ключи в запросах. - Синхронизация времени (NTP) критична для корреляции событий и записей. - Ограничьте частоту уведомлений, чтобы не получить поток лишних оповещений. - При использовании облачных сервисов учитывайте задержки и конфиденциальность потока.

Закон, конфиденциальность и хранение записей

Запись видео может подпадать под местные правила. Для бизнеса обычно требуется: - информирование о ведении видеонаблюдения; - ограничение доступа к архивам; - регламентация сроков хранения. Для частного сектора уважайте частную жизнь соседей и не направляйте камеры на общественные места без оснований. Шифруйте доступ к серверу и логируйте изменения пользователей.

Чек‑лист перед интеграцией

• Определите цели: показ видео, только события, PTZ‑контроль или всё вместе.
• Проверьте, поддерживает ли ваша версия Trassir нужные действия (HTTP, MQTT, API).
• Настройте защищённый доступ к Home Assistant (HTTPS, токены).
• Выберите архитектуру: прямые потоки или события + снимки.
• Протестируйте производительность при полном количестве камер.
• Настройте хранение и ротацию архива в Trassir.
• Проверьте уведомления на нескольких устройствах.

Смотрите, какая штука: чаще всего оптимальная связка — Trassir оставляет за собой запись архива и аналитику, а Home Assistant получает события и управляет «умными» устройствами по этим событиям.

Небольшая рекомендация: если вам нужны камеры, регистрация, монтаж или помощь с интеграцией — можно начать с подборки оборудования и услуг в разделе систем видеонаблюдения y-ss.ru, там есть варианты под разные задачи и бюджеты: https://y-ss.ru/catalog/sistemy_videonablyudeniya/ Надёжная интеграция Trassir и Home Assistant даёт баланс между профессиональной записью и гибкими автоматизациями умного дома. Если нужны примеры конфигураций под конкретную модель камеры или скрипты для Trassir → MQTT, расскажите о своей системе — опишу точную последовательность.