← zur Übersicht

Anleitung — Steuerserver 192.168.0.127 von null auf bedienbar


titel: Anleitung — Steuerserver 192.168.0.127 von null auf bedienbar

erstellt: 2026-10-28

tags: [anleitung, steuer127, dns, mkcert, nginx, putty, ansible]


Anleitung: Steuerserver .127 von null auf bedienbar

Diese 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.

Überblick


ISO bauen  →  installieren  →  Snapshot  →  Ansible  →  DNS-Name
           →  mkcert  →  nginx mit TLS  →  PuTTY-Starter  →  Knöpfe

1. Installations-ISO bauen

Einzelheiten in 03-ISO-BAU.md. Kurzfassung der drei Fallen:

Boot-Informations-Tabelle startet isolinux stumm nicht.

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).

2. Installieren und anmelden

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".

3. Snapshot — vor jeder Änderung


vmrun -T ws snapshot C:\vms\steuer127\steuer127.vmx frisch-installiert-20261028

4. sudo ohne Passwort (einmalig, von Hand)

Das Playbook braucht become. Einmal per Passwort:


echo 'Steuer2026!' | sudo -S install -m 0440 -o root -g root <datei> /etc/sudoers.d/90-steueruser1

5. Ansible


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.

6. DNS-Name

Zwei Dinge getrennt halten:

Wer fragtWeg
der Windows-PCHosts-Datei — denn der PC fragt Tailscale MagicDNS, nicht den BIND
alle anderen RechnerBIND 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):

zone "g3.local" { type master; file "/etc/bind/zones/db.g3.local"; };

Serial nicht vergessen (2026102801 im SOA), sonst merkt ein zweiter

Namensserver die Änderung nicht.

Warum der PC trotzdem die Hosts-Datei braucht

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.

7. mkcert — Zertifikat mit echtem Vertrauen


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

Windows 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.

8. nginx mit TLS auf dem Server


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.

9. PuTTY-Starter für die Taskleiste

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.

10. Die Oberfläche mit den Knöpfen

Aufbau wie bei den großen Panels (Hetzner, Hostinger): **links die

Navigation, rechts der Inhalt, unten die mitlaufende Ausgabe.**


https://steuer127.g3.local
TeilDatei / 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 auf127.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:

KnopfPlaybookWirkung
Prüfen01-steuerserver.ymlTrockenlauf mit --check --diff, ändert nichts
Einrichten01-steuerserver.ymlechter Lauf
Wegwerfserver planen00-server-anlegen.ymlTrockenlauf, legt nichts an

Ein Knopf = ein Playbook-Aufruf. Keine eigene Logik, die es auf der

Kommandozeile nicht auch gibt.

Die Ausgabe läuft mit

Der Dienst startet ansible-playbook, liest dessen Ausgabe Zeile für

Zeile und schickt sie über Server-Sent Events an den Browser.

Wichtig dabei:

am Ende statt während des Laufs.

„Es läuft schon ein Auftrag" (HTTP 409).

Stand der Prüfung (28.10.2026, abends)

PrüfungErgebnis
Seite erreichbar200, 14 KB, TLS vertraut
/api/uebersichtName, Netz, Platte, Ansible 2.14.18, nginx aktiv
Auftrag „Prüfen"startet, Ausgabe kommt live, endet „erfolgreich"
Doppelter Startabgelehnt mit 409

Warum kein Iframe

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.

Virtuelle Maschinen — warum kein vmrun

vmrun 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:

AufrufWirkung
GET /api/vm/listalle 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.

Was noch fehlt

list, start, stop, status. Snapshot müsste dort ergänzt werden

(vmrun snapshot auf dem PC), dann ist es im Panel ein Aufruf mehr.

auslösen. Für ein Testnetz vertretbar, sobald fremde Geräte ins Netz

kommen: Basic-Authentifizierung in nginx (auth_basic).


11. Wie die beiden Oberflächen zusammenhängen

Es gibt zwei Oberflächen, und das bleibt so:

OberflächeWoWofürBraucht den PC?
http://localhost:3000Windows (React-Dashboard)VMs, Backups, Dienste, Startreihenfolgeja
https://steuer127.g3.local.127 (Panel)Ansible-Aufträge, Virtuelle Maschinen, Protokollnein (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.

Das Dashboard hat jetzt ein Menü statt Reiter

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:

GruppePunkte
BetriebÜbersicht · Aufträge
Virtuelle MaschinenVM-Verwaltung · Neue VM installieren · VM klonen · Restore-Tests
DiensteDienste & Steuerung · Sprachsteuerung · Agenten · Computer-Use
SicherungProjektsicherung
SystemServer-Information · Steuerserver 127 ↗
KommunikationKommunikationsportal · 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.

Prüfung im echten Chrome (28.10.2026)

Alle 14 Menüpunkte einzeln angeklickt, Inhalt und Fehleranzeige geprüft:

PunktKartenZeichenFehler
Übersicht– stattdessen 5 Kennzahlenkarten1.442keiner
Aufträge–989keiner
VM-Verwaltung71.624keiner
Neue VM installieren13.592keiner
VM klonen2811keiner
Restore-Tests51.573keiner
Dienste & Steuerung3561keiner
Sprachsteuerung1139keiner
Agenten32.882keiner
Computer-Use1619keiner
Projektsicherung1300keiner
Server-Information–199keiner
Kommunikationsportal–108.972keiner
Matrix Chat–77keiner

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".

Chrome-Erweiterung „Franz · Arbeitsseiten"

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.

GruppeSeiten
SteuerserverSteuerpanel 127 (neu) · PC-Dashboard (neu)
Server-Seiten11 öffentliche Adressen
VM-Arbeitsseiten10 lokale Maschinen (ohne doppeltes Dashboard)
Konten, Mail & Domains4 Konten
Telefon-Pilot4 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.

Lernschritte — der Serveraufbau zum Zusehen

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").

SpalteInhalt
linksKatalog: oben „Schnell" (Alles neu aufbauen · Zurück auf Anfang), dann die 8 ausführbaren Schritte, darunter 34 Rollen aus dem Mailserver-Material
MitteDer gewählte Schritt: Erklärung, warum, Gefahr, Dauer, Ablauf in Ansible (Aufgaben mit Modulnamen), „Von Hand statt Ansible" (die echten Befehle), „Antwort zeigen"
rechtsDie mitlaufende Ausgabe; der gerade laufende Schritt leuchtet in der Mitte mit
DateiInhalt
docs/lerntexte.ymlje Schritt: Antwort, Erklärung, warum, Gefahr, Dauer, Hinweis, Handbefehle
docs/rollen-katalog.ymldie 36 Rollen aus dem Mailmaterial mit Erklärung und Fundstelle
playbooks/10-lernschritte.ymldieselben 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:

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.

sofort wieder gelöscht. Er trägt jetzt tags: [rueckbau, never] —

„never" heißt: läuft nur, wenn man ihn ausdrücklich aufruft.

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:

KnopfAufrufWirkung
Trockenlauf--check --diffzeigt, was sich ändern würde; fasst nichts an
wirklich anwendenohne --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.

Automatische Anmeldung im Dashboard

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.

Warum verlinkt und nicht eingebettet

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, die mich heute Zeit gekostet haben

FehlerUrsacheMerksatz
ISO startet stumm nichtBoot-Informations-Tabelle fehltpatch-bootinfo.py immer nach dem Bauen
„Initramfs unpacking failed: no cpio magic"Archiv hinten angehängtEintrag vor TRAILER!!!
Installer fragt SprachePreseed kommt erst nach dem CD-EinbindenPreseed in die Initrd oder über Netz
Tastendrücke kommen nicht anconsole 0 legt auch die Tastatur auf seriellconsole 0 weglassen, wenn Tastatur gebraucht wird
tail -4, head -n 8 scheiternPowerShell schickt \r am ZeilenendeSkripte vor dem Senden -replace "\r",""
SSH „Permission denied"falscher Standardschlüssel-i immer angeben
DNS-Name am PC unbekanntTailscale MagicDNS überspringt den AdapterHosts-Datei oder Split DNS
nginx startet nichthttp2 on; zu neulisten 443 ssl http2;
puttygen ohne WirkungKommandozeile in dieser Fassung totPasswortanmeldung im Starter