Zum Hauptinhalt springen
Für Produktions-Deployments solltest du den Avatar-Server über HTTPS bereitstellen, damit Browser und LiveKit-Agenten sicher verbinden können. Avaluma liefert eine Caddy-Reverse-Proxy-Konfiguration mit dem Avatar-Server aus, die TLS-Zertifikate von Let’s Encrypt automatisch bezieht und erneuert — keine manuelle Zertifikatsverwaltung nötig. Der Proxy und der Avatar-Server teilen sich ein Docker-Bridge-Netzwerk namens avaluma-net, beide Compose-Stacks müssen also gleichzeitig laufen.

​
Schritte

1

Avatar-Server starten

Stelle sicher, dass der Avatar-Server bereits läuft, bevor du den Proxy startest. Falls du ihn noch nicht eingerichtet hast, folge zuerst der Setup-Anleitung und kehre dann hierher zurück.Bestätige, dass der Server gesund ist, indem du Folgendes aus dem Verzeichnis avatar-server/ ausführst:
docker compose logs -f
2

Domain aktualisieren

Öffne reverse_proxy/Caddyfile und ersetze api.avaluma.ai durch deinen eigenen Domainnamen:
your-domain.com {
    reverse_proxy avaluma-avatar-server:8080
}
Caddy leitet allen eingehenden HTTPS-Verkehr auf Port 443 über das gemeinsame Netzwerk avaluma-net an den Avatar-Server-Container weiter. Der Containername avaluma-avatar-server ist der DNS-Name, über den Caddy den Server erreicht — ändere ihn nur, wenn du auch den Service in docker-compose.yaml umbenennst.
3

Proxy starten

Starte den Caddy-Container aus dem Verzeichnis reverse_proxy/:
cd reverse_proxy
docker compose up -d
Caddy fordert automatisch ein TLS-Zertifikat für deine Domain an und erneuert es vor Ablauf. Zertifikate werden in einem benannten Docker-Volume (caddy_data) gespeichert und überstehen so Container-Neustarts.Um zu prüfen, ob der Proxy läuft:
docker compose logs -f
4

Avatar-Server-Konfiguration aktualisieren

Da der Server jetzt über HTTPS erreichbar ist, aktualisiere API_SERVER_HOST in der docker-compose.yaml des Avatar-Servers auf deine Domain:
environment:
  - API_SERVER_HOST=your-domain.com
Starte den Avatar-Server neu, um die Änderung anzuwenden:
docker compose up -d

​
Vollständige Reverse-Proxy-Referenz

# Change this to your own domain name
api.avaluma.ai {
    reverse_proxy avaluma-avatar-server:8080

    @css {
        path *.css
    }
    header @css Content-Type "text/css; charset=utf-8"

    @js {
        path *.js
    }
    header @js Content-Type "application/javascript; charset=utf-8"
}
Beide Compose-Dateien müssen dasselbe Docker-Netzwerk verwenden. Die enthaltenen Konfigurationen definieren avaluma-net als Bridge-Netzwerk. Benenne dieses Netzwerk nicht um, es sei denn, du passt sowohl avatar-server/docker-compose.yaml als auch reverse_proxy/docker-compose.yaml entsprechend an.
Aktualisiere nach dem Aktivieren von HTTPS die Variable AVATAR_SERVER_URL in der .env.local deines LiveKit-Agents auf https://your-domain.com, damit der Agent über den sicheren Endpunkt verbindet.