4.0 KiB
Deployment
VPS Deployment
docker compose up --build -d
Services:
- Web: intern
speech-web:80, oeffentlich nur ueber Caddy - API: intern
speech-api:8080, oeffentlich nur ueber Caddy/api - PostgreSQL: nur internes Docker-Netz
- Redis: nur internes Docker-Netz
- Flowise: vorhandene Instanz ueber
FLOWISE_BASE_URL
Lokale Entwicklung
cp .env.example .env
docker compose -f docker-compose.dev.yml up --build -d
Lokale Ports:
- Web:
5173 - API:
8080 - Flowise:
3000 - PostgreSQL:
5432 - Redis:
6379
Production Notes
- Change
APP_JWT_SECRET. - Set strong Flowise credentials.
- Restrict exposed database/Redis ports or remove public port mappings.
- Put a reverse proxy with TLS in front of web/API/Flowise.
- Set
AZURE_ENABLE_MOCK=falseonly after configuring Azure credentials. - Add backups for PostgreSQL and Flowise volume.
VPS mit bestehendem Caddy, CrowdSec und WireGuard
Fuer deinen VPS ist die Default-Variante docker-compose.yml. docker-compose.prod.yml bleibt als identische explizite Produktionsdatei erhalten.
Annahmen:
- Caddy laeuft bereits in Docker.
- Caddy ist der einzige oeffentliche HTTP/HTTPS-Einstieg.
- CrowdSec + nftables Bouncer schuetzen die oeffentlichen Ports.
- Dein Arbeits-PC ist per WireGuard erreichbar, z. B. ueber
10.8.0.0/24.
Setup:
docker compose up --build -d
Dann den Inhalt aus deploy/caddy/speech.Caddyfile in /srv/docker/caddy/Caddyfile einfuegen und Caddy neu laden.
Wichtig:
speech-webundspeech-apihaengen am externen Docker-Netzwerk von Caddy.- Auf deinem VPS ist das passende Caddy-Netzwerk
web; setze alsoCADDY_DOCKER_NETWORK=web. - PostgreSQL und Redis haben keine Host-Port-Freigabe.
- Die API ist nur ueber
https://speech.v2202510301049387828.goodsrv.de/apierreichbar. - Flowise wird standardmaessig wiederverwendet:
FLOWISE_BASE_URL=http://flowise:3000. - Wenn dein Caddy-Netzwerk anders heisst,
CADDY_DOCKER_NETWORKin.envanpassen.
Das echte Caddy-Netzwerk findest du auf dem VPS mit:
docker inspect caddy-caddy-1 --format '{{json .NetworkSettings.Networks}}'
Bei dir stehen monitoring_default und web. Fuer Speech nimm web:
CADDY_DOCKER_NETWORK=web
Wenn der Flowise-Hostname im Caddy-Netzwerk nicht flowise ist, pruefen:
docker inspect flowise-main --format '{{json .NetworkSettings.Networks}}'
Dann FLOWISE_BASE_URL entsprechend setzen, z. B.:
FLOWISE_BASE_URL=http://flowise-main:3000
Wegen deiner laufenden Container werden in der Produktions-Compose bewusst keine Host-Ports fuer Speech veroeffentlicht. Dadurch gibt es keine Kollision mit:
- Caddy:
80,443 - Grafana:
127.0.0.1:3000 - Prometheus:
127.0.0.1:9090 - Adminer:
10.8.0.1:8080 - Gitea SSH:
2222 - Qdrant:
6333-6334 - vorhandenen PostgreSQL/Redis/Flowise-internen Ports
Falls du doch eine dedizierte Flowise-Instanz fuer Speech willst:
docker compose -f docker-compose.yml -f docker-compose.flowise.yml up --build -d
Auch diese Variante publiziert keine Host-Ports.
Empfohlen fuer dein bestehendes Flowise: Ersetze den vorhandenen flowise.v220... Caddy-Block optional durch deploy/caddy/flowise-wireguard-only.Caddyfile, damit Flowise nur noch ueber WireGuard erreichbar ist.
Minimaler Caddy-Reload:
docker exec caddy caddy validate --config /etc/caddy/Caddyfile
docker exec caddy caddy reload --config /etc/caddy/Caddyfile
Debugmodus
Der Debugmodus wird ueber .env gesteuert:
DEBUG_ENABLED=true
DEBUG_VERBOSE=false
LOG_LEVEL=debug
Nach einer Aenderung muss die API neu erzeugt/gestartet werden:
docker compose up -d --force-recreate speech-api
Debug ist nur fuer eingeloggte Nutzer erreichbar. Die Frontend-Navigation zeigt dann einen Punkt Debug. Die API-Endpunkte liegen intern unter:
/api/debug/status/api/debug/db/api/debug/flowise/api/debug/azure/api/debug/runtime
Wieder deaktivieren:
DEBUG_ENABLED=false
LOG_LEVEL=info
Danach erneut:
docker compose up -d --force-recreate speech-api