---
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]
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:
| Teil | Wo | Aufgabe |
|---|---|---|
| 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 aussen | gateway2 (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?").
livekit1| Punkt | Wert |
|---|---|
| Name | livekit1 (VMX C:\vms\livekit1\livekit1.vmx) |
| Adresse | 192.168.0.229 (DHCP; die feste 192.168.0.129 kam nicht durch, siehe 5.1) |
| System | Debian 12.15, 2 vCPU, 4 GB RAM (anfangs 2 GB — zu wenig, siehe 4.3), 11 GB Platte |
| Benutzer | lkuser / Livekit2026!, sudo ohne Passwort eingerichtet |
| LiveKit | 1.13.11 als /usr/local/bin/livekit-server, Dienst livekit |
| Tunnel | wg-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.
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
| Baustein | Datei / Wert |
|---|---|
| DNS | livekit-test A → 2.31.79.124 (Zone jetzt 16 Einträge) |
| gateway2-Site | /etc/nginx/sites-available/livekit-test |
| gateway2-Stream | Block listen 7881 in /etc/nginx/nginx.conf |
| UDP-Weiterleiter | /etc/nginx/stream-udp-livekit.conf (21 Ports 50200–50220, erzeugt von gw2udp.sh) |
| Firewall | gateway2 hat keine aktive ufw; iptables INPUT steht auf ACCEPT — die UDP-Ports sind erreichbar (geprueft mit tcpdump auf livekit1) |
| Zertifikat | certbot certonly --webroot -w /var/www/certbot -d livekit-test.unsere-ki-runde.xyz |
| Tunnel both sides | wg-quick@wg-livekit, beide enabled |
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.
| Werkzeug | Was es beantwortet |
|---|---|
tonweg.py | Kommt selbst veroeffentlichter Ton ueberhaupt bei einem anderen Teilnehmer an? (zwei Klienten im selben Raum) |
textfrage.py | Antwortet der Berater auf eine Textfrage? (trennt Antwortweg von Ton-Eingang) |
selbsttest.py | Ganzer 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.
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.
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.
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.
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.
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.
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:
/swapfile, in /etc/fstab), vm.swappiness=10/etc/sysctl.d/99-livekit.conf mit derselben EinstellungWenn es wieder passiert, in dieser Reihenfolge pruefen:
lk-messung.py auf dem Steuerserver (sagt in Sekunden, ob die API antwortet)ssh lkuser@192.168.0.229 'free -m; uptime'journalctl -u livekit -n 50 auf livekit1wg show wg-livekit auf beiden SeitenEin Waechter, der die VM bei Ausfall automatisch neu startet, ist noch nicht
eingebaut — das waere der naechste Schritt, falls es erneut auftritt.
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
/api/sekretariat, 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".
meeting-mail ruft /usr/sbin/sendmail auf — auf dem Steuerserver gab es das
nicht. Deshalb kam nie Post an, unabhaengig von der Herkunft.
Eingerichtet:
postfix als reiner Versender (loopback-only, relayhost = [46.224.157.119]:25), Warteschlange mit Wiederholung. /usr/sbin/sendmail zeigt jetzt auf Postfix.
vmail_pass) ist veraltet — die Anmeldung 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.
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.
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).
api/meeting-mail/route.ts unterscheidet Text- und Ton-Mail (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.
| Server | Aufgabe | Stand |
|---|---|---|
| 05 178.104.71.84 | Buttons/Meet | lokal auf steuer127 nachgebaut, Protokoll + MP3 + Mail laufen |
| 01 178.105.204.137 | LiveKit | durch livekit1 ersetzt, noch nicht geloescht |
| 09 2.28.228.136 | Audio-zu-Audio | lokal erprobt (frueherer Umzugstest), noch nicht abgeschaltet |
| 07 gateway2 (2.31.79.124) | Einstieg von aussen | bleibt — oeffentliche Tuer, rechnet nicht |
| 02, 03, 04, 06, 08 | Mail, Nextcloud, Test, Gateway, Headscale | unveraendert |
Geloescht wird nichts, bevor nicht einige Tage sauber gelaufen sind (Snapshots
bleiben zwei Wochen vorhaltebar).
Das Passwort aus dem Vault war veraltet. Franz hat das richtige genannt; damit:
AUTH → 235) relayhost = [46.224.157.119]:587, smtp_sasl_auth_enable = yes,
Zugangsdaten in /etc/postfix/sasl_passwd (600, postmap)
/root/mail-zugang.txt (600)vmail_pass), Sicherung mailonly1_vault.yml.bak-…Nachweis:
| Empfaenger | Ergebnis |
|---|---|
info@ki-rechtsdialog.site | dsn=2.0.0 status=sent, nach 1 Sekunde (kein Graufilter mehr) |
| fremde Domain | wird 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.
| Schritt | Ergebnis |
|---|---|
Vier Haken + E-Mail info@ki-rechtsdialog.site gesetzt | gespeichert in sessionStorage['meeting-mail:<raum>'] |
| Beitreten | Berater erscheinen als „bereit" |
| Begruessung | Ben und Makler gruessen von selbst, Mia gruesst bei Auswahl |
| Fragebutton geklickt | Text erscheint im Fragefeld („Mia, …") |
| Frage senden | wird vorgelesen (/api/sekretariat Aktion tts → 200 mit Ton) |
| Antwort | Mia antwortet im Protokoll, zweite Frage loest Live-Recherche aus |
| Aufnahme-Upload | nach der Groessen-Korrektur nicht mehr 413 |
| Protokoll-Mail | 200 „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.
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.**
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.
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.
/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.
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"
streamunknown 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.)
| Punkt | Warum |
|---|---|
| Medien laufen nur ueber TCP | UDP 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 livekit1 | Derzeit DHCP (192.168.0.229). Unkritisch, weil der Tunnel die Verbindung haelt, aber ein DHCP-Lease-Wechsel verwirrt die Doku. |
| Server 01 noch nicht abschaltbar | Erst wenn mehrere Tage sauber laufen. Dann: Snapshot, zwei Wochen warten, loeschen. |
| LiveKit-Schluessel | Stehen vorerst im Klartext in /etc/livekit.yaml und in .env. Beim Aufraeumen in den Vault ziehen. |