From 7eb16614d51dbf78e4f872c7c6fe5199254c4d23 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Tue, 20 Oct 2026 18:39:36 +0300 Subject: [PATCH] =?UTF-8?q?HA:=20REST-=D1=81=D0=B5=D0=BD=D1=81=D0=BE=D1=80?= =?UTF-8?q?=D1=8B=20Proxmox,=20Authentik,=20Prometheus?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Создан API-токен monitoring@pve!ha-token с ролью PVEAuditor; добавлены сенсоры: CPU, RAM, uptime, диск Proxmox; число пользователей Authentik; онлайн-цели Prometheus. Интеграция proxmoxve из HACS сущностей не создаёт — заменена сенсорами. Frigate API и Jellyfin-ключ недоступны; Uptime Kuma не имеет REST (socket.io), но 18 мониторов уже работают. --- ops/homeassistant/SENSORS.md | 47 +++++++++++++++++ ops/homeassistant/add_more.py | 78 ++++++++++++++++++++++++++++ ops/homeassistant/add_pve_sensors.py | 76 +++++++++++++++++++++++++++ ops/homeassistant/pve_fix3.py | 61 ++++++++++++++++++++++ 4 files changed, 262 insertions(+) create mode 100644 ops/homeassistant/SENSORS.md create mode 100644 ops/homeassistant/add_more.py create mode 100644 ops/homeassistant/add_pve_sensors.py create mode 100644 ops/homeassistant/pve_fix3.py diff --git a/ops/homeassistant/SENSORS.md b/ops/homeassistant/SENSORS.md new file mode 100644 index 0000000..8feeb19 --- /dev/null +++ b/ops/homeassistant/SENSORS.md @@ -0,0 +1,47 @@ +# REST-сенсоры HA для инфраструктуры + +Подключены через блок `rest:` в `configuration.yaml` (важно: **внутрь +существующего блока**, второй ключ `rest:` в файле недопустим). + +## Proxmox + +Токен: `monitoring@pve!ha-token`, роль **PVEAuditor** на `/` +(`pveum acl modify / --users monitoring@pve --roles PVEAuditor`). +Секрет в `secrets.yaml`: `pve_token_header` = `PVEAPIToken=...`. + +``` +sensor.proxmox_cpu 25.6 % +sensor.proxmox_ram 63.5 % +sensor.proxmox_ram_zaniato 9.8 ГБ +sensor.proxmox_uptime 2.7 ч +sensor.proxmox_disk_zaniato 24.5 ГБ +``` + +## Прочие сервисы + +``` +sensor.authentik_polzovatelei 11 +sensor.prometheus_tselei_onlain 34 +sensor.navidrome_status (пусто — формат ответа иной) +``` + +## Что не удалось + +* **Интеграция `dougiteixeira/proxmoxve` (HACS).** Установлена, токен + принят, но сущностей не создаёт (0 записей в реестре) даже при явном + выборе узла `pve` и с правами аудитора. Заменена REST-сенсорами. +* **Frigate API.** `/api/*` на 8080 отдаёт SPA, на 5000 порт закрыт — + API за авторизацией, сенсоры не сделаны. +* **Jellyfin API-ключ.** `JELLYFIN_KEY` из `bots.env` отдаёт 401 на + `/Items/Counts` — ключ недействителен. +* **Uptime Kuma.** В базе 18 мониторов (сервисы уже мониторятся), но + REST-API у Kuma нет: `/api/monitors` возвращает HTML-страницу, всё + общение идёт через socket.io. Ключ, вставленный в БД, для socket.io не + подошёл. + +## Ловушки + +1. Дублирование ключа `rest:` ломает конфиг — новые записи только внутрь + существующего блока. +2. `!secret` в заголовках работает: `Authorization: !secret `. +3. После правки YAML — `check_config` и перезапуск контейнера. diff --git a/ops/homeassistant/add_more.py b/ops/homeassistant/add_more.py new file mode 100644 index 0000000..3733f77 --- /dev/null +++ b/ops/homeassistant/add_more.py @@ -0,0 +1,78 @@ +"""Добавляет REST-сенсоры сервисов и убирает нерабочую запись proxmoxve.""" +import json +import os +import re +import urllib.request + +CFG = "/opt/smart-lxc/homeassistant/config/configuration.yaml" +SEC = "/opt/smart-lxc/homeassistant/config/secrets.yaml" +AK = open("/tmp/authentik-token", encoding="utf-8").read().strip() + +sec = open(SEC, encoding="utf-8").read() +if "authentik_api_token" not in sec: + with open(SEC, "a", encoding="utf-8") as f: + f.write(f'\nauthentik_api_token: "Bearer {AK}"\n') + print(" секрет Authentik добавлен") + +block = ''' - resource: http://192.168.1.114:9000/api/v3/core/users/?page_size=1 + headers: + Authorization: !secret authentik_api_token + scan_interval: 300 + sensor: + - name: "Authentik пользователей" + unique_id: authentik_users_count + value_template: "{{ value_json.pagination.count }}" + - resource: http://192.168.1.134:9090/api/v1/query?query=count(up%3D%3D1) + scan_interval: 120 + sensor: + - name: "Prometheus целей онлайн" + unique_id: prometheus_targets_up + value_template: "{{ value_json.data.result[0].value[1] | int }}" + - resource: http://192.168.1.125:4533/rest/ping.view + scan_interval: 180 + sensor: + - name: "Navidrome статус" + unique_id: navidrome_status + value_template: "{{ value_json['subsonic-response'].status }}" +''' + +s = open(CFG, encoding="utf-8").read() +if "authentik_users_count" in s: + print(" сенсоры уже есть") +else: + lines = s.split("\n") + start = next((i for i, l in enumerate(lines) if re.match(r"^rest:\s*$", l)), None) + if start is None: + s = s.rstrip() + "\n\nrest:\n" + block + else: + end = len(lines) + for j in range(start + 1, len(lines)): + if lines[j] and not lines[j].startswith((" ", "\t")) and not lines[j].startswith("#"): + end = j + break + lines[end:end] = block.split("\n") + s = "\n".join(lines) + open(CFG, "w", encoding="utf-8").write(s) + print(" сенсоры добавлены") + +# удаляем proxmoxve entry +TOK = open("/tmp/ha-token", encoding="utf-8").read().strip() +H = {"Authorization": "Bearer " + TOK, "Content-Type": "application/json"} + + +def call(p, m="GET", b=None): + d = json.dumps(b).encode() if b is not None else None + r = urllib.request.Request("http://127.0.0.1:8123" + p, data=d, method=m, headers=H) + try: + with urllib.request.urlopen(r, timeout=40) as x: + raw = x.read() + return (json.loads(raw) if raw else {}), None + except Exception as e: + return None, str(e)[:80] + + +entries, _ = call("/api/config/config_entries/entry") +for e in entries or []: + if e.get("domain") == "proxmoxve": + call(f"/api/config/config_entries/entry/{e['entry_id']}", "DELETE") + print(" proxmoxve-запись удалена (сущностей не создавала)") diff --git a/ops/homeassistant/add_pve_sensors.py b/ops/homeassistant/add_pve_sensors.py new file mode 100644 index 0000000..5313670 --- /dev/null +++ b/ops/homeassistant/add_pve_sensors.py @@ -0,0 +1,76 @@ +"""Добавляет сенсоры Proxmox в существующий блок rest: и секрет в secrets.yaml.""" +import io +import json +import re + +CFG = "/opt/smart-lxc/homeassistant/config/configuration.yaml" +SEC = "/opt/smart-lxc/homeassistant/config/secrets.yaml" +TOK = open("/tmp/pve-token", encoding="utf-8").read().strip() + +# 1. секрет +hdr = f"PVEAPIToken=monitoring@pve!ha-token={TOK}" +sec = open(SEC, encoding="utf-8").read() if __import__("os").path.exists(SEC) else "" +if "pve_token_header" not in sec: + with open(SEC, "a", encoding="utf-8") as f: + f.write(('' if sec.endswith("\n") or not sec else "\n") + f'pve_token_header: "{hdr}"\n') + print(" секрет добавлен") +else: + print(" секрет уже есть") + +# 2. блок сенсоров +block = ''' - resource: https://192.168.1.10:8006/api2/json/nodes/pve/status + verify_ssl: false + headers: + Authorization: !secret pve_token_header + scan_interval: 60 + sensor: + - name: "Proxmox CPU" + unique_id: proxmox_node_cpu + value_template: "{{ (value_json.data.cpu * 100) | round(1) }}" + unit_of_measurement: "%" + - name: "Proxmox RAM" + unique_id: proxmox_node_ram + value_template: "{{ ((value_json.data.memory.used / value_json.data.memory.total) * 100) | round(1) }}" + unit_of_measurement: "%" + - name: "Proxmox RAM занято" + unique_id: proxmox_node_ram_gb + value_template: "{{ (value_json.data.memory.used / 1073741824) | round(1) }}" + unit_of_measurement: "ГБ" + - name: "Proxmox Uptime" + unique_id: proxmox_node_uptime + value_template: "{{ (value_json.data.uptime / 3600) | round(1) }}" + unit_of_measurement: "ч" + - name: "Proxmox диск занято" + unique_id: proxmox_storage_used + value_template: "{{ (value_json.data.rootfs.used / 1073741824) | round(1) }}" + unit_of_measurement: "ГБ" +''' +lines = open(CFG, encoding="utf-8").read().splitlines() if False else open(CFG, encoding="utf-8").read().split("\n") + +if "proxmox_node_cpu" in "\n".join(lines): + print(" сенсоры уже есть") + raise SystemExit(0) + +# находим начало rest: +start = None +for i, line in enumerate(lines): + if re.match(r"^rest:\s*$", line): + start = i + break +if start is None: + with open(CFG, "a", encoding="utf-8") as f: + f.write("\nrest:\n" + block) + print(" создан новый блок rest:") +else: + end = len(lines) + for j in range(start + 1, len(lines)): + if lines[j] and not lines[j].startswith((" ", "\t")) and not lines[j].startswith("#"): + end = j + break + lines[end:end] = block.split("\n") + open(CFG, "w", encoding="utf-8").write("\n".join(lines)) + print(f" сенсоры вставлены в блок rest: (строки {start+1}..{end})") + +import yaml # noqa: E402 +yaml.safe_load(open(CFG, encoding="utf-8").read().replace("!secret", "")) +print(" YAML валиден") diff --git a/ops/homeassistant/pve_fix3.py b/ops/homeassistant/pve_fix3.py new file mode 100644 index 0000000..5060423 --- /dev/null +++ b/ops/homeassistant/pve_fix3.py @@ -0,0 +1,61 @@ +import json +import urllib.error +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"} + + +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=90) 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()[:250].decode('utf-8', 'replace')}" + except Exception as e: + return None, str(e)[:150] + + +flow, err = call("/api/config/config_entries/flow", "POST", {"handler": "proxmoxve"}) +fid = flow["flow_id"] +pve = open("/tmp/pve-token", encoding="utf-8").read().strip() +res, err = call(f"/api/config/config_entries/flow/{fid}", "POST", { + "host": "192.168.1.10", "port": 8006, "verify_ssl": False, + "username": "monitoring@pve", "token_name": "ha-token", + "password": pve, "realm": "pve", +}) +if err: + print("host:", err) + raise SystemExit(1) + +schema = res.get("data_schema") or [] +print("поля:", [f.get("name") for f in schema]) +payload = {} +for f in schema: + name = f.get("name") + opts = (f.get("selector") or {}).get("select", {}).get("options") + stype = f.get("type") + if opts and stype == "multi_select": + payload[name] = [o if isinstance(o, str) else o.get("value") for o in opts] + elif opts and stype == "select": + payload[name] = (o if isinstance(o, str) else o.get("value")) if opts else None + elif f.get("type") == "boolean": + payload[name] = bool(f.get("default", True)) + elif f.get("default") is not None: + payload[name] = f["default"] + else: + payload[name] = "" + +# обязательные поля, которых может не быть в схеме +payload.setdefault("entity_id_scheme", "standard") +payload.setdefault("entity_id_prefix", "") +payload.setdefault("disks_enable", True) +payload.setdefault("auto_discovery", True) +print("отправляю:", json.dumps(payload, ensure_ascii=False)[:400]) + +res2, err2 = call(f"/api/config/config_entries/flow/{fid}", "POST", payload) +print("итог:", err2 or (res2 or {}).get("type"), (res2 or {}).get("errors"))