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

115 lines
5.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Устройства сети в хабе и 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 уже загружена) и станут доступны для каста.