Files
syno-scripts/HOMELAB/README.md
T
2026-10-15 12:21:26 +02:00

3.9 KiB

HOMELAB

Lokale Webseite für eine Synology DS1817+ mit DSM 7.3.2 als Zielplattform. Hauptseite /, DSM-Unterseite /dsm. Keine externen Dienste, Schriftarten oder Bibliotheken.

Umfang

  • CPU und RAM, aktuelle Übertragungsraten und Verlauf der letzten 60 Messungen.
  • Physische Netzwerkschnittstellen mit Verbindungsstatus. Das ist NAS-Traffic, kein Router-/Internet-Monitoring. Bond- und Bridge-Interfaces werden nicht zusätzlich summiert.
  • SMART-Gesamtzustand, Temperatur und Warnung bei SMART-Fehlerbits. Unlesbare oder schlafende Laufwerke bleiben „Unbekannt“. Keine Tests oder Änderungen an Laufwerken.
  • LVM-Poolkapazitäten (zugewiesen/frei), Volume-Kapazitäten (belegt/frei), Linux-RAID-Zustand und Synchronisierungsaktion. DSM-Poolnamen und SHR-Zuordnung sind noch nicht auf dem Gerät validiert. LVM- und RAID-Zeilen sind keine garantierte Eins-zu-eins-Zuordnung zu DSM-Speicherpools.
  • DNS-Paketneustart mit Dialog, Authentifizierung und 60 Sekunden Sperre zwischen Versuchen.

Lokale Vorschau

Python 3 wird benötigt, keine zusätzlichen Pakete:

python3 server.py --demo

Danach http://127.0.0.1:8787 öffnen. Alle Werte sind ausdrücklich Beispieldaten; Neustart ist gesperrt.

Auf dem NAS starten

Die Einrichtung auf dem NAS wurde noch nicht ausgeführt. Python 3 muss dort vorhanden sein. Den gesamten Ordner beispielsweise nach /volume1/homelab kopieren und den tatsächlichen Python-Pfad verwenden. Programmdateien und Schlüsseldatei dürfen bei Ausführung als root nur für Administratoren schreibbar sein.

Einmal einen zufälligen Schlüssel erzeugen und in einer nur für root lesbaren Datei speichern, zum Beispiel /volume1/homelab/token. Erzeugung mit Python: python3 -c 'import secrets; print(secrets.token_urlsafe(32))'. Datei nicht in Git speichern. Den Schlüssel später im Dashboard eingeben; er wird nicht im Browser gespeichert.

Startskript für einen DSM-Aufgabenplaner-Task „Beim Hochfahren“, Benutzer root (Pfade anpassen):

#!/bin/sh
export HOMELAB_TOKEN="$(cat /volume1/homelab/token)"
# Erst nach Prüfung, dass das Synology-Paket DNSServer installiert ist:
# export HOMELAB_ALLOW_DNS_RESTART=1
exec /usr/local/bin/python3 /volume1/homelab/server.py --host 127.0.0.1 --port 8787

Der Dienst bindet standardmäßig nur an Loopback. In DSM einen HTTPS-Reverse-Proxy auf http://127.0.0.1:8787 einrichten und über den lokalen Hostnamen öffnen. Den gesamten Pfad / weiterleiten. Kein öffentliches Portforwarding erforderlich. Für einen direkten LAN-Test kann --host NAS-LAN-IP verwendet werden; den Zugriffsschlüssel nur über HTTPS oder einen verschlüsselten Tunnel übertragen.

Das Backend benötigt erhöhte Leserechte für SMART/LVM; der optionale Paketneustart benötigt Verwaltungsrechte. Es führt ausschließlich den festen Befehl /usr/syno/bin/synopkg restart DNSServer aus. Keine frei übergebenen Shell-Befehle und keine DSM-Kennwörter im Frontend. Vor Aktivierung auf dem NAS die Existenz dieses Programms und des Pakets prüfen. Neustartbefehl und PID-Pfad sind auf DSM 7.3.2 noch nicht verifiziert. Ein erfolgreicher Befehl ist kein Nachweis einer erfolgreichen DNS-Anfrage.

Grenzen und Prüfung auf dem NAS

  • Noch keine Verbindung zu einer echten DS1817+; die Kompatibilität muss dort geprüft werden.
  • SMART wird höchstens alle 60 Sekunden gelesen (smartctl -n standby -a). Fehlende Programme oder Berechtigungen ergeben unbekannte Werte.
  • Die erste CPU-/Netzwerkmessung benötigt eine zweite Abfrage. Keine dauerhafte Messwertspeicherung.
  • DNS-Status über /var/packages/DNSServer/target/var/named.pid; falls dieser Pfad abweicht, „Unbekannt“. Keine geratenen Erfolgszustände.
  • Falls LVM auf dem Gerät nicht verfügbar ist, bleiben Poolkapazitäten offen; Volume-Werte werden unabhängig davon angezeigt.
  • Python-Standard-HTTP-Server für ein privates Netz hinter dem DSM-Reverse-Proxy; nicht direkt ins Internet stellen.

Tests: python3 -m unittest discover -s tests -v