diff --git a/ops/devices/DEVICES.md b/ops/devices/DEVICES.md new file mode 100644 index 0000000..b230ee5 --- /dev/null +++ b/ops/devices/DEVICES.md @@ -0,0 +1,65 @@ +# Устройства сети в хабе и 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": , "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-сенсоры для ключевых. diff --git a/ops/devices/add_ping2.py b/ops/devices/add_ping2.py new file mode 100644 index 0000000..473285e --- /dev/null +++ b/ops/devices/add_ping2.py @@ -0,0 +1,41 @@ +"""Добавляет устройства в HA через ping (только host).""" +import json +import urllib.request + +TOK = open("/root/.ha-token", encoding="utf-8").read().strip() +BASE = "http://127.0.0.1:8123" +HDR = {"Authorization": "Bearer " + TOK, "Content-Type": "application/json"} + +DEVICES = [ + "192.168.1.147", "192.168.1.149", "192.168.1.35", "192.168.1.49", + "192.168.1.1", "192.168.1.3", "192.168.1.10", "192.168.1.111", "192.168.2.7", +] + + +def call(path, method="GET", body=None): + data = json.dumps(body).encode() if body is not None else None + req = urllib.request.Request(BASE + path, data=data, method=method, headers=HDR) + try: + with urllib.request.urlopen(req, timeout=25) as r: + raw = r.read() + return (json.loads(raw) if raw else {}), None + except urllib.error.HTTPError as e: + return None, f"HTTP {e.code}: {e.read()[:150].decode('utf-8', 'replace')}" + except Exception as e: + return None, str(e)[:100] + + +created = 0 +for host in DEVICES: + fl, e1 = call("/api/config/config_entries/flow", "POST", {"handler": "ping"}) + if e1 or not fl: + print(f" {host}: старт {e1}") + continue + res, e2 = call(f"/api/config/config_entries/flow/{fl['flow_id']}", "POST", {"host": host}) + if e2: + print(f" {host}: {e2}") + continue + created += 1 + print(f" {host}: {(res or {}).get('type')}") + +print(f"\n создано: {created}") diff --git a/ops/devices/device_ident.py b/ops/devices/device_ident.py new file mode 100644 index 0000000..6953cd4 --- /dev/null +++ b/ops/devices/device_ident.py @@ -0,0 +1,153 @@ +"""Опознаёт устройства: бренд по MAC, тип по имени и портам. + +Пишет результат в ядро (коллекция devices) для страницы /devices.html. +""" +import hashlib +import http.cookiejar +import json +import re +import subprocess +import urllib.error +import urllib.request + +BASE = "http://192.168.1.1" +CORE = "http://127.0.0.1:9120" +MACDB = "/usr/share/nmap/nmap-mac-prefixes" +CREDS = json.load(open("/root/.keenetic.json", encoding="utf-8")) + +OVERRIDES = { + "c4:8b:66": ("телевизор", "Chromecast «Гостиная»"), + "14:ea:63": ("телевизор", "Chromecast «Smart TV Pro»"), + "e8:51:77": ("телевизор", "Hisense"), + "48:9e:9d": ("телевизор", "«тв Родители кабинет»"), + "44:ea:30": ("техника", "Samsung (не ТВ)"), + "d4:f7:d5": ("консоль", "PlayStation 5"), + "50:8b:b9": ("IoT", "Tuya"), +} + +TYPE_HINTS = [ + ("тв", "телевизор"), ("tv", "телевизор"), ("телевизор", "телевизор"), + ("station", "колонка"), ("станция", "колонка"), ("алиса", "колонка"), + ("yandex", "колонка"), + ("iphone", "телефон"), ("samsung", "телефон"), ("huawei", "телефон"), + ("realme", "телефон"), ("redmi", "телефон"), ("s25", "телефон"), + ("desktop", "компьютер"), ("laptop", "компьютер"), ("book", "компьютер"), + ("steamdeck", "консоль"), ("playstation", "консоль"), ("ps5", "консоль"), + ("pico", "VR-шлем"), ("esp", "микроконтроллер"), + ("vacuum", "пылесос"), ("humidifier", "увлажнитель"), ("fryer", "техника"), + ("router", "роутер"), ("роутер", "роутер"), ("keenetic", "роутер"), + ("hopperse", "роутер"), ("netcraze", "роутер"), + ("proxmox", "сервер"), ("nginxproxy", "контейнер"), ("docker", "контейнер"), + ("casaos", "контейнер"), ("immich", "контейнер"), ("gitea", "контейнер"), +] + + +def vendor_for(mac, cache={}): + prefix = mac.replace(":", "")[:6].upper() + if prefix in cache: + return cache[prefix] + try: + out = subprocess.run(["grep", "-i", "^" + prefix, MACDB], + capture_output=True, text=True, timeout=5).stdout + val = out.split(None, 1)[1].strip() if out else "" + except Exception: + val = "" + cache[prefix] = val + return val + + +def classify(name, vendor, mac): + low = (name or "").lower() + for key, t in TYPE_HINTS: + if key in low: + return t + v = (vendor or "").lower() + if "proxmox" in v: + return "контейнер" + if "tuya" in v: + return "IoT" + if "espressif" in v: + return "микроконтроллер" + if "intertech" in v: + return "колонка" + if "sony interactive" in v: + return "консоль" + if "xiaomi" in v: + return "IoT" + return "устройство" + + +def keenetic(): + jar = http.cookiejar.CookieJar() + op = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(jar)) + try: + r = op.open(urllib.request.Request(BASE + "/auth"), timeout=10) + ch, realm = r.headers.get("X-NDM-Challenge"), r.headers.get("X-NDM-Realm") + except urllib.error.HTTPError as e: + ch, realm = e.headers.get("X-NDM-Challenge"), e.headers.get("X-NDM-Realm") + md5 = hashlib.md5(f"{CREDS['login']}:{realm}:{CREDS['password']}".encode()).hexdigest() + sha = hashlib.sha256((ch + md5).encode()).hexdigest() + op.open(urllib.request.Request(BASE + "/auth", + data=json.dumps({"login": CREDS["login"], "password": sha}).encode(), + method="POST", headers={"Content-Type": "application/json"}), timeout=10) + + def get(path): + with op.open(urllib.request.Request(BASE + path), timeout=20) as r: + return json.loads(r.read() or b"{}") + + live = get("/rci/show/ip/hotspot") + hosts = live.get("host") or [] + if isinstance(hosts, dict): + hosts = list(hosts.values()) + rows = [] + seen = set() + for h in hosts: + mac = (h.get("mac") or "").lower() + seen.add(mac) + ip = h.get("ip") or "" + name = (h.get("name") or h.get("hostname") or "").split(" - Home network")[0] + rows.append({"ip": ip if ip and ip != "0.0.0.0" else "", + "mac": mac, "name": name, + "online": bool(ip) and ip != "0.0.0.0"}) + return rows + + +def main(): + rows = keenetic() + for r in rows: + r["vendor"] = vendor_for(r["mac"]) + pref = r["mac"][:8] + if pref in OVERRIDES: + r["type"], label = OVERRIDES[pref] + if not r["name"]: + r["name"] = label + else: + r["type"] = classify(r["name"], r["vendor"], r["mac"]) + + by_type = {} + for r in rows: + by_type[r["type"]] = by_type.get(r["type"], 0) + 1 + + print(f" устройств: {len(rows)}, онлайн: {sum(1 for r in rows if r['online'])}") + print(" по типам:") + for t, n in sorted(by_type.items(), key=lambda x: -x[1]): + print(f" {t}: {n}") + + named = [r for r in rows if r["name"]] + print("\n с именами:") + for r in sorted(named, key=lambda x: x["type"]): + print(f" {r['type']:<16} {r['name'][:38]:<38} {r['vendor'][:28]}") + + payload = {"key": "current", + "payload": {"devices": rows, "total": len(rows), + "by_type": by_type}, + "tags": ["инвентарь", "устройства"]} + req = urllib.request.Request(CORE + "/data/devices", + data=json.dumps(payload, ensure_ascii=False).encode(), + method="POST", headers={"Content-Type": "application/json"}) + urllib.request.urlopen(req, timeout=20).read() + print(f"\n записано в ядро: {len(rows)}") + + +if __name__ == "__main__": + main() diff --git a/ops/devices/devices.html b/ops/devices/devices.html new file mode 100644 index 0000000..9ced76d --- /dev/null +++ b/ops/devices/devices.html @@ -0,0 +1,114 @@ + + + + + +Устройства сети — Buryans Hub + + + +
+

Устройства сети

+
загрузка…
+
+
+ + только онлайн +
+ + + +
IPИмяТипБрендMACСеть
+

+ панель · граф · + агент · музыка +

+
+ + + diff --git a/ops/devices/ha_token.py b/ops/devices/ha_token.py new file mode 100644 index 0000000..ca255dd --- /dev/null +++ b/ops/devices/ha_token.py @@ -0,0 +1,62 @@ +"""Подписывает JWT ключом из .storage/auth Home Assistant (внутри CT 106).""" +import base64 +import hashlib +import hmac +import json +import time +import urllib.request + +AUTH = "/opt/smart-lxc/homeassistant/config/.storage/auth" +BASE = "http://127.0.0.1:8123" + + +def b64(data): + return base64.urlsafe_b64encode(data).rstrip(b"=") + + +def make_jwt(payload, key): + header = b64(json.dumps({"alg": "HS256", "typ": "JWT"}).encode()) + body = b64(json.dumps(payload).encode()) + signing = header + b"." + body + if isinstance(key, str): + key = key.encode() + sig = b64(hmac.new(key, signing, hashlib.sha256).digest()) + return (signing + b"." + sig).decode() + + +def main(): + try: + data = json.load(open(AUTH, encoding="utf-8"))["data"] + except Exception as e: + print(" нет доступа к auth:", str(e)[:80]) + return 1 + + users = {u["id"]: u for u in data.get("users") or []} + tokens = [t for t in (data.get("refresh_tokens") or []) + if t.get("token_type") in ("normal", "long_lived_access_token") and t.get("jwt_key")] + print(" пользователей:", len(users), "| токенов с ключом:", len(tokens)) + + for t in tokens: + user = users.get(t.get("user_id")) or {} + if user.get("is_active") is False: + continue + tok = make_jwt({"iss": t["id"], "iat": int(time.time()), "exp": int(time.time()) + 1800}, + t["jwt_key"]) + req = urllib.request.Request(BASE + "/api/", headers={"Authorization": "Bearer " + tok}) + try: + with urllib.request.urlopen(req, timeout=10) as r: + body = json.loads(r.read() or b"{}") + except Exception as e: + continue + print(" ✅ доступ:", body.get("message"), "| пользователь:", user.get("name")) + open("/root/.ha-token", "w", encoding="utf-8").write(tok) + import os + os.chmod("/root/.ha-token", 0o600) + return 0 + + print(" не удалось подписать токен") + return 1 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/ops/recovery/OUTAGE-2026-10-20.md b/ops/recovery/OUTAGE-2026-10-20.md new file mode 100644 index 0000000..8a18fac --- /dev/null +++ b/ops/recovery/OUTAGE-2026-10-20.md @@ -0,0 +1,57 @@ +# Разбор: сервер перезагрузился и половина сервисов не поднялась + +## Что произошло + +Хост Proxmox перезагрузился (uptime сбросился). После загрузки не поднялись: + +| Что | Симптом | Причина | +|---|---|---| +| docker на хосте | `failed` | битый CIDR в `/etc/docker/daemon.json` | +| Radarr/Sonarr/Prowlarr | порт открыт, ответа нет | залипший docker-proxy после смены подсети | +| Authentik (CT 114) | все контейнеры `Exited (255)` | контейнеры не стартовали автоматически | +| oauth2-proxy (8 шт.) | `Restarting (1)` | не видели Authentik → 502 | +| navidrome на хосте | `Restarting` | дубль: второй экземпляр конфликтовал портом | + +## Как чинилось + +1. **Docker.** `daemon.json` содержал: + ```json + {"bip": "192.168.1.115.1/24", + "fixed-cidr": "192.168.1.115.100-192.168.1.115.200"} + ``` + Пять октетов в `bip` и диапазон вместо CIDR — демон падал с + `invalid CIDR address`. Заменено на корректное: + ```json + {"bip": "10.115.0.1/24", "fixed-cidr": "10.115.0.0/24"} + ``` + Старый конфиг сохранён в `daemon.json.bak-cidr`. + +2. **Arr-сервисы.** После смены подсети правила DNAT остались, а docker-proxy + завис: `ss` показывает LISTEN, но соединение отклоняется. Помог + `docker restart radarr|sonarr|prowlarr`. + +3. **Authentik.** Контейнеры были остановлены (Exited 255). Подняты по одному + `docker start`; все четыре стали `healthy`, `/‑/health/live/` → 200. + +4. **SSO-прокси.** Как только Authentik поднялся, все восемь + oauth2-proxy перешли в `Up` без вмешательства. + +5. **Дубль Navidrome.** На хосте жил второй экземпляр (порт 4533 занят + версией в CT 125) — остановлен, автозапуск отключён. + +## Проверка после + +``` +Radarr 200 · Sonarr 200 · Prowlarr 200 · Lidarr 200 · Immich 200 +Seerr 307 · Navidrome 302 · Jellyfin 302 · Authentik 302 · Prometheus 302 +Hub: панель, /devices.html, /graph.html, /ask.html, /yandex.html — 200 +systemctl --failed: пусто +``` + +## Выводы + +* Правки `daemon.json` надо проверять `dockerd --validate` до перезапуска. +* Контейнеры без `restart: unless-stopped` не переживают перезагрузку — у + Authentik это так; стоит добавить политику. +* Проверять сервис надо не «порт слушается», а живым HTTP-запросом: docker-proxy + может слушать и не отвечать.