HTML-Scrapen der Drucker-Statusseite ist fragil (grosse Seite, Werte teils in JS/Grafik). SNMP/Printer-MIB liefert die Fuellstaende als saubere Zahlen. - Dockerfile: net-snmp-CLI (Paket 'snmp') installiert. - satellite.py: Aktionen snmp.get / snmp.walk (generisch, params ip+oid) und snmp.printer (Komfort: liest prtMarkerSupplies aus der Printer-MIB und rechnet je Patrone name+level+max+percent). net-snmp via subprocess, numerische OIDs (keine MIB-Files noetig), -t2 -r1 + Timeout = schnell scheitern statt haengen. RFC-Sonderwerte (-1/-2 unbekannt, -3 vorhanden) behandelt. - CONTROL_ALLOWLIST-Default + .env.example um snmp.* erweitert, SNMP_*-Envs dokumentiert. - agent.py + seed_rules.py: satellite_command-Tool + Drucker-Beispiel — snmp. printer ist jetzt der BEVORZUGTE Weg fuer Tinte, http.get nur Fallback. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
48 lines
2.8 KiB
Bash
48 lines
2.8 KiB
Bash
# ─── ARIA Satellit — Konfiguration ──────────────────────────────────
|
|
# Kopiere diese Datei nach .env und passe sie an.
|
|
|
|
# RVS-Zugang (identisch zum Haupt-Stack — gleicher Raum/Token, damit ARIA
|
|
# diesen Satelliten erreicht). Werte aus der Haupt-.env / vom generate-token.sh.
|
|
RVS_HOST=rvs.example.de
|
|
RVS_PORT=443
|
|
RVS_TLS=true
|
|
RVS_TOKEN=
|
|
|
|
# ─── Identitaet / Adresse dieses Satelliten ────────────────────────
|
|
# SATELLITE_ID = technisch eindeutig (a-z0-9-_), Default = Hostname-Slug.
|
|
# SATELLITE_LOCATION = menschlicher Name, so spricht ARIA das Netz an ("Buero").
|
|
# Mehrere Satelliten koennen im selben RVS-Raum haengen — die Location
|
|
# unterscheidet sie ("Buero", "Zuhause", "Werkstatt").
|
|
SATELLITE_ID=buero
|
|
SATELLITE_LOCATION=Büro
|
|
|
|
# ─── Steuerung (Sicherheit!) ───────────────────────────────────────
|
|
# CONTROL_ENABLED=false → reiner Info-/Beobachtungs-Satellit (entdeckt & meldet
|
|
# nur, steuert nichts). Sicherste Basis.
|
|
# CONTROL_ENABLED=true → darf Geraete steuern (nur Aktionen aus der Allowlist).
|
|
CONTROL_ENABLED=true
|
|
# Erlaubte Steuer-Aktionen (kommagetrennt). Alles andere wird abgelehnt.
|
|
# dial.launch App-Launch via DIAL (z.B. YouTube-Video auf Fire TV / Smart-TV)
|
|
# wol Wake-on-LAN (Geraet per MAC aufwecken)
|
|
# http.get generischer HTTP-GET (z.B. lokale IoT-Webhooks, Statusseiten)
|
|
# http.post generischer HTTP-POST
|
|
# snmp.get einzelner SNMP-Wert (params: ip, oid)
|
|
# snmp.walk SNMP-Teilbaum (params: ip, oid)
|
|
# snmp.printer Drucker-Fuellstaende (Tinte/Toner) aus der Printer-MIB (params: ip)
|
|
CONTROL_ALLOWLIST=dial.launch,wol,http.get,snmp.get,snmp.walk,snmp.printer
|
|
|
|
# ─── SNMP (optional) ───────────────────────────────────────────────
|
|
# Defaults fuer die snmp.*-Aktionen; pro Request per params ueberschreibbar.
|
|
SNMP_COMMUNITY=public # Drucker antworten meist auf 'public'
|
|
SNMP_VERSION=2c # 1 | 2c
|
|
SNMP_TIMEOUT_SEC=5
|
|
|
|
# ─── HTTP (optional) ───────────────────────────────────────────────
|
|
HTTP_TIMEOUT_SEC=10 # Timeout fuer http.get/http.post
|
|
HTTP_MAX_CHARS=20000 # Default-Body-Ausschnitt (offset/max_chars pro Request)
|
|
|
|
# ─── Discovery-Tuning (optional) ───────────────────────────────────
|
|
SCAN_INTERVAL_SEC=300 # Hintergrund-Rescan-Intervall
|
|
DISCOVER_TIMEOUT_SEC=6 # Dauer eines Sweeps (mDNS + SSDP)
|
|
DEVICE_CACHE_TTL_SEC=120 # wie lange ein Inventar als "frisch" gilt
|