Update
This commit is contained in:
@@ -0,0 +1,53 @@
|
||||
# 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:
|
||||
|
||||
```sh
|
||||
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):
|
||||
|
||||
```sh
|
||||
#!/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`
|
||||
Reference in New Issue
Block a user