← zur Übersicht

LiveKit lokal — eigener Server statt Cloud (Server 01)

---

titel: LiveKit lokal — eigener Server statt Cloud (Server 01)

erstellt: 2026-10-29

status: laeuft, Ton und Antwort geprueft

betrifft: neue VM livekit1, gateway2, Steuerserver steuer127

tags: [livekit, lokal-statt-cloud, wireguard, nginx, vm-aufbau]


LiveKit lokal

Ergebnis: Der Buttons-Test braucht keinen Cloud-Server mehr fuer die

Sprachvermittlung. Ein eigener kleiner Server im eigenen Netz uebernimmt die

Aufgabe von Server 01 (voiceserver2.unsere-ki-runde.xyz).

Was wo laeuft:

TeilWoAufgabe
Buttons-App (10 Dienste)steuer127 (192.168.0.127)rechnet, spricht, antwortet
LiveKit (neu)livekit1 (192.168.0.229)vermittelt nur die Sprachverbindung
Einstieg von aussengateway2 (2.31.79.124)TLS + Tunnel, sonst nichts

Geprueft am 29.10.2026: Mikrofon-Ton kommt an, wird erkannt, Antwort kommt als

Ton zurueck („Ja, ich kann dich hören! Wie kann ich dir helfen?").


1. Die neue VM livekit1

PunktWert
Namelivekit1 (VMX C:\vms\livekit1\livekit1.vmx)
Adresse192.168.0.229 (DHCP; die feste 192.168.0.129 kam nicht durch, siehe 5.1)
SystemDebian 12.15, 2 vCPU, 4 GB RAM (anfangs 2 GB — zu wenig, siehe 4.3), 11 GB Platte
Benutzerlkuser / Livekit2026!, sudo ohne Passwort eingerichtet
LiveKit1.13.11 als /usr/local/bin/livekit-server, Dienst livekit
Tunnelwg-livekit: gateway2 10.204.25.1 ↔ livekit1 10.204.25.2, Port 51824

/etc/livekit.yaml (kurz):


port: 7880
rtc:
  tcp_port: 7881               # WebRTC ueber TCP
  port_range_start: 50200      # UDP-Bereich, wird derzeit nicht nach aussen geoeffnet
  port_range_end: 50220
  use_external_ip: false
  node_ip: 2.31.79.124         # oeffentliche Adresse von gateway2
keys:
  APIlk1testlocal2026: sekret-livekit-lokal-2026-bit-01

node_ip ist der wichtigste Punkt: der Browser im Internet spricht die

ICE-Kandidaten bei gateway2 an, nginx reicht sie durch den Tunnel weiter.

Ohne diese Zeile bietet LiveKit nur die interne Adresse an — und von aussen

kommt nichts durch.


2. Weg von aussen


Browser
  └─ wss://livekit-test.unsere-ki-runde.xyz        (Let's Encrypt)
       └─ gateway2  nginx :443  → 10.204.25.2:7880
  └─ UDP  2.31.79.124:50200-50220                  (WebRTC-Medien, bevorzugt)
  └─ TCP  2.31.79.124:7881                         (WebRTC ueber TCP, Rueckfall)
       └─ gateway2  nginx stream → 10.204.25.2:502xx bzw. :7881
               alle Wege laufen durch den Tunnel wg-livekit
BausteinDatei / Wert
DNSlivekit-test A → 2.31.79.124 (Zone jetzt 16 Einträge)
gateway2-Site/etc/nginx/sites-available/livekit-test
gateway2-StreamBlock listen 7881 in /etc/nginx/nginx.conf
UDP-Weiterleiter/etc/nginx/stream-udp-livekit.conf (21 Ports 50200–50220, erzeugt von gw2udp.sh)
Firewallgateway2 hat keine aktive ufw; iptables INPUT steht auf ACCEPT — die UDP-Ports sind erreichbar (geprueft mit tcpdump auf livekit1)
Zertifikatcertbot certonly --webroot -w /var/www/certbot -d livekit-test.unsere-ki-runde.xyz
Tunnel both sideswg-quick@wg-livekit, beide enabled

UDP ist eingeschaltet (29.10.2026)

LiveKit bietet die Ports 50200–50220 an (rtc.port_range_start/end), gateway2

reicht jeden Port per nginx-stream als UDP weiter, node_ip sorgt dafuer,

dass der Browser sie bei der oeffentlichen Adresse sucht.

Nachweis: 5 Pakete von aussen auf 2.31.79.124:50201 geschickt → auf livekit1

im Mitschnitt sichtbar (10.204.25.1 > 10.204.25.2.50201). Waehrend eines

Testgespraechs: 99.995 UDP-Pakete auf 50200–50220 in 75 Sekunden.

Der TCP-Weg (7881) bleibt als Rueckfall bestehen.

Auf dem Steuerserver zeigt die Anwendung jetzt dorthin

(/root/meeting-test-agents/.env, Sicherung: .env.vor-livekit-lokal):


LIVEKIT_URL=wss://livekit-test.unsere-ki-runde.xyz
LIVEKIT_API_KEY=APIlk1testlocal2026
LIVEKIT_API_SECRET=sekret-livekit-lokal-2026-bit-01

Danach alle zehn Dienste neu starten; die Berater melden sich dann mit

"url": "wss://livekit-test.unsere-ki-runde.xyz" an.


3. Die drei Pruefwerkzeuge (liegen auf dem Steuerserver)

WerkzeugWas es beantwortet
tonweg.pyKommt selbst veroeffentlichter Ton ueberhaupt bei einem anderen Teilnehmer an? (zwei Klienten im selben Raum)
textfrage.pyAntwortet der Berater auf eine Textfrage? (trennt Antwortweg von Ton-Eingang)
selbsttest.pyGanzer Weg: als Gast beitreten, Berater waehlen, gesprochenen Satz einspielen, Antwort mitschreiben

Ergebnisse vom 29.10.2026:


tonweg.py     → B empfaengt 2.964.960 Bytes (Ton von A kommt durch)
textfrage.py  → „Ich heiße Mia." (Antwortweg in Ordnung)
selbsttest.py → TRANSKRIPT: Hallo Mia, kannst du mich hören?
                Antwort:  Ja, ich kann dich hören! Wie kann ich dir helfen?

Zusatz: stt-direkt.py ruft die Spracherkennung ohne LiveKit auf. Damit laesst

sich zeigen, ob ein Schluessel oder Modell klemmt, wenn im Meeting nichts

erkannt wird.


4. Stolperfalle nach einem Neustart der Berater

Direkt nach systemctl restart meeting-*-buttons kam beim ersten Test kein

Transkript, obwohl alles lief; zwei Minuten spaeter ging es. Die Berater

brauchen nach dem Start einen Moment, bis sie sich verbunden und die Tonspur

abonniert haben. Regel: nach einem Neustart etwa 30 Sekunden warten, bevor

ein Testgespraech bewertet wird.

4.1 Raeume brauchen einen Namen mit mindestens 6 Zeichen

app/api/connection-details/route.ts prueft

/^meeting-buttons169594541-[a-zA-Z0-9-]{6,80}$/. Ein Testraum wie

meeting-buttons169594541-p1 wird mit HTTP 400 abgelehnt — und weil der

Testclient die Fehlermeldung nur in eine Datei schreibt, sieht es aus, als

wuerde der Berater nicht antworten. Stundenlang in die falsche Richtung gesucht:

alle „stummen" Testlaeufe hatten zu kurze Raumnamen.

Merke: …169594541-endtest1 geht, …169594541-p1 nicht.

4.2 Auslastungsgrenze der Arbeiter angehoben

agents.py startete die Arbeiter mit load_threshold=0.95. Ein einziger

laufender Auftrag ergibt Last ≈ 1.0 — der Arbeiter galt damit sofort als

ausgelastet, und LiveKit meldete beim naechsten Raum

not dispatching agent job since no worker is available. Also: kein Berater,

keine Fehlermeldung. Geaendert auf:


AgentServer(port=..., load_threshold=1.5, num_idle_processes=2)

Sicherung der alten Fassung: agents.py.vor-lastgrenze.

4.3 „Join Room" tut nichts — die LiveKit-VM war vollgelaufen

Symptom: Klick auf „Join Room" bewirkt nichts, keine Fehlermeldung, kein

Wechsel in den Raum. Im Netzwerk: GET /api/connection-details bleibt ohne

Antwort (Status leer, haengt minutenlang).

Ursache: livekit1 lief mit 2 GB. LiveKit plus sechs Dienste, die sich

verbinden, plus laufende Mitschnitte fuellten den Speicher; der Dienst antwortete

nicht mehr, nahm aber weiter Verbindungen an. Jede Anfrage an die LiveKit-API

lief damit in die Zeitueberschreitung — und die Seite wartet auf diese Antwort,

bevor sie beitritt.

Nachweis: lk-messung.py auf dem Steuerserver. Vorher: alle vier

API-Schritte 15 s Zeitueberschreitung. Nach dem Neustart mit 4 GB:

0,2–0,4 s je Schritt, /api/connection-details = HTTP 200 in 1,5 s,

Testgespraech mit 30 Transkript-Zeilen.

Merke: Wenn „Join" haengt, zuerst lk-messung.py laufen lassen — es sagt in

Sekunden, ob LiveKit antwortet. Zweiter Blick: free -m auf livekit1.

Jetzt: 4 GB RAM (memsize = "4096"), Snapshot livekit-4gb-stabil-20261029-1115.

4.4 Begruessung kam nicht

Symptom: Raum betreten, kein Willkommen — weder Ton noch Text.

Ursache: Begruesst wurde bisher nur der Makler, und zwar ueber einen

RPC-Aufruf der Seite (meeting.greet), der fuenfmal im Abstand von zwei

Sekunden versucht wird. Ist der Makler in diesen zehn Sekunden nicht bereit,

faellt der Gruss aus — ohne Fehlermeldung. Wer einen anderen Berater waehlte,

hoerte ohnehin nichts.

Aenderung (agents.py, Sicherung agents.py.vor-begruessung): sobald die

Seite einen Berater auswaehlt (meeting-control), begruesst er sich einmal

selbst:


elif selected_for_me and not state['greeted']:
    state['greeted']=True
    session.generate_reply(instructions='Begruesse den Besucher jetzt kurz ... '+_gruss)

Da die Seite beim Beitreten automatisch „Ben" auswaehlt, kommt die Begruessung

jetzt zuverlaessig von selbst. Nachweis im Test: erster Berater-Satz

„Hallo, ich bin Mia." — ausgeloest allein durch die Auswahl.

4.5 Die LiveKit-VM wurde zweimal unerreichbar

Zweimal innerhalb einer Stunde antwortete livekit1 weder auf ssh noch auf

LiveKit-Anfragen; von aussen lief jede Anfrage in die Zeitueberschreitung, die

Berater meldeten transport timed out und No PONG received after 15 seconds.

Zustand danach jeweils unauffaellig: Platte 14 %, Protokolle 63 MB. Kein

Festplatten- oder Protokollproblem.

Was jetzt dagegen eingerichtet ist:

Wenn es wieder passiert, in dieser Reihenfolge pruefen:

Ein Waechter, der die VM bei Ausfall automatisch neu startet, ist noch nicht

eingebaut — das waere der naechste Schritt, falls es erneut auftritt.

4.7 Frage vorlesen und Protokoll-Mail gingen nicht (29.10.2026)

Beides hing an derselben Ursache: die beiden Routen

app/api/sekretariat/route.ts und app/api/meeting-mail/route.ts liessen nur

eine Herkunft zu:


if(req.headers.get('origin')!=='https://meet-neu.weiter.online') return 403

Auf dem Steuerserver heisst die Seite https://buttons-test.unsere-ki-runde.xyz

→ jede Anfrage 403 „Origin nicht erlaubt". Damit war

Aktion tts), und

Behoben: Liste erlaubter Herkuenfte, erweiterbar ueber MEETING_ORIGINS

(Komma getrennt). Sicherungen: route.ts.vor-origin. Danach npm run build

und systemctl restart meeting-web-buttons.

Nachweis: …/api/sekretariat mit Aktion tts antwortet 200 und liefert

Tonspur; …/api/meeting-mail antwortet 200 mit

„An lokalen Maildienst übergeben".

4.8 Mailversand brauchte einen MTA

meeting-mail ruft /usr/sbin/sendmail auf — auf dem Steuerserver gab es das

nicht. Deshalb kam nie Post an, unabhaengig von der Herkunft.

Eingerichtet:

Warteschlange mit Wiederholung. /usr/sbin/sendmail zeigt jetzt auf Postfix.

am Mailserver wird mit 535 authentication failed abgelehnt. Der Versand

laeuft deshalb ohne Anmeldung an den eigenen Mailserver.

Folge: Der Mailserver graufiltert nur die erste Zustellung

(rspamd: greylisted until …). Postfix wiederholt automatisch; danach kennt

der Graufilter den Absender und alle weiteren Mails gehen sofort durch —

gemessen am 29.10.: Warteschlange unmittelbar nach der Uebergabe leer, Mail im

Postfach (…/mail/Gelesen/cur/). Nachweis im Protokoll des Mailservers:

dovecot: lmtp(info@ki-rechtsdialog.site): … stored mail.

Grenze: Ohne Anmeldung nimmt der Mailserver nur Post fuer eigene Domains

an. Fuer fremde Empfaenger (z. B. eine Gmail-Adresse als Protokollziel) braucht

es ein gueltiges Postfach-Passwort und SMTP-AUTH auf Port 587. Dafuer muss das

Passwort von info@ki-rechtsdialog.site neu gesetzt werden — das aendert

zugleich das Passwort im Mailprogramm und wird nur mit Franz' Zustimmung gemacht.

4.9 Die Aufnahme wurde verworfen: 413 Payload Too Large

Symptom: Trotz gesetzter Haken kam kein MP3 und keine Mail mit Aufnahme.

Ursache: Die Seite laedt die Aufnahme nach /meeting-mp3 hoch. Auf dem

Steuerserver sind 25 MB erlaubt, **auf gateway2 galt die Standardgrenze von

1 MB → POST /meeting-mp3 endete mit 413**. Danach brach die Uebergabe ab.

Behoben in /etc/nginx/sites-available/buttons-test (gateway2), in beiden

server-Bloecken:


client_max_body_size 30m;
proxy_read_timeout   300s;
proxy_send_timeout   300s;

Nachweis: eine 5-MB-Probe kommt jetzt durch (Antwort 400 „MP3-Konvertierung

fehlgeschlagen", weil die Probe kein Ton war — vorher 413).

Merke: Bei jedem neuen Hostnamen denselben Grenzwert setzen. Ohne das

scheitert jede Aufnahme lautlos im Browser.

4.12 Eine Mail mit Protokoll im Text und Aufnahme (erledigt)

Symptom: Es kamen zwei Mails: zuerst das Protokoll ohne Ton, Sekunden

spaeter eine Mail mit Ton aber ohne Protokoll.

Ursache: Beim Trennen schickte MeetingRecording die Text-Mail, und die

Aufnahme-Mail folgte kurz danach — die zweite lief in die Sperre der Route

(„Bitte eine Minute bis zum erneuten Versand warten", HTTP 400). Nur die erste

kam an.

Aenderungen (Sicherungen *.vor-einemail):

laeuft (cfg.consent && cfg.audio pruefen).

(room:email+text / room:email+ton).

Ergebnis (nachgemessen an der angekommenen Mail):


Subject: Meeting - Protokoll und Quellen      2.483.833 Bytes
Text im Koerper:  PROTOKOLL … Makler: Willkommen! … Mia: Hallo, ich bin Mia. …
                  Besucher: Mia, Wie finde ich den Wert meines Hauses heraus? …
Anhaenge:         gespraech.txt, gespraech.md, quellen.txt, quellen.md,
                  meeting.mp3        ← die Aufnahme

Damit ist genau das erreicht, was Franz wollte: eine Mail, Protokoll im

Text, Ton als Anhang.

Nebenbefund Spam: Die zwei Mails im Spamordner waren meine Behelfsmails von

Hand (rspamd: R_MIXED_CHARSET 5.0, MIME_BAD_ATTACHMENT). Die Mails der

Anwendung selbst werden mit 0.00 bewertet und nicht markiert.

4.13 Welche Cloudserver jetzt verzichtbar sind

ServerAufgabeStand
05 178.104.71.84Buttons/Meetlokal auf steuer127 nachgebaut, Protokoll + MP3 + Mail laufen
01 178.105.204.137LiveKitdurch livekit1 ersetzt, noch nicht geloescht
09 2.28.228.136Audio-zu-Audiolokal erprobt (frueherer Umzugstest), noch nicht abgeschaltet
07 gateway2 (2.31.79.124)Einstieg von aussenbleibt — oeffentliche Tuer, rechnet nicht
02, 03, 04, 06, 08Mail, Nextcloud, Test, Gateway, Headscaleunveraendert

Geloescht wird nichts, bevor nicht einige Tage sauber gelaufen sind (Snapshots

bleiben zwei Wochen vorhaltebar).

4.11 Mailversand: jetzt angemeldet (erledigt 29.10.2026)

Das Passwort aus dem Vault war veraltet. Franz hat das richtige genannt; damit:

relayhost = [46.224.157.119]:587, smtp_sasl_auth_enable = yes,

Zugangsdaten in /etc/postfix/sasl_passwd (600, postmap)

Nachweis:

EmpfaengerErgebnis
info@ki-rechtsdialog.sitedsn=2.0.0 status=sent, nach 1 Sekunde (kein Graufilter mehr)
fremde Domainwird angenommen und weitergeleitet (Probe gegen example.com scheiterte nur, weil diese Domain per nullMX gar keine Post annimmt — der Weg selbst funktioniert)

Damit gehen Protokoll und MP3 auch an beliebige Adressen.

Was weiterhin gilt: Wenn das Postfach-Passwort im Mailprogramm geaendert

wird, muss /etc/postfix/sasl_passwd auf dem Steuerserver nachgezogen werden

(postmap + systemctl reload postfix) — sonst bleibt die Post in der

Warteschlange liegen.

4.10 Stand nach dem Durchtest im echten Chrome (29.10.2026)

SchrittErgebnis
Vier Haken + E-Mail info@ki-rechtsdialog.site gesetztgespeichert in sessionStorage['meeting-mail:<raum>']
BeitretenBerater erscheinen als „bereit"
BegruessungBen und Makler gruessen von selbst, Mia gruesst bei Auswahl
Fragebutton geklicktText erscheint im Fragefeld („Mia, …")
Frage sendenwird vorgelesen (/api/sekretariat Aktion tts → 200 mit Ton)
AntwortMia antwortet im Protokoll, zweite Frage loest Live-Recherche aus
Aufnahme-Uploadnach der Groessen-Korrektur nicht mehr 413
Protokoll-Mail200 „An lokalen Maildienst übergeben", liegt nach 5–10 Minuten im Postfach

Postfach-Ablage zum Nachsehen (auf dem Mailserver):

/var/vmail/mailboxes/ki-rechtsdialog.site/info/mail/ — ein Sieve-Filter legt

Neues in Gelesen/cur/ ab.

4.6 Die Platte auf dem Windows-Rechner lief voll

VMware-Snapshots mit Speicherzustand kosten je nach RAM-Groesse mehrere

Gigabyte (steuer127-Snapshot4.vmem = 6,1 GB). Sechs Snapshots lagen auf C:,

die Platte hatte nur noch 5 GB frei — Snapshots liessen sich nicht mehr

anlegen („disk is full").

Aufgeraeumt: alte Snapshots geloescht, seither zwei fuer den Steuerserver

(udp-und-lastgrenze-20261029-1100, arbeitsstand-20261029-1135) und einer

fuer livekit1 (livekit-4gb-stabil-20261029-1115). **Merke: hoechstens zwei

Snapshots je VM, sonst frisst es die Platte.**


5. Was beim Bauen schiefging (und wie es geloest ist)

5.1 Der Preseed greift bei Netzwerk und Namen zu spaet

Der Preseed kam per preseed/url von einem kleinen Webserver auf dem PC

(python -m http.server 8099 --directory C:\iso-build\webserve). Das klappt —

aber die Fragen von netcfg (Adresse, Rechnername) sind vor dem Laden

des Preseeds dran. Ergebnis: die VM holte sich eine DHCP-Adresse und hiess

debian; Partitionierung, Benutzer und Pakete kamen dagegen sauber aus dem

Preseed.

Loesung: nach der Installation hostnamectl set-hostname livekit1 und die

Adresse per DHCP belassen. Fuer die Anbindung ist das ohne Belang, weil der

Tunnel von der VM aus aufgebaut wird und gateway2 nur die Tunnel-Adresse

10.204.25.2 braucht.

5.2 Die Initrd liess sich nicht mehr befuellen

Der frueher genutzte Weg (Preseed in die Initrd) scheiterte hier mit

Initramfs unpacking failed: malformed archive. Deshalb jetzt: Preseed auf

einem HTTP-Server, Antworten fuer Sprache direkt auf der Startzeile.

5.3 Zwei Startzeilen — die falsche zaehlt

/isolinux/txt.cfg und /isolinux/isolinux.cfg enthalten beide einen

Eintrag install. Bei prompt 0 gilt der aus isolinux.cfg; Aenderungen an

txt.cfg wirken nicht. Beide muessen gepatcht werden.

5.4 Die ISO blieb nach der Installation im Laufwerk

Wie bei steuer127: bios.bootOrder = "cdrom,hdd" plus eingelegtes ISO =

jeder Neustart startet die Installation neu. Nach der Installation:


ide1:0.present = "FALSE"
bios.bootOrder = "hdd"

5.5 nginx auf gateway2 konnte kein stream

unknown directive "stream" — das Modul fehlte. Loesung:

apt-get install -y libnginx-mod-stream, danach nginx -t und reload.

(Die Site selbst lauscht auf 443 und braucht das Modul nicht; nur der

TCP-Weg fuer die WebRTC-Medien braucht es.)


6. Offen

PunktWarum
Medien laufen nur ueber TCPUDP 50200–50220 ist auf gateway2 nicht geoeffnet. Fuer Tests reicht TCP; bei vielen Teilnehmern oder schlechter Leitung waere UDP besser (Ports freigeben und per nginx-stream durchreichen).
Feste Adresse fuer livekit1Derzeit DHCP (192.168.0.229). Unkritisch, weil der Tunnel die Verbindung haelt, aber ein DHCP-Lease-Wechsel verwirrt die Doku.
Server 01 noch nicht abschaltbarErst wenn mehrere Tage sauber laufen. Dann: Snapshot, zwei Wochen warten, loeschen.
LiveKit-SchluesselStehen vorerst im Klartext in /etc/livekit.yaml und in .env. Beim Aufraeumen in den Vault ziehen.