docs(rvs): WebSocket-Weiterleitung beim Reverse-Proxy deutlich markieren + Testbefehl

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 12:29:30 +01:00
parent 8cc85c1fe1
commit 2267f0a726
1 changed files with 15 additions and 0 deletions
@@ -888,6 +888,21 @@ dort liegen). Im Proxy als Ziel `https://<ip>:<port>`, das Zertifikat dabei
 Umstellen von Caddy:
 `docker compose rm -sf caddy && docker compose up -d`.
 > ⚠️ **WebSocket nicht vergessen!** Der RVS ist fast nur WebSocket. Ohne
 > WebSocket-Weiterleitung laedt im Browser zwar eine Seite (404 o.ae.), aber
 > App, Bridge, Satelliten und KI-Boxen bekommen **keine Verbindung** — ohne
 > klare Fehlermeldung. Beim Neueinrichten des Proxys immer pruefen:
 >
 > - **Nginx Proxy Manager:** im Proxy Host den Schalter **„Websockets Support"**
 >   einschalten (bei `RVS_HTTP_TLS=true` zusaetzlich Scheme **`https`**).
 > - **nginx von Hand:** `proxy_http_version 1.1;` plus die beiden Header
 >   `Upgrade` / `Connection "upgrade"` (siehe Beispiel unten) und lange
 >   Timeouts — sonst trennt nginx die Verbindung nach 60 s Stille.
 > - **Test:** `curl -i -H "Connection: Upgrade" -H "Upgrade: websocket"
 >   -H "Sec-WebSocket-Version: 13" -H "Sec-WebSocket-Key: dGVzdHRlc3R0ZXN0dGVzdA=="
 >   "https://<dein-name>/?token=test"` muss mit **`101 Switching Protocols`**
 >   antworten. Kommt 200/400/404, fehlt die WebSocket-Weiterleitung.
 nginx-Beispiel (WebSocket braucht HTTP/1.1 + Upgrade-Header und lange Timeouts):
 ```nginx