titel: Server 05 (Frageknopf-/Meet-Server) von Null mit Ansible aufbauen — Schritt für Schritt
erstellt: 2026-10-30
status: Anleitung fertig, am 30.10. erprobt
betrifft: playbooks/00-server-anlegen.yml, 00b-dns.yml, 05-buttons.yml
tags: [anleitung, ansible, server05, schritt-fuer-schritt, unterricht, restore]
Diese Anleitung baut den besten Frageknopf-/Meet-Server (Stand 30.10.2026:
Vier-Spalten-Oberfläche, Bild-Upload mit KI-Auswertung, Antwort-Panel,
Sprech-Anzeige) auf einem frischen Server auf. Kein Skript, keine
Handarbeit: acht Schritte, jeder ein Playbook-Lauf mit --tags.
Alles läuft auf dem Steuerserver steuer127 in /root/ansible-serveraufbau.
Der Lehrweg steht auch im Steuerpanel (https://steuer127.g3.local/,
links „Server neu mit Ansible“ → „10 · Ansible-Lehrweg“): drei Spalten —
links die acht Schritte, **in der Mitte was Ansible je Schritt tut (Aufgaben
der Reihe nach) samt Kopierkasten mit dem vollen Befehl**, rechts die echte
Ausgabe, während sie entsteht. Unten in der Mitte „Schritt jetzt starten“
und „Befehl in die Ansible-Konsole übernehmen“; dort gibt es zusätzlich ein
Eingabefeld, das nur ansible-playbook, ansible-inventory und
ansible ausführt (Semikolon, Pipe, Umleitung, $ werden abgewiesen).
Stand 30.10.2026: Route POST /api/ansible/befehl im Panel (app.py),
Ausführung im echten Projekt /root/ansible-serveraufbau (die Kopie unter
/home/steueruser1/Ansible-Serveraufbau ist älter und wird von der Konsole
nicht benutzt). Klickmarker im Panel ist nur noch ein gelber Punkt,
kein Fadenkreuz.
Zweiter Durchgang am 30.10.2026, geführt über das Panel (Franz klickt,
Assistent liest mit):
| # | Zeit | Ergebnis |
|---|---|---|
| 1 | 20:52 | Server wegwerf-05-buttons ID 173595581, IP 142.132.172.245, ok=13 failed=0, Ansible-Ping = pong |
| 2 | 21:00 | DNS: „zeigt schon auf 142.132.172.245 — nichts zu tun", ok=6 failed=0 |
| 3 | 21:06 | Grundausstattung, ok=11 changed=6 failed=0; nginx 1.24.0, certbot 2.9.0, ffmpeg 6.1.1, python3-dotenv, Swap 4 GB, Zeitzone Wien |
| 4 | 21:08 | Node v22.23.4, npm 10.9.9, ok=6 changed=2 failed=0 |
| 5 | 21:11 | Dateien und Oberfläche, ok=19 changed=9 failed=0; Wissensdaten unverändert (113 824 / 1 002 424 B), 5 Oberflächen-Dateien in /opt/meeting-test/lib/, Raumnamen …541w in allen sechs Dateien |
| 6 | 21:17 | Bauen/Python/Dienste, ok=17 changed=6 failed=0; zehn Dienste aktiv, venv Python 3.12.3 mit 87 Paketen, systemctl --failed leer. Speicher: 3 415 von 3 819 MB belegt |
| 7 | 21:21 | Webserver + Zertifikat, ok=19 changed=9 failed=0; Zertifikat gültig bis 28.01.2027, https von außen 200 |
| 8 | 21:27 | Abnahme, ok=10 changed=0 failed=0: 3100 → 200, 3111 → 200, Raum anlegen → 200, Ports 22 25 53 80 443 3100–3113 8094–8099, keine Fehlerdienste |
Gesamtzeit des geführten Durchgangs: 20:52 bis 21:35, also rund 40 Minuten —
vom leeren Hetzner-Konto bis zur erreichbaren Seite mit Zertifikat. Der erste
Durchgang am 29./30.10. brauchte 90 Minuten, weil vier Fehler erst gefunden
werden mussten (siehe unten).
Nachlauf am 31.10.2026 (Morgen danach):
gelöscht. Sicherung: Snapshot 450304912 (2,8 GB, „Lernstand
31.10.2026 09:29"), daneben der ältere 450094647 (2,5 GB, 30.10. 20:20).
Die Primary IP 142.132.172.245 bleibt frei (primary_ip_id=157551658),
der DNS-Eintrag wegwerf-buttons zeigt weiter darauf.
-e "schutz=true" --tags webserver,zertifikat → ok=19 changed=7 failed=0.
Geprüft: ohne Anmeldung 401, besucher:bitte-aendern 200,
admin:bitte-aendern auf /meeting-admin 200, falsches Passwort
401. Vor dem Echtbetrieb Passwörter über S05_USER/S05_PASS und
S05_ADMIN/S05_ADMINPASS setzen.
stand.json lag als root mit Rechten 644 da (mein Saat-Skript lief mit sudo). Das Panel läuft als steueruser1 und konnte
nicht schreiben — nach dem Neustart standen die Häkchen wieder auf „offen".
Behoben: Besitzer steueruser1:steueruser1, Rechte 664, Inhalt aus den
Protokollen panel/logs/*server:neu05:*.log neu aufgebaut.
D:\steuerrechnerneu1 lief). Neu im Autostart:
steuer127 starten.lnk → vault\tools\start-steuer127.cmd
(vmrun -T ws start C:\vms\steuer127\steuer127.vmx nogui, prüft vorher, ob
die VM schon läuft). Damit ist das Panel nach dem Anmelden wieder da.
Google-Konto-Speicher, Datei Login Data For Account): je ein Eintrag für
die Reiche „Meeting privat" (Benutzer besucher) und „Beraterverwaltung
privat" (Benutzer admin) auf https://wegwerf-buttons.unsere-ki-runde.xyz/.
Ab jetzt füllt Chrome die Felder selbst; beim Popup nur noch bestätigen.
Nicht die Adresse mit benutzer:passwort@ aufrufen — Chrome verbietet
dann alle internen Abrufe („Request cannot be constructed from a URL that
includes credentials") und die Seite ist kaputt, obwohl sie lädt.
schutz=true stand /meeting-admin hinter dem Passwort — die Raumseite holt sich dort
aber GET /meeting-admin/categories?advisor=…. Diese Abfrage konnte nie
beantwortet werden, Chrome fragte im Kreis nach Benutzer und Passwort.
Zwei Änderungen: (1) location = /meeting-admin/categories ist jetzt
öffentlich (exakter Treffer gewinnt gegen den Regex), (2) der Schutz ist
geteilt: schutz gilt für die ganze Seite (Lernserver: aus), schutz_admin
gilt immer für die Verwaltung. Geprüft ohne Anmeldung: / 200,
/meeting-admin/categories?advisor=makler 200, /meeting-admin 401;
mit admin 200; Raum-Token im Browser 200.
Dabei gelernt: Der Zustand der acht Schritte liegt jetzt in
/var/lib/steuer-panel/stand.json (Route GET /api/server/neu05/stand),
damit die Häkchen einen Neustart des Panels überleben. Alter SSH-Hostkey der
wiederverwendeten IP muss vorher entfernt werden:
ssh-keygen -f /root/.ssh/known_hosts -R 142.132.172.245.
Zwei Fehler am 30.10. beim zweiten Durchgang gefunden und behoben:
00b-dns.yml fragte dns.google nach dem kurzen Namen (wegwerf-buttons), der Namecheap-Eintrag heißt aber
wegwerf-buttons.unsere-ki-runde.xyz. Ergebnis: neun sinnlose
Warteversuche (3 Minuten) und eine Zeile „→ (erwartet: …)" mit leerem
Wert, obwohl der Eintrag längst richtig war. Neu: Variable dns_fqdn
(dns_name + Zone, wenn noch kein Punkt enthalten ist), delay: 10.
Gegenprobe: dns.google/resolve?name=wegwerf-buttons.unsere-ki-runde.xyz
→ 142.132.172.245, ohne Zone → Status 3 (NXDOMAIN).
sudo gibt PYTHONUNBUFFERED nicht weiter, Ansible schrieb in einen Pipe-Puffer.
Jetzt setzt jedes Skript in panel/schritte/ selbst
export PYTHONUNBUFFERED=1 — Ausgabe erscheint Zeile für Zeile.
05-buttons.yml stand fest schutz: false („Wegwerfserver sollen offen sein"). Für den echten
Server heißt das: wer es beim Aufbau nicht extra setzt, stellt die
Fragenbuttons samt /meeting-admin offen ins Internet. Neu:
schutz: "{{ 'wegwerf' not in inventory_hostname }}" — Lernserver offen,
jeder andere Name automatisch zu. Wichtig: in der Vorlage
templates/05-buttons-nginx.conf.j2 wird jetzt schutz | bool gelesen,
weil die Ableitung den Text „True"/„False" ergibt und Jinja einen
nicht-leeren Text als wahr ansieht.
Die Abnahme (Aussen erreichbar) akzeptiert [200, 401], läuft also
auch mit Passwortschutz durch.
inventory/produktion.ini: Der Eintrag 04-test(Server-ID 173053415) existierte bei Hetzner nicht mehr (HTTP 404), seine
IP 142.132.172.245 gehört inzwischen dem Lernserver. Eintrag
auskommentiert, damit kein Lauf aus Versehen den Lernserver als
Produktionsserver anfasst.
Variablen dns aus der Webserver-Phase; bei --tags abnahme gibt es die
nicht, also stand dort „https aussen: nicht geprueft (DNS)" — und die
Prüfung galt trotzdem als bestanden. Neu: eigene Aufgabe
„DNS-Aufloesung fuer die Aussenpruefung" (getent ahostsv4), und die
Prüfung selbst läuft mit curl -4 … -w '%{http_code}' statt
ansible.builtin.uri (das uri-Modul lieferte Status -1, während curl
auf demselben Server in 0,1 s eine 200 bekam). Die Abnahme prüft jetzt
zusätzlich, dass von außen 200 oder 401 kommt (401 = Passwortschutz an).
Mailserver abgewiesen:
`504 5.5.2 <wegwerf-05-buttons>: Helo command rejected: need
fully-qualified hostname`. Der Server meldete sich mit dem blanken
Rechnernamen, und weil beim Ein-Knopf-Lauf die Mailphase fehlte, ging
die Mail ohne Anmeldung direkt raus. Im Protokoll des Zielservers stand die
verschickte Mail mit 3 253 801 Bytes (die MP3) und dahinter der Bounce.
Behoben: myhostname = {{ domain }} (Playbook-Aufgabe „Absendername (HELO)
auf die Domain setzen") und Schritt 6 läuft jetzt mit
--tags bauen,python,dienste,mail samt -e @/root/.mail_relay_vars.yml.
Gegenprobe: Mail vom Zielserver über Relay → Postfach angekommen
(Authentication-Results: ORIGINATING).
"87315c8d" — die Seite war geladen, bevor npm run build` lief. Nach
Strg+Shift+R im Raum funktionieren „Protokoll senden" und die
Aufnahme-Mail wieder.
Zusätzlich am 31.10. geklärt (Einzelheiten in docs\22-WER-HOERT-ZU.md):
Ein Berater hört erst zu, wenn er im Raum angetippt wurde — das ist so
gebaut, damit nicht sechs Spracherkennungen dauerhaft laufen.
| Was | Wo | Prüfen mit |
|---|---|---|
| Ansible 2.14 | steuer127 | ansible --version |
| Hetzner-Token | /root/.hcloud_env (export HCLOUD_TOKEN=… in einer Zeile) | bash hcloud-stand.sh |
SSH-Key root@server1 bei Hetzner hinterlegt | Hetzner-Projekt | Playbook prüft und bricht sonst ab |
| Vault-Passwort | /root/.vault_pass2.txt | für DNS und Mail |
| Sicherungspaket | /root/work/sicherungen/server05-komplett/s05komplett.tar.gz (14,8 MB) | enthält App, Berater, Einheiten, nginx, Wissensdaten |
| Oberflächen-Dateien | files/s05-ui/*.tsx (5 Dateien) | im Projekt |
| Gepinnte Python-Pakete | files/05-buttons-requirements.txt (86 Stück) | im Projekt |
Wichtig: inventory/produktion.ini enthält die Produktions-IPs. Für einen
neuen Server arbeitet man mit einer eigenen Inventardatei
(inventory/wegwerf.ini), damit nie versehentlich die Produktion beschrieben
wird.
set -a; . /root/.hcloud_env; set +a
ansible-playbook playbooks/00-server-anlegen.yml \
-i inventory/wegwerf.ini \
-e "name=wegwerf-05-buttons" \
-e "primary_ip_id=157551658"
Was passiert: Name, Typ (cx23), Image (ubuntu-24.04), SSH-Key werden
geprüft, eine freie Primary IP wird wiederverwendet, die Location wird
aus der IP gelesen (nbg1), dann POST /servers.
Prüfen: Ausgabe zeigt Server-ID und IPv4.
Fallen (alle am 29./30.10. passiert):
| Fehlermeldung | Ursache | Lösung |
|---|---|---|
invalid_input: failed to parse json | "ipv4": "157551658" als Text geschickt | Rumpf mit to_json bauen (macht das Playbook) |
primary_ip_location_mismatch | Server in fsn1, IP in nbg1 | Location aus der IP lesen (macht das Playbook) |
Primal IP limit exceeded | neue IP verlangt, obwohl eine frei ist | primary_ip_id der freien IP angeben |
resource_unavailable | Location voll (z. B. cx33 in nbg1) | anderen Typ oder andere Location wählen |
Freie IPs anzeigen: bash hcloud-stand.sh (Liste „Nicht zugewiesen").
Namecheap erlaubt die API nur von der Mailserver-IP. Deshalb läuft dieser
Schritt auf dem Mailserver (Inventargruppe mail):
ansible-playbook playbooks/00b-dns.yml -i inventory/produktion.ini \
-e "dns_name=wegwerf-buttons" \
-e "dns_ip=142.132.172.245" \
--vault-password-file /root/.vault_pass2.txt
Fallen:
| Fehler | Ursache | Lösung |
|---|---|---|
Invalid request IP | von steuer127 aus aufgerufen | nur vom Mailserver (macht das Playbook) |
NXDOMAIN bei Let's Encrypt | Name mit Zone eingetragen (wegwerf-buttons.unsere-ki-runde.xyz) | Name ohne Zone (wegwerf-buttons) — das Werkzeug schneidet sie ab |
| „nur 7 Einträge — zu wenig" | falsche Zone (namecheap_sld = Maildomain) | namecheap_sld2 benutzen (macht das Playbook) |
Der Lauf wartet danach, bis die öffentliche Auflösung stimmt (max. 10 Minuten).
ansible-playbook playbooks/05-buttons.yml -i inventory/wegwerf.ini \
-l wegwerf-05-buttons -e "domain=wegwerf-buttons.unsere-ki-runde.xyz" \
--tags pakete
Enthält: Pakete (nginx, certbot, ffmpeg, postfix, python3-dotenv, Build-
Werkzeuge), Zeitzone Wien, Postfix auf Loopback, 4 GB Swap.
Warum Swap: sechs Berater belegen je ~350 MB; ohne Swap antwortet der
Server bei Last 66 nur noch mit „Connection reset" (30.10. gemessen).
ansible-playbook playbooks/05-buttons.yml -i inventory/wegwerf.ini \
-l wegwerf-05-buttons -e "domain=…" --tags node
NodeSource 22 einrichten, installieren, Version prüfen (≥ 18 für Next.js 15).
ansible-playbook playbooks/05-buttons.yml -i inventory/wegwerf.ini \
-l wegwerf-05-buttons -e "domain=…" --tags dateien
Was passiert:
SSH-Verbindung gekillt), entpacken, App und Berater an ihren Platz.
files/s05-ui/: AntwortBaum.tsx, SprecherAnzeige.tsx, KlickMarker.tsx, MeetingAdvisors.tsx,
BildChat.tsx.
namen_suffix): das Wort buttons169594541 in sechs Dateien (Raumprüfung in beiden Routen, Sekretariat, agents.py,
sekretariat.py, page.tsx) — sonst streiten zwei Server um Aufträge.
/api/sekretariat und /api/meeting-mail setzen.Wichtige Regel: agents/ wird ohne advisors.json und
knowledge-categories.json kopiert (--exclude), sonst überschreibt das
Paket die im Admin gepflegten Wissensdaten. Die beiden Dateien werden nur
zurückgespielt, wenn sie fehlen (force: false).
Fallen:
| Fehler | Ursache | Lösung |
|---|---|---|
buttons169594541ww | Suffix zweimal angehängt | erst Suffix entfernen, dann einmal setzen (macht das Playbook) |
MODULE FAILURE / package.json nicht gefunden | WorkingDirectory falsch | Frontend /opt/meeting-test, Berater /root/meeting-test-agents |
| Wissensdaten weg | ganzer agents/-Ordner kopiert | --exclude advisors.json |
ansible-playbook playbooks/05-buttons.yml -i inventory/wegwerf.ini \
-l wegwerf-05-buttons -e "domain=…" --tags bauen,dienste
Achtung, hier fehlt sonst ein Schritt (am 30.10. passiert): Diese Phase
heißt bauen,dienste und python. Wer python weglässt, hat nach dem
Lauf zehn Dienste, von denen vier gar nicht starten: das venv
/root/avatar-keyframe/venv existiert nicht, die Einheiten enden mit
status=203/EXEC, und in der Abnahme fehlen die Ports 3113 und
8094–8099.
ansible-playbook playbooks/05-buttons.yml -i inventory/wegwerf.ini \
-l wegwerf-05-buttons -e "domain=…" --tags bauen,python,dienste
npm ci --legacy-peer-deps + npm run build (prüft, ob .next/BUILD_ID entsteht) — nur neu bauen, wenn nötig (creates), aber immer, wenn
Namen oder Oberfläche geändert wurden.
python3 -m venv /root/avatar-keyframe/venv, dann 86 gepinnte Pakete
aus files/05-buttons-requirements.txt (Datei liegt auf dem Ziel).
meeting-web-buttons (3100), meeting-admin-buttons (3111), meeting-mp3-buttons (3112),
meeting-sekretariat-buttons (3113) und sechs Berater (8094–8099).
Fallen:
| Fehler | Ursache | Lösung |
|---|---|---|
Could not open requirements file | pip sucht die Datei auf dem Ziel | Requirements mit copy hochladen |
npm error ENOENT package.json | Arbeitsordner der Einheit falsch | je Dienst eigener WorkingDirectory |
ModuleNotFoundError: dotenv | python3-dotenv fehlt | im Paket-Set |
Berater failed to connect to livekit | Agentenname/Url falsch | .env der Berater prüfen |
| Server „hängt", SSH „Connection reset" | Speicher voll (6 × 350 MB) | Swap + cx33 (8 GB) |
ansible-playbook playbooks/05-buttons.yml -i inventory/wegwerf.ini \
-l wegwerf-05-buttons -e "domain=…" --tags webserver,zertifikat
Ablauf: Warte-Site auf Port 80 → certbot certonly --nginx → echte Site aus
templates/05-buttons-nginx.conf.j2 → nginx -t → reload.
Die Vorlage enthält: / → 3100, /meeting-config + /meeting-options +
/meeting-admin → 3111, /meeting-mp3 → 3112 mit 30 MB Grenze,
/api/sekretariat → 3113.
Fallen:
| Fehler | Ursache | Lösung |
|---|---|---|
413 Payload Too Large beim MP3 | nginx-Standard 1 MB | client_max_body_size 30m |
invalid number of arguments in "proxy_set_header" | Konfiguration per Heredoc geschrieben, $host von der Shell zerlegt | Konfiguration als Datei hochladen |
| Zertifikat leer / kein https | DNS zeigt noch woandershin | erst Schritt 2, dann Zertifikat |
# Postausgang (Zugangsdaten aus dem Vault, nicht ins Playbook schreiben)
ansible-playbook playbooks/05-buttons.yml -i inventory/wegwerf.ini \
-l wegwerf-05-buttons -e "domain=…" -e @/root/.mail_relay_vars.yml --tags mail
# Abnahme
ansible-playbook playbooks/05-buttons.yml -i inventory/wegwerf.ini \
-l wegwerf-05-buttons -e "domain=…" --tags abnahme
Die Abnahme prüft zehn Dinge: Ports 3100/3111/3112/3113/8094–8099/80/443,
HTTP 200 auf 3100 und 3111, Raum anlegen (200 mit Token), https von außen,
systemctl --failed leer.
Postausgang — die Falle: Anmeldung am Mailserver verlangt die **volle
Adresse** (info@ki-rechtsdialog.site), nicht nur den Benutzernamen. Sonst
535 5.7.8 authentication failed.
curl -s -o /dev/null -w "%{http_code}\n" https://wegwerf-buttons.unsere-ki-runde.xyz/
curl -s -o /dev/null -w "%{http_code}\n" https://wegwerf-buttons.unsere-ki-runde.xyz/meeting-config
Beides 200 = fertig. Ein Ping oder „Dienst active" beweist nichts.
ansible-playbook playbooks/99-wegwerf-loeschen.yml -e "id=<ID> wirklich=ja"
ansible-playbook playbooks/00b-dns.yml -i inventory/produktion.ini \
-e "dns_name=wegwerf-buttons" -e "dns_mode=loeschen" -e "dns_ip=142.132.172.245" \
--vault-password-file /root/.vault_pass2.txt
Das Playbook löscht nur Server, deren Name mit wegwerf- beginnt.
| Schritt | Dauer |
|---|---|
| 1 Server | 2 Min |
| 2 DNS | 2–10 Min (Wartezeit auf Auflösung) |
| 3 Grundausstattung | 5 Min |
| 4 Node | 2 Min |
| 5 Dateien + Oberfläche | 3 Min |
| 6 Bauen + Dienste | 10 Min |
| 7 Webserver + Zertifikat | 3 Min |
| 8 Postausgang + Abnahme | 5 Min |
| Summe | etwa 35 Minuten |
Zum Vergleich: der erste Durchlauf am 29.10. dauerte **38 Minuten inklusive
fünf Fehlversuchen**; mit dieser Anleitung sind es 35 Minuten ohne Umwege.