titel: Panel steuer127 — wie neue Server-Strecken funktionieren
stand: 31.10.2026, 21:10
zweck: Nachschlagen, wie das Panel aufgebaut ist und wie man einen weiteren Server als Lernstrecke hinzufügt — samt aller Fallen, die am 31.10. Zeit gekostet haben.
| Teil | Pfad |
|---|---|
| Programm (Flask) | /home/steueruser1/panel/app.py |
| Seitenvorlage (Quelle) | /home/steueruser1/panel/index.html |
| Seite, die wirklich ausgeliefert wird | /var/www/steuer127/index.html |
| Schritt-Skripte | /home/steueruser1/panel/schritte/ |
| Protokolle der Läufe | /home/steueruser1/panel/logs/ |
| Dienst | steuer-panel.service (127.0.0.1:8080, davor nginx) |
| Adresse | https://steuer127.g3.local/ |
Wichtig: nginx liefert die Oberfläche als statische Datei aus
/var/www/steuer127/. Eine Änderung an panel/index.html wirkt erst, wenn sie
dorthin kopiert wird. Am 31.10. habe ich zwanzig Minuten lang eine Änderung
gesucht, die längst im Quellordner stand.
app.py führt ein Verzeichnis SERVER_SCHRITTE, Schlüssel (kennung, schritt), Wert (pfad zum Skript, Titel).
POST /api/server/<kennung>/schritt startet genau dieses Skript —ein Knopf, ein Playbook, keine freie Kommandozeile.
GET /api/lauf/<id>/strom (Server-Sent-Events) livein den Browser; die Zeilen werden eingefärbt.
POST /api/server/<kennung>/alles startet <kennung>-alles.sh (unterstützt VON und BIS). Der Knopf heißt im Panel „⏩ Ruck-Zuck".
Ein neuer Server braucht vier Dinge:
panel/schritte/, Namensschema neuNN-<schritt>-<kurzname>.sh. Jedes Skript:
ANSIBLE_CONFIG, ANSIBLE_HOST_KEY_CHECKING=False/root/.hcloud_env (für die Hetzner-API)neuNN.env (mit . davor — siehe Falle 3)ansible-playbook mit -l "$NAME" und --tagsRC und beendet sich bei Fehler mit exit $RCneuNN.env mit NAME=, IP=, DOMAIN=.neuNN-alles.sh, der die Schritte der Reihe nach aufruft.app.py — oder man lässt es automatisch machen: der Block WEITERE_LEHRWEGE liest alle neu01-…, neu03-…, neu08-… beim Start ein.
Für eine neue Kennung genügt es, sie in dieses Tupel zu schreiben.
<a class="eintrag" data-ziel="server" data-server="neuNN"> in index.html, dazu ein Eintrag in SERVER_WEG und in LEHRWEGE.
Erzeugt wurde das Ganze mit hilfsskripte/panel-neue-lehrwege.sh (Schritt-Skripte)
und hilfsskripte/panel-weitere-lehrwege.py (app.py + index.html).
/var/www/steuer127/ ausgeliefert, nicht aus dem Panel-Ordner. Änderung an index.html also immer dorthin kopieren.
import/Variablen erst nach dem Einfügen prüfen. Ein Patch hatte SCHRITT_ORDNER erst *benutzt*, dann geprüft, ob es existiert — dadurch wurde
die Definition nie eingefügt und das Panel lief in eine Neustart-Schleife
(NameError). Nach jedem Patch: python3 -c "import ast; ast.parse(...)"
und systemctl status prüfen.
.env wird eingelesen (. datei), nicht ausgeführt. In einem Sammellauf stand $(…/neu03.env; echo $NAME) — die Datei ist nicht
ausführbar, NAME blieb leer, alle folgenden Schritte liefen ins Leere.
suchte if name in s: — die Zeile # wegwerf-03-nextcloud … (gelöscht)
enthält den Namen, also wurde nie geschrieben. Jetzt: jede Zeile mit dem
Namen entfernen (auch auskommentierte), dann neu eintragen.
(neuNN-$n-*.sh). Hießen die Dateien neu03-3.sh, passte das Muster nicht
und der Lauf brach mit „Schritt 3 hat kein Skript" ab. Jetzt tragen alle
Schritte einen sprechenden Namen (neu03-3-grundausstattung.sh).
755, .env 644, Besitzer steueruser1. Als root erzeugte Dateien sind lesbar, aber der Dienst läuft als steueruser1.
Das ist gewollt; im Kopf steht noch „alle acht Schritte", auch wenn die
Strecke sieben hat.
systemctl is-active steuer-panel.service # active
curl -s http://127.0.0.1:8080/api/schritte # alle Schritte als JSON
curl -s -X POST -H 'Content-Type: application/json' -d '{}' \
http://127.0.0.1:8080/api/server/neu99/alles # muss "Skript fehlt" melden
curl -sk -H 'Host: steuer127.g3.local' https://127.0.0.1/ | grep data-server
Der dritte Aufruf ist der beste Test: eine unbekannte Kennung muss eine
saubere Fehlermeldung bringen — dann ist die Route da, ohne dass etwas startet.
| Kennung | Panel-Eintrag | Server | Schritte |
|---|---|---|---|
neu05 | 10 · Ansible-Lehrweg | 05 Buttons | 8 |
neu09 | 11 · Audio/Telefon | 09 Audio | 8 |
neu01 | 12 · LiveKit / Telefonie | 01 LiveKit | 7 |
neu03 | 13 · Nextcloud / Avatar | 03 Nextcloud | 7 |
neu08 | 14 · VPN / headscale | 08 headscale | 6 |
Der erste vollständige Ruck-Zuck-Lauf über die Oberfläche (Strecke 13,
31.10.2026, 20:36–20:54) liegt als Protokoll im Projekt:
docs\belege\20261031-203629-neu03-alles.log. Er zeigt je Schritt die
Ansible-Ausgabe, die PLAY RECAPs und die Abnahme — genau das, was im Panel
rechts mitläuft. Ausgewertet in docs\29-SERVER03-WIEDERAUFBAU.md Abschnitt 7.