← zur Übersicht

Server 05 (Frageknopf-/Meet-Server) von Null mit Ansible aufbauen — Schritt für Schritt


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]


Server 05 von Null aufbauen — nur mit Ansible

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

#ZeitErgebnis
120:52Server wegwerf-05-buttons ID 173595581, IP 142.132.172.245, ok=13 failed=0, Ansible-Ping = pong
221:00DNS: „zeigt schon auf 142.132.172.245 — nichts zu tun", ok=6 failed=0
321:06Grundausstattung, 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
421:08Node v22.23.4, npm 10.9.9, ok=6 changed=2 failed=0
521:11Dateien 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
621:17Bauen/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
721:21Webserver + Zertifikat, ok=19 changed=9 failed=0; Zertifikat gültig bis 28.01.2027, https von außen 200
821:27Abnahme, 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.

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.

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:

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

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.

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.

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


0. Was vorher da sein muss

WasWoPrüfen mit
Ansible 2.14steuer127ansible --version
Hetzner-Token/root/.hcloud_env (export HCLOUD_TOKEN=… in einer Zeile)bash hcloud-stand.sh
SSH-Key root@server1 bei Hetzner hinterlegtHetzner-ProjektPlaybook prüft und bricht sonst ab
Vault-Passwort/root/.vault_pass2.txtfü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-Dateienfiles/s05-ui/*.tsx (5 Dateien)im Projekt
Gepinnte Python-Paketefiles/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.


1. Server anlegen (2 Minuten)


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

FehlermeldungUrsacheLösung
invalid_input: failed to parse json"ipv4": "157551658" als Text geschicktRumpf mit to_json bauen (macht das Playbook)
primary_ip_location_mismatchServer in fsn1, IP in nbg1Location aus der IP lesen (macht das Playbook)
Primal IP limit exceededneue IP verlangt, obwohl eine frei istprimary_ip_id der freien IP angeben
resource_unavailableLocation voll (z. B. cx33 in nbg1)anderen Typ oder andere Location wählen

Freie IPs anzeigen: bash hcloud-stand.sh (Liste „Nicht zugewiesen").


2. DNS setzen (3 Minuten, läuft auf dem Mailserver)

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:

FehlerUrsacheLösung
Invalid request IPvon steuer127 aus aufgerufennur vom Mailserver (macht das Playbook)
NXDOMAIN bei Let's EncryptName 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).


3. Grundausstattung (5 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).


4. Node (2 Minuten)


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


5. Dateien und Oberfläche (3 Minuten)


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.

SprecherAnzeige.tsx, KlickMarker.tsx, MeetingAdvisors.tsx,

BildChat.tsx.

Dateien (Raumprüfung in beiden Routen, Sekretariat, agents.py,

sekretariat.py, page.tsx) — sonst streiten zwei Server um Aufträge.

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:

FehlerUrsacheLösung
buttons169594541wwSuffix zweimal angehängterst Suffix entfernen, dann einmal setzen (macht das Playbook)
MODULE FAILURE / package.json nicht gefundenWorkingDirectory falschFrontend /opt/meeting-test, Berater /root/meeting-test-agents
Wissensdaten wegganzer agents/-Ordner kopiert--exclude advisors.json

6. Bauen und Dienste (10 Minuten)


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

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-admin-buttons (3111), meeting-mp3-buttons (3112),

meeting-sekretariat-buttons (3113) und sechs Berater (8094–8099).

Fallen:

FehlerUrsacheLösung
Could not open requirements filepip sucht die Datei auf dem ZielRequirements mit copy hochladen
npm error ENOENT package.jsonArbeitsordner der Einheit falschje Dienst eigener WorkingDirectory
ModuleNotFoundError: dotenvpython3-dotenv fehltim Paket-Set
Berater failed to connect to livekitAgentenname/Url falsch.env der Berater prüfen
Server „hängt", SSH „Connection reset"Speicher voll (6 × 350 MB)Swap + cx33 (8 GB)

7. Webserver und Zertifikat (3 Minuten)


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:

FehlerUrsacheLösung
413 Payload Too Large beim MP3nginx-Standard 1 MBclient_max_body_size 30m
invalid number of arguments in "proxy_set_header"Konfiguration per Heredoc geschrieben, $host von der Shell zerlegtKonfiguration als Datei hochladen
Zertifikat leer / kein httpsDNS zeigt noch woandershinerst Schritt 2, dann Zertifikat

8. Postausgang und Abnahme (5 Minuten)


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


9. Endkontrolle von außen (1 Minute)


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.


10. Aufräumen


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.


11. Zeitbedarf (gemessen)

SchrittDauer
1 Server2 Min
2 DNS2–10 Min (Wartezeit auf Auflösung)
3 Grundausstattung5 Min
4 Node2 Min
5 Dateien + Oberfläche3 Min
6 Bauen + Dienste10 Min
7 Webserver + Zertifikat3 Min
8 Postausgang + Abnahme5 Min
Summeetwa 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.