titel: Anleitung — Steuerserver 192.168.0.127 von null auf bedienbar
erstellt: 2026-10-28
tags: [anleitung, steuer127, dns, mkcert, nginx, putty, ansible]
.127 von null auf bedienbarDiese Anleitung ist nach dem ersten Durchlauf geschrieben — mit allen
Fehlern, die dabei passiert sind. Wer sie in dieser Reihenfolge abarbeitet,
braucht etwa zwanzig Minuten statt eines halben Tages.
ISO bauen → installieren → Snapshot → Ansible → DNS-Name
→ mkcert → nginx mit TLS → PuTTY-Starter → Knöpfe
Einzelheiten in 03-ISO-BAU.md. Kurzfassung der drei Fallen:
interchange_level=4 in pycdlib, sonst keine Namen mit Punkt.patch-bootinfo.py nach dem Bauen ausführen — ohne dieBoot-Informations-Tabelle startet isolinux stumm nicht.
isolinux.cfg ohne Menü, timeout 10, nur ein Eintrag.Preseed-Werte (C:\iso-build\deb12\preseed.cfg): feste Adresse
192.168.0.127/24, Tor 192.168.0.254, Benutzer steueruser1,
SSH-Schlüssel, ganze Platte, kein LVM.
Der Preseed steckt in der Initrd (inject-preseed.py, Eintrag vor
TRAILER!!!). Auf der Startzeile kein preseed/file= setzen.
Bekannte Restbaustelle: der Installer fragt die Sprache ab. Ein Klick
im VM-Fenster, dann läuft der Rest allein durch. Dauerhaft lösen: Preseed
über Netz (preseed/url=) oder Diskette (preseed/file=/dev/fd0).
VM: 2 vCPU, 2 GB RAM, 40 GB mitwachsend, Brücke, MAC
00:50:56:20:01:27. Nach etwa drei Minuten:
ssh -i C:\Users\pc2\.ssh\steuer steueruser1@192.168.0.127
Ohne -i nimmt Windows den Standardschlüssel id_ed25519 — der passt
nicht, dann kommt „Permission denied".
vmrun -T ws snapshot C:\vms\steuer127\steuer127.vmx frisch-installiert-20261028
Das Playbook braucht become. Einmal per Passwort:
echo 'Steuer2026!' | sudo -S install -m 0440 -o root -g root <datei> /etc/sudoers.d/90-steueruser1
scp -r <vault>\02-Projekte\Ansible-Serveraufbau steueruser1@192.168.0.127:/home/steueruser1/
ssh … 'sudo apt-get install -y ansible'
ssh … 'cd ~/Ansible-Serveraufbau && ansible-playbook -i inventory/steuerserver.ini playbooks/01-steuerserver.yml'
Ergebnis beim ersten Lauf: 15 ok, 9 geändert, 0 Fehler.
Der Selbstbericht des Servers liegt danach in /root/work/IST-ZUSTAND.txt.
Zwei Dinge getrennt halten:
| Wer fragt | Weg |
|---|---|
| der Windows-PC | Hosts-Datei — denn der PC fragt Tailscale MagicDNS, nicht den BIND |
| alle anderen Rechner | BIND auf .100, Zone g3.local |
Hosts-Zeile (C:\Windows\System32\drivers\etc\hosts, als Administrator):
192.168.0.127 steuer127.g3.local steuer127
BIND auf .100 (VM D:\Clone of 1-dnsserverabgesichertubuntu18\DNS2.vmx,
Anmeldung root mit Schlüssel C:\Users\pc2\.ssh\dns100):
cp -a /etc/bind /root/backup-dns-<datum>/bind-etc/etc/bind/zones/db.g3.local anlegen (Vorlage: db.g.local)named-checkzone g3.local /etc/bind/zones/db.g3.local — muss OK sagen/etc/bind/named.conf.local: zone "g3.local" { type master; file "/etc/bind/zones/db.g3.local"; };
named-checkconf — muss OK sagensystemctl reload bind9nslookup steuer127.g3.local 192.168.0.100Serial nicht vergessen (2026102801 im SOA), sonst merkt ein zweiter
Namensserver die Änderung nicht.
Der PC löst über magicdns.localhost-tailscale-daemon auf (Tailscale).
Der Adapter-Eintrag 192.168.0.100 wird dabei übersprungen. Wer es
richtig will, trägt g3.local in der Tailscale-Verwaltung als geteilte
DNS-Zone ein (Split DNS). Bis dahin: Hosts-Datei.
C:\Users\pc2\vault\tools\mkcert.exe -install (als Administrator)
C:\Users\pc2\vault\tools\mkcert.exe -cert-file steuer127.pem -key-file steuer127-key.pem `
steuer127.g3.local www.g3.local steuer127 192.168.0.127
C:\Users\pc2\AppData\Local\mkcertWindows ausdrücklich „Firefox support is not available". Lösung:
C:\Program Files\Mozilla Firefox\distribution\policies.json:
{ "policies": { "Certificates": { "Install": [
"C:\\Users\\pc2\\AppData\\Local\\mkcert\\rootCA.pem" ] } } }
Danach Firefox einmal ganz beenden und neu starten.
sudo apt-get install -y nginx
# Zertifikat nach /etc/ssl/steuer127/ (pem 644, key 600)
# /etc/nginx/sites-available/steuer127 (Vorlage: C:\vms\steuer127\nginx-steuer127.conf)
sudo ln -sf /etc/nginx/sites-available/steuer127 /etc/nginx/sites-enabled/steuer127
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo systemctl reload nginx
Falle: http2 on; kennt nginx 1.22 (Debian 12) nicht. Richtig ist
listen 443 ssl http2;.
Probe vom PC: https://steuer127.g3.local → 200, Schloss ohne Warnung.
C:\Users\pc2\vault\tools\putty-127-auto.cmd:
start "" "C:\Program Files\PuTTY\putty.exe" -ssh steueruser1@192.168.0.127 -P 22 -pw "Steuer2026!"
Verknüpfung daneben: putty-127-auto - Verknüpfung.lnk, Ziel ist die
.cmd, Symbol aus putty.exe.
Falle: PuTTY 0.85 liest das neue OpenSSH-Schlüsselformat hier nicht,
und puttygen.exe lässt sich nicht per Kommandozeile aufrufen (endet
stumm mit Code 1). Deshalb Passwortanmeldung. Wer den Schlüssel will,
muss ihn einmal über die puttygen-Oberfläche umwandeln.
Anheften: Rechtsklick auf die Verknüpfung → „An Taskleiste anheften".
Windows 11 lässt sich das nicht per Skript abnehmen.
Aufbau wie bei den großen Panels (Hetzner, Hostinger): **links die
Navigation, rechts der Inhalt, unten die mitlaufende Ausgabe.**
https://steuer127.g3.local
| Teil | Datei / Ort |
|---|---|
| Aussehen und Bedienung | /var/www/steuer127/index.html (eine Datei, kein Bauen nötig) |
| Dienst für die Aufträge | /home/steueruser1/panel/app.py, systemd-Einheit steuer-panel |
| Dienst horcht auf | 127.0.0.1:8080 — nach außen nur über nginx mit TLS |
| Protokolle der Läufe | /home/steueruser1/panel/logs/ |
| Playbooks | /home/steueruser1/Ansible-Serveraufbau |
Was aufrufbar ist, steht in der Liste im Dienst. Es gibt bewusst
keine freie Befehlszeile — ein Panel, das beliebige Befehle ausführt,
wäre ein offenes Tor im Netz. Drei Aufträge sind eingetragen:
| Knopf | Playbook | Wirkung |
|---|---|---|
| Prüfen | 01-steuerserver.yml | Trockenlauf mit --check --diff, ändert nichts |
| Einrichten | 01-steuerserver.yml | echter Lauf |
| Wegwerfserver planen | 00-server-anlegen.yml | Trockenlauf, legt nichts an |
Ein Knopf = ein Playbook-Aufruf. Keine eigene Logik, die es auf der
Kommandozeile nicht auch gibt.
Der Dienst startet ansible-playbook, liest dessen Ausgabe Zeile für
Zeile und schickt sie über Server-Sent Events an den Browser.
Wichtig dabei:
proxy_buffering off; in nginx — sonst kommen die Zeilen gesammeltam Ende statt während des Laufs.
„Es läuft schon ein Auftrag" (HTTP 409).
| Prüfung | Ergebnis |
|---|---|
| Seite erreichbar | 200, 14 KB, TLS vertraut |
/api/uebersicht | Name, Netz, Platte, Ansible 2.14.18, nginx aktiv |
| Auftrag „Prüfen" | startet, Ausgabe kommt live, endet „erfolgreich" |
| Doppelter Start | abgelehnt mit 409 |
Ein Iframe hätte ein zweites Dokument gebraucht (die PuTTY-Ausgabe als
eigene Seite). Die Ausgabe direkt in die Konsole des Panels zu streamen
ist dasselbe Ergebnis ohne den Umweg — und man sieht Auftrag, Status und
Ausgabe in einem Blick.
vmrunvmrun geht hier nicht. Es ist ein Windows-Programm, liegt nur auf dem
PC, und die Maschinen liegen auf Windows-Datenträgern (D:, G:). Der
Steuerserver könnte es gar nicht aufrufen — auf .127 ist es nicht
vorhanden, nachgemessen.
**Richtig ist: die Webseite redet mit dem Programm, das VMware ohnehin
schon bedient.** Auf dem Windows-Rechner läuft ein VM-Dienst auf Port
3200 mit genau diesen Aufrufen:
| Aufruf | Wirkung |
|---|---|
GET /api/vm/list | alle Maschinen mit Name, Adresse, Zustand |
POST /api/vm/start/<id> | starten |
POST /api/vm/stop/<id> | anhalten |
GET /api/vm/status/<id> | Zustand einer Maschine |
Von .127 aus ist Port 3200 offen (nachgemessen), die Liste liefert
37 Maschinen. Das Panel reicht diese Aufrufe durch:
Browser → https://steuer127.g3.local/api/vms
→ nginx → 127.0.0.1:8080 (Panel)
→ http://192.168.0.80:3200/api/vm/list (Windows)
Also kein neuer Dienst und kein vmrun. Ein Menüpunkt „Virtuelle
Maschinen" im Panel, mit Filter, Zustand und Start/Anhalten.
Was das kostet: Für VM-Aufgaben muss der Windows-Rechner laufen — das
ist unvermeidlich, dort liegt VMware. Die Ansible-Seite dagegen läuft auf
.127 allein, auch wenn der PC aus ist.
list, start, stop, status. Snapshot müsste dort ergänzt werden
(vmrun snapshot auf dem PC), dann ist es im Panel ein Aufruf mehr.
192.168.0.0/24-Netz Aufträgeauslösen. Für ein Testnetz vertretbar, sobald fremde Geräte ins Netz
kommen: Basic-Authentifizierung in nginx (auth_basic).
Es gibt zwei Oberflächen, und das bleibt so:
| Oberfläche | Wo | Wofür | Braucht den PC? |
|---|---|---|---|
http://localhost:3000 | Windows (React-Dashboard) | VMs, Backups, Dienste, Startreihenfolge | ja |
https://steuer127.g3.local | .127 (Panel) | Ansible-Aufträge, Virtuelle Maschinen, Protokoll | nein (VM-Teil ja) |
Verbindung: Im Dashboard gibt es links im Menü den Punkt
„🖥️ Steuerserver 127 ↗". Er öffnet das Panel in einem eigenen Fenster.
Eingetragen in 02-Projekte\messenger1\dashboard\src\App.js.
Anlass (Franz, 28.10.2026): „Ich finde localhost:3000 ist schon so was
von unübersichtlich geworden, weil ich keine Menüs habe."
Vorher lagen alle 30 Bausteine auf einer Seite, geschaltet über drei
Reiter oben. Jetzt gibt es eine linke Leiste mit Gruppen:
| Gruppe | Punkte |
|---|---|
| Betrieb | Übersicht · Aufträge |
| Virtuelle Maschinen | VM-Verwaltung · Neue VM installieren · VM klonen · Restore-Tests |
| Dienste | Dienste & Steuerung · Sprachsteuerung · Agenten · Computer-Use |
| Sicherung | Projektsicherung |
| System | Server-Information · Steuerserver 127 ↗ |
| Kommunikation | Kommunikationsportal · Matrix Chat |
Kein Baustein wurde entfernt — nur einsortiert. Ein Punkt zeigt genau
die Bausteine, die zu ihm gehören.
Sicherung vor dem Umbau:
src\App.js.vor-menue-20261028-1830 und src\App.css.vor-menue-20261028-1830.
Zurück in einem Befehl:
Copy-Item "$src\App.js.vor-menue-20261028-1830" "$src\App.js" -Force
Copy-Item "$src\App.css.vor-menue-20261028-1830" "$src\App.css" -Force
Gestaltung: .menue-layout, .menue, .menue-punkt am Ende von
App.css; helle und dunkle Darstellung berücksichtigt, unter 900 px
klappt die Leiste nach oben.
Alle 14 Menüpunkte einzeln angeklickt, Inhalt und Fehleranzeige geprüft:
| Punkt | Karten | Zeichen | Fehler |
|---|---|---|---|
| Übersicht | – stattdessen 5 Kennzahlenkarten | 1.442 | keiner |
| Aufträge | – | 989 | keiner |
| VM-Verwaltung | 7 | 1.624 | keiner |
| Neue VM installieren | 1 | 3.592 | keiner |
| VM klonen | 2 | 811 | keiner |
| Restore-Tests | 5 | 1.573 | keiner |
| Dienste & Steuerung | 3 | 561 | keiner |
| Sprachsteuerung | 1 | 139 | keiner |
| Agenten | 3 | 2.882 | keiner |
| Computer-Use | 1 | 619 | keiner |
| Projektsicherung | 1 | 300 | keiner |
| Server-Information | – | 199 | keiner |
| Kommunikationsportal | – | 108.972 | keiner |
| Matrix Chat | – | 77 | keiner |
Alle API-Aufrufe (/api/status, /api/jobs, /api/controllers,
/api/messages) antworten mit 200. Keine Fehleranzeige von React,
kein Absturz.
Zwei Beobachtungen, beide schon vorher so:
Anmeldezustand liegt nur im Arbeitsspeicher der Seite.
Übersicht (handleLogin setzt den Reiter auf portal). Umstellbar,
falls die Übersicht der bessere Einstieg ist.
Das Panel auf https://steuer127.g3.local wurde ebenfalls im echten
Chrome geprüft: kein Zertifikatswarnbildschirm, Titel
„steuer127 — Steuerpanel", Menü mit 6 Punkten, Ansicht „Virtuelle
Maschinen" mit 37 Zeilen und der Meldung „37 Maschinen, 6 laufen".
Anlass (Franz, 28.10.2026): In tools\ lagen vier getrennte
Erweiterungen. Zwei davon hatten kein eigenes Symbol — Chrome zeigte
bei beiden das gleiche graue Puzzle, also griff man zwangsläufig zum
falschen. Dazu doppelte Einträge (das Dashboard stand in zwei Listen).
Ersetzt durch eine Erweiterung: tools\Arbeitsseiten-Chrome,
Version 2.0.0, Manifest 3, ohne Berechtigungen.
| Gruppe | Seiten |
|---|---|
| Steuerserver | Steuerpanel 127 (neu) · PC-Dashboard (neu) |
| Server-Seiten | 11 öffentliche Adressen |
| VM-Arbeitsseiten | 10 lokale Maschinen (ohne doppeltes Dashboard) |
| Konten, Mail & Domains | 4 Konten |
| Telefon-Pilot | 4 Seiten (ohne doppeltes Dashboard) |
Bedienung: „Öffnen" je Seite, Häkchen + „Ausgewählte öffnen",
„Alle öffnen", Suchfeld.
Einbauen: chrome://extensions → Entwicklermodus → „Entpackte
Erweiterung laden" → C:\Users\pc2\vault\tools\Arbeitsseiten-Chrome
→ die vier alten entfernen (Ordner bleiben liegen).
Grenze: Eine Erweiterung darf keine Programme starten. PuTTY geht
daraus nicht — dafür ist putty-127-auto.cmd in der Taskleiste da.
Zweck (Franz, 28.10.2026): „Man muss eine Demo zeigen, wie das in
Ansible gemacht wird — der Kunde muss tatsächlich sehen: aha, das geht so
und das so, und ui, das ist aufwändig."
Aufbau: drei Spalten (Franz' Vorgabe: „drei Fenster — links was genau, in der Mitte der Aufbau, rechts die Ausführung").
| Spalte | Inhalt |
|---|---|
| links | Katalog: oben „Schnell" (Alles neu aufbauen · Zurück auf Anfang), dann die 8 ausführbaren Schritte, darunter 34 Rollen aus dem Mailserver-Material |
| Mitte | Der gewählte Schritt: Erklärung, warum, Gefahr, Dauer, Ablauf in Ansible (Aufgaben mit Modulnamen), „Von Hand statt Ansible" (die echten Befehle), „Antwort zeigen" |
| rechts | Die mitlaufende Ausgabe; der gerade laufende Schritt leuchtet in der Mitte mit |
| Datei | Inhalt |
|---|---|
docs/lerntexte.yml | je Schritt: Antwort, Erklärung, warum, Gefahr, Dauer, Hinweis, Handbefehle |
docs/rollen-katalog.yml | die 36 Rollen aus dem Mailmaterial mit Erklärung und Fundstelle |
playbooks/10-lernschritte.yml | dieselben Schritte als Aufgaben mit tags |
| Panel-Menüpunkt „Lernschritte" | Katalog, Aufbau, mitlaufende Ausgabe |
Der Katalog kommt aus deinem eigenen Material:
C:\Tools\1txt\mails\mails\mail2server3trustmailer2.pro.txt — 36 Rollen
(apt_upgrade, users, ssh, postfix, dovecot, rspamd,
dkimberechtigungensetzen, certbot, mariadb, die Domain-Rollen …).
Acht davon sind schon als Lernschritt ausführbar und im Katalog mit
„läuft" markiert.
„Antwort zeigen" gibt je Schritt eine fertige Antwort auf die Frage
„Was macht Ansible da jetzt eigentlich?" — kurz, gesprochen, für Kunden
und Schüler.
Drei Fehler, die dabei aufgefallen sind:
command/shell werden im Trockenlauf übersprungen —dem Zuschauer zeigt das nichts. Darum stehen die Schritte jetzt auf
echten Modulen (community.general.timezone, community.general.ufw,
ansible.builtin.user); reine Lesebefehle tragen check_mode: false.
anna2 sofort wieder gelöscht. Er trägt jetzt tags: [rueckbau, never] —
„never" heißt: läuft nur, wenn man ihn ausdrücklich aufruft.
ufw noch nicht installiert war. Er prüft jetzt zuerst mit which ufw und zeigt im Trockenlauf die
Regeln an, die nach einem echten Lauf gelten würden.
Nach Änderungen an der Oberfläche: einmal hart neu laden
(Strg+F5 oder ?v=2 an die Adresse hängen) — sonst zeigt Chrome die
alte Fassung aus dem Zwischenspeicher.
Acht Schritte angelegt (erweiterbar):
Zeitzone · Grundpakete · Benutzer anna2 · SSH-Schlüssel · SSH härten ·
Rechnername · Firewall · Abschlussprüfung.
Zwei Betriebsarten je Schritt:
| Knopf | Aufruf | Wirkung |
|---|---|---|
| Trockenlauf | --check --diff | zeigt, was sich ändern würde; fasst nichts an |
| wirklich anwenden | ohne --check | ändert tatsächlich |
Lektion aus dem ersten Lauf: Aufgaben mit command/shell werden im
Trockenlauf übersprungen (skipping) und zeigen dem Zuschauer nichts.
Darum stehen die Schritte jetzt auf echten Modulen
(community.general.timezone, community.general.ufw,
ansible.builtin.user), und reine Lesebefehle tragen
check_mode: false. Ergebnis: ok, changed und skipping sind
unterscheidbar — genau das, was man vorführen will.
Nachweis vom 28.10.2026: Schritt 3 („Benutzer anna2 anlegen") echt
angewendet — changed=2, Meldung „anna2 ist neu angelegt", danach steht
in der Abschlussprüfung Benutzer: anna2 vorhanden.
Geübt wird derzeit am Steuerserver selbst ([lernziel] in
inventory/steuerserver.ini zeigt auf steuer127, lokal). Für die
Vorführung am Kunden gehört dorthin ein Wegwerfserver in Hetzner —
das Playbook dafür ist 00-server-anlegen.yml.
Noch offen: Der Schritt-Katalog deckt die Grundlagen ab. Für die
echten Server fehlen die servertypischen Schritte (Mail: 27 Rollen, siehe
docs/02-mail.md; Nextcloud, LiveKit, Gateway). Diese Liste wächst, indem
in lerntexte.yml ein Eintrag und im Playbook ein Block mit demselben
Tag dazukommt — mehr nicht.
Franz' Vorgabe: „mach das man gleich im Dashboard ist und das Anmelden
automatisch geht."
Umgesetzt in App.js: Der Anmeldezustand startet mit einem (Franz, info@ki-rechtsdialog.site), gespeichert unter
localStorage['arbeitsseiten-benutzer']. Kein Anmeldefenster mehr; die
Überschrift heißt jetzt „🖥️ Franz · Arbeitsseiten". Wer sich abmeldet,
bekommt beim nächsten Laden trotzdem wieder den Standardbenutzer — das ist
so gewollt, weil das Dashboard nur lokal erreichbar ist.
Begründung: Das Dashboard läuft auf demselben Rechner und war nie
von außen erreichbar. Ein Anmeldefenster schützt dort nichts, kostet aber
bei jedem Neuladen einen Handgriff.
Technisch ginge nur eine Richtung: eine HTTP-Seite darf eine
HTTPS-Seite einbetten (localhost:3000 → Panel), umgekehrt blockt der
Browser gemischte Inhalte. Trotzdem wurde verlinkt:
es aus, als gehörte es zu Windows.
Eingriff, ein eingebettetes fremdes Programm wäre ein großer.
Nach einer Änderung an App.js: der Entwicklungsserver auf 3000
baut aus dem Quelltext neu — kein eigener Bauvorgang nötig. Prüfen lässt
sich das am Bündel:
$html = (Invoke-WebRequest 'http://localhost:3000/' -UseBasicParsing).Content
$b = [regex]::Match($html, 'static/js/bundle\.[a-f0-9]+\.js').Value
(Invoke-WebRequest "http://localhost:3000/$b" -UseBasicParsing).Content -match 'Steuerserver 127'
| Fehler | Ursache | Merksatz |
|---|---|---|
| ISO startet stumm nicht | Boot-Informations-Tabelle fehlt | patch-bootinfo.py immer nach dem Bauen |
| „Initramfs unpacking failed: no cpio magic" | Archiv hinten angehängt | Eintrag vor TRAILER!!! |
| Installer fragt Sprache | Preseed kommt erst nach dem CD-Einbinden | Preseed in die Initrd oder über Netz |
| Tastendrücke kommen nicht an | console 0 legt auch die Tastatur auf seriell | console 0 weglassen, wenn Tastatur gebraucht wird |
tail -4, head -n 8 scheitern | PowerShell schickt \r am Zeilenende | Skripte vor dem Senden -replace "\r","" |
| SSH „Permission denied" | falscher Standardschlüssel | -i immer angeben |
| DNS-Name am PC unbekannt | Tailscale MagicDNS überspringt den Adapter | Hosts-Datei oder Split DNS |
| nginx startet nicht | http2 on; zu neu | listen 443 ssl http2; |
| puttygen ohne Wirkung | Kommandozeile in dieser Fassung tot | Passwortanmeldung im Starter |