Domain, DNS und HTTPS

Browser erlauben Mikrofon, Kamera und Bildschirmübertragung nur auf HTTPS-Seiten, und ein Zertifikat braucht einen Namen. Diese Seite besorgt dir beides, dazu den Reverse Proxy, der das Zertifikat hält.

Ein Name

Eine Domain kostet etwa zehn Euro im Jahr, oder du nimmst einen kostenlosen Namen von einem Dienst für dynamisches DNS. Nimm eine Subdomain wie chat.example.com, damit der Rest der Domain für anderes frei bleibt.

Zu Hause ändert sich deine Adresse? Nimm dynamisches DNS: einen Namen, der immer auf deine aktuelle Adresse zeigt, etwa den deines Routerherstellers oder einen kostenlosen Dienst wie DuckDNS. Der Server kann den Namen von sich aus neu abfragen.

Der DNS-Eintrag

Lege einen A-Eintrag für chat.example.com an, der auf deine öffentliche IPv4-Adresse zeigt: die Adresse des VPS oder zu Hause die WAN-Adresse deines Routers. Einen AAAA-Eintrag brauchst du nicht; der Server teilt für Sprache IPv4-Adressen mit.

Prüf es von einem beliebigen Rechner aus:

nslookup chat.example.com

Der Reverse Proxy

Ein Reverse Proxy ist ein kleiner Webserver vor Mnema Talk. Er besitzt das HTTPS-Zertifikat, nimmt Verbindungen auf Port 443 an und reicht sie an die App auf 127.0.0.1:8080 weiter. Er trägt die Seite, die API und den WebSocket, aber keine Sprache.

Dein RechnerNimm
Ein VPS oder ein beliebiger Linux-RechnerCaddy (holt das Zertifikat selbst)
Synology NASDen Reverse Proxy von DSM
UnraidNginx Proxy Manager aus den Community Applications
Du betreibst schon nginxEinen Server-Block

Caddy

Der kürzeste Weg: Caddy fordert ein Let's-Encrypt-Zertifikat an und erneuert es, ohne dass du etwas einstellen musst. Installier ihn von caddyserver.com/docs/install und schreib das hier in /etc/caddy/Caddyfile:

chat.example.com {
	reverse_proxy 127.0.0.1:8080
}

8080 ist der Wert PORT in der .env; ändere beide zusammen. Dann lädst du Caddy neu und öffnest die Ports 80 und 443:

sudo systemctl reload caddysudo ufw allow 80,443/tcp

Caddy lässt WebSocket-Upgrades und den Header X-Forwarded-For von Haus aus durch.

Synology (DSM-Reverse-Proxy)

  1. Systemsteuerung > Anmeldeportal > Erweitert > Reverse Proxy > Erstellen.
  2. Quelle: Protokoll HTTPS, Hostname chat.example.com, Port 443. Ziel: Protokoll HTTP, Hostname localhost, Port 8080.
  3. Öffne beim selben Eintrag den Tab Benutzerdefinierter Header und wähle Erstellen > WebSocket. Das fügt die Header Upgrade und Connection hinzu. Überspring das nicht.
  4. Zertifikat: Systemsteuerung > Sicherheit > Zertifikat > Hinzufügen > Zertifikat von Let's Encrypt für chat.example.com anfordern. DSM braucht dafür TCP-Port 80 erreichbar, solange es das Zertifikat ausstellt und erneuert. Danach wählst du Konfigurieren und weist dem Eintrag das Zertifikat zu.

Nginx Proxy Manager (Unraid)

  1. Hosts > Proxy Hosts > Add Proxy Host.
  2. Details: Domain Names chat.example.com; Scheme http; Forward Hostname / IP: die LAN-Adresse des Unraid-Servers; Forward Port 8080; schalte Websockets Support ein.
  3. SSL: „Request a new SSL Certificate“, Force SSL einschalten, deine E-Mail-Adresse eintragen, zustimmen, Save. Port 80 muss NPM erreichen.

NPM läuft in einem eigenen Container und kommt nicht an die Loopback-Adresse des Hosts. Setze deshalb PUBLISH_ADDR=0.0.0.0 (oder die LAN-Adresse des Unraid-Servers) in der .env, trag die Adresse von NPM in TRUSTED_PROXY_CIDRS ein (Admin > Status nennt sie), führ docker compose up -d aus und lass 8080 am Router geschlossen.

nginx

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 443 ssl;
    server_name chat.example.com;
    # ssl_certificate and ssl_certificate_key for this name

    client_max_body_size 60m;          # >= MAX_UPLOAD_SIZE_MB (the ceiling), plus framing

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_read_timeout 300s;        # the WebSocket stays open
    }
}

Das Zertifikat holst du mit certbot --nginx -d chat.example.com. Leite jeden Pfad an die App weiter, auch Einladungslinks und /join/-Links, ohne Rewrite-Regeln.

Der WebSocket-Check

Nach der Anmeldung öffnet der Browser einen WebSocket auf /api/ws und hält ihn offen, für neue Nachrichten, Tippanzeige, Anwesenheit und die Signalisierung von Gesprächen. So siehst du es selbst: Öffne die Entwicklertools (F12), Network, filtere nach „WS“, lade neu. /api/ws muss den Status 101 Switching Protocols haben. 400, 426 oder 502 heißen, dass der Proxy die Header Upgrade und Connection verschluckt. Admin > Status hat einen Punkt WebSocket, der grün wird, sobald deine Sitzung durchgekommen ist.

Zertifikate

Let's Encrypt prüft meistens über einen Dateiabruf per einfachem HTTP, dass dir der Name gehört. TCP 80 muss den Proxy also erreichen, solange das Zertifikat ausgestellt und erneuert wird, etwa alle 60 Tage. Sperrt dein Anbieter Port 80, bitte den Proxy um eine DNS-Challenge (Nginx Proxy Manager kann das für viele DNS-Anbieter; Caddy braucht dafür ein DNS-Plugin).

Teste von außerhalb deines Netzes:

curl -I https://chat.example.com

Es sollte HTTP/2 200 (oder 302) ausgeben, ohne Zertifikatsfehler.

Der Browser sagtUrsacheLösung
Name mismatchDas Zertifikat gilt für einen anderen NamenStell es genau für chat.example.com aus und nutze es im Proxy-Eintrag
Not trusted / self-signedEin selbst erzeugtes oder StandardzertifikatNimm Let's Encrypt; die Desktop-App akzeptiert nur vertrauenswürdige Zertifikate
ExpiredDie Erneuerung ist gescheitert (Port 80 zu) oder die Uhr geht falschÖffne Port 80, erneuere, prüfe die Uhren

Sobald https://chat.example.com die Anmeldeseite zeigt und der WebSocket grün ist, ist der Web-Teil fertig. Zeigt Admin > Status später Reverse proxy in Gelb, übernimm den dort genannten Wert für TRUSTED_PROXY_CIDRS= in die .env und führe docker compose up -d aus.

Stimmt etwas auf dieser Seite nicht? Sag es uns.