Files
buryan-infra/ops/devices/DEVICES.md
buryan-agent cd4e224a83 Устройства из роутера: команды бота, блок панели, обновление каждые 30 минут
Инвентарь берётся из Keenetic целиком: имена, MAC, IP активных. Обновление
по cron каждые 30 минут, результат в ядре (devices).

Бот: «устройства» (сводка по типам), «устройства телевизор|колонка»
(списки), «тв» (состояние и управление: пауза, стоп, включи ссылку).

Панель: блок «Устройства сети» со сводкой и таблицей онлайн-устройств.
Исправлены названия телевизоров (были MAC вместо имён).
2026-10-20 16:23:17 +03:00

5.0 KiB
Raw Permalink Blame History

Устройства сети в хабе и Home Assistant

Опознание устройств

device_ident.py берёт список клиентов из Keenetic (/rci/show/ip/hotspot), определяет бренд по MAC (локальная база nmap) и тип по имени, портам и бренду. Результат пишется в ядро: коллекция devices.

устройств: 106, онлайн: 42
по типам: контейнер 72 · телевизор 5 · компьютер 4 · консоль 3 ·
          роутер 3 · IoT 2 · колонка 2 · телефон 2 · техника 2 · …

Уточнения по MAC (там, где имя пустое):

MAC Что
c4:8b:66 телевизор Chromecast «Гостиная»
14:ea:63 телевизор Chromecast «Smart TV Pro»
e8:51:77 телевизор Hisense
48:9e:9d «тв Родители кабинет»
d4:f7:d5 PlayStation 5

Страница

/devices.html — таблица с фильтрами по типу, поиском, отметкой «только онлайн». Доступна из панели и по адресу https://status.buryans.ru/hub/devices.html.

Home Assistant

HA (CT 106, 2026.2.3) был почти пустым: 11 сущностей, ни одного медиаплеера.

Добавлено:

  • Google Cast через config flow (POST /api/config/config_entries/flow с handler: cast, затем POST {}) — интеграция загружена; телевизоры появятся как media_player, когда будут включены.
  • Ping для 9 ключевых устройств: два ТВ, две колонки, два роутера, Proxmox, Tuya, PlayStation. Создано 9 binary_sensor.

Доступ к API HA

Токена не было, доверенные сети не покрывали наш адрес. Решение — подписать JWT ключом из .storage/auth (как это делает сам HA):

md5  = md5(login:realm:password) — не нужен
jwt  = HS256({"iss": <refresh_token_id>, "iat": …, "exp": …}, jwt_key)

Скрипт ha_token.py запускается внутри CT 106 (путь /opt/smart-lxc/homeassistant/config/.storage/auth), выбирает активного пользователя и кладёт токен в /root/.ha-token. Токен живёт 30 минут.

Что не сработало

  • nmap_tracker через YAML. В HA 2026.2 платформы device_tracker переведены на config flow: YAML даёт ValueError: Unable to determine type for nmap_tracker: None.
  • nmap_tracker через flow. Интеграция создаётся и loaded, но сущности не появляются (0 трекеров), даже после reload.
  • Поэтому для «всех устройств» используется своя страница в хабе, а в HA — ping-сенсоры для ключевых.

Данные из роутера

Инвентарь целиком берётся из Keenetic (/rci/show/ip/hotspot): имена, MAC, IP тех, кто в сети. Обновление — каждые 30 минут (/etc/cron.d/hub-devices), результат в ядре: коллекция devices.

устройств: 104 · онлайн: 43
контейнер 73 · устройство 5 · телевизор 5 · компьютер 3 · роутер 3 · консоль 3
колонка 2 · IoT 2 · телефон 2 · техника 2 · сервер · микроконтроллер ·
увлажнитель · пылесос

Команды бота

!устройства              сводка по типам и онлайну
!устройства телевизор    список телевизоров
!устройства колонка      список колонок
!тв                      состояние телевизоров
!тв пауза / !тв стоп     управление
!тв включи <ссылка>      проиграть ссылку

Пример:

**Устройства сети** — 104, онлайн 43

• контейнер: 73 (онлайн 34)
• телевизор: 5 (онлайн 0)
• колонка: 2 (онлайн 2)
• роутер: 3 (онлайн 2)
…

Панель

Блок «Устройства сети»: сводка (всего/онлайн/по типам), таблица онлайн-устройств без контейнеров и ссылка на /devices.html.

Что осталось

Пять телевизоров сейчас офлайн — поэтому !тв отвечает «включите ТВ». Как только включатся: появятся в HA как media_player (интеграция Google Cast уже загружена) и станут доступны для каста.