Nextcloud Talk Hochleistungs-Backend (Signaling + TURN) – Docker Setup

Übersicht

Dieses Setup beinhaltet die vollständige Konfiguration für das Hochleistungs-Backend von Nextcloud Talk: - Signaling Server (spreed-signaling) - Coturn (TURN/STUN) - Reverse Proxy via Traefik - SSL via Let's Encrypt

Docker-Verzeichnisstruktur (`/opt/docker/talk`)

docker-compose.yml
server.conf          # Signaling Config
turnserver.conf      # Coturn Config

docker-compose.yml

snippet.yaml

version: "3.8"
services:
  signaling:
    image: strukturag/nextcloud-spreed-signaling
    container_name: signaling
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./server.conf:/config/server.conf
    networks:
      - docker_backend
    environment:
      - DOMAIN=talk.example.org
      - SIGNALING_SECRET=SuperSecret123
      - NATS_ENABLED=false
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.talk.rule=Host(`talk.example.org`)"
      - "traefik.http.routers.talk.entrypoints=websecure"
      - "traefik.http.routers.talk.tls.certresolver=le"
      - "traefik.http.services.talk.loadbalancer.server.port=8080"
      - "traefik.docker.network=docker_backend"

  coturn:
    image: instrumentisto/coturn
    restart: always
    networks:
      - docker_backend
    ports:
      - "3478:3478/udp"
      - "3478:3478"
    volumes:
      - ./turnserver.conf:/etc/coturn/turnserver.conf
    command: ["-c", "/etc/coturn/turnserver.conf"]

networks:
  docker_backend:
    external: true

server.conf (Signaling)

snippet.ini

listen = 0.0.0.0:8080
tls_listen = 0.0.0.0:8443
tls = false
shared-secret = SuperSecret123
http-origin = *
nats-enabled = false

turnserver.conf (Coturn)

snippet.ini

listening-port=3478
fingerprint
use-auth-secret
static-auth-secret=SuperSecret123
realm=talk.example.org
total-quota=100
bps-capacity=0
stale-nonce
no-loopback-peers
no-multicast-peers
cli-password=SuperSecret123

Bekannte Fehlerquellen & Lösungen

Fehlerbild	Ursache	Lösung
———–	———	——–
`502 Bad Gateway`	Signaling nicht gestartet oder crashed	Volume prüfen, Config korrekt referenziert (`/config/server.conf`)
`Could not create connection (nats: no servers...)`	Default NATS-Loopback aktiv	Setze `nats-enabled = false` in der `server.conf`
`Connection refused` auf Port 8080	Container hat Config nicht geladen	`docker exec -it signaling cat /config/server.conf` prüfen
Coturn TLS-Zertifikatsfehler	Datei nicht vorhanden	Coturn nicht mit TLS starten oder TLS über Traefik absichern
Docker `restarting` Loop	Falscher Pfad in Volume-Zuweisung	`volumes:`-Abschnitte prüfen auf absolute vs. relative Pfade
`/healthz` liefert 404	Endpoint existiert nicht bei diesem Image	Ist normal, keine Problemquelle

Test-URLs

snippet.bash

# Signaling
curl -vk https://talk.example.org
 
# TURN
echo "Test" | openssl s_client -connect talk.example.org:3478

Nützliche Zusatzbefehle

snippet.bash

# Container Logs
docker logs -f signaling
docker exec -it signaling sh
 
# curl intern im Container
apk add curl
curl -v http://127.0.0.1:8080/

Empfehlung für Backup

Erstelle regelmäßig ein Backup dieser Dateien:

docker-compose.yml
server.conf
turnserver.conf
.env falls vorhanden

Lars.Weiss@gmail.com?l|Lars Weiß Lars Weiß 04.06.2025 11:27