Cloudflare Tunnel · WebSocket · Hilfe

Cloudflare Tunnel: WebSocket 1006, normale Seite funktioniert

Prüfe den WebSocket-Handshake bis zum Ursprung, wenn Live-Daten fehlen und HTTP-Aufrufe weiter funktionieren.

Quellenstand: 5. November 2026Redaktion: KAN KAI WORKSRedaktionell aktualisiert:

Kurzantwort

WebSocket-Code 1006 beschreibt einen ungewöhnlichen Verbindungsabbruch, nennt aber noch nicht dessen Ursache. Prüfe zuerst, ob der Handshake scheitert oder eine bereits aufgebaute Verbindung später endet. Status 400, Zugriffssperre und Login-Weiterleitung verlangen unterschiedliche Prüfungen. Vergleiche Browseranfrage und Origin-Protokoll zum selben Zeitpunkt; ein im Einzelbericht erfolgreicher HTTP/2-Vergleich ist keine allgemeine Reparatur und betrifft den Connector-Transport.

Quellengrundlage: Q1 · Q2 · Q3

Gilt für
Behandelt WebSockets über Cloudflare Tunnel. Der Ausgangsbericht betrifft ein Home-Assistant-Add-on ohne genau belegte cloudflared-Version; die dortige Transportumstellung bleibt ein fallspezifischer Befund.
So prüfst du das Ergebnis
Der WebSocket-Handshake gelingt, eine harmlose Live-Aktualisierung erreicht die Anwendung und die Verbindung bleibt über den zuvor problematischen Zeitraum stabil bei weiterhin wirksamer Zugriffskontrolle.
Deine erste Prüfung

Welche Antwort erhält der erste WebSocket-Handshake?

Prüfe den betroffenen Netzwerkaufruf und das Ursprungslog. HTTP 400 mit fehlendem Upgrade ist ein anderer Befund als eine Anmeldung, ein 403 oder ein später Verbindungsabbruch.

Die Oberfläche lädt, aber Statusanzeigen aktualisieren sich nicht oder die Anwendung verbindet sich ständig neu. Im Browser erscheint WebSocket-Code 1006; am Ursprung kann eine HTTP-400-Meldung über einen fehlenden Upgrade-Header stehen. Ein Home-Assistant-Bericht beschreibt diese Kombination bei Cloudflare Tunnel. Der dort genannte Transportvergleich ist ein Fallhinweis, keine universelle Reparatur. Q1

1006 beschreibt noch nicht die Ursache

Beginne beim Aufbau der Verbindung. Eine Anmeldung, eine Zugriffsblockade, ein fehlerhafter Upgrade-Versuch und ein später Abbruch benötigen verschiedene Untersuchungen. Cloudflare behandelt den anfänglichen WebSocket-Request zunächst als HTTP-Anfrage mit den dafür geltenden Kontrollen. Q2

Handshake und Betrieb getrennt prüfen

  1. Betroffenen Aufruf finden. Öffne die Netzwerkansicht des Browsers und identifiziere den WebSocket-Pfad. Notiere Status, Zeitpunkt und Verbindungslänge. Kopiere keine vollständigen URLs mit Sitzungstoken in eine Anfrage.
  2. Erste Antwort einordnen. Eine Weiterleitung zur Anmeldung verweist zunächst auf den Authentifizierungsablauf. Ein 403 verlangt einen Abgleich mit Zugriffsregeln. Ein HTTP 400 mit konkret fehlendem Upgrade führt dagegen zum Header- und Proxyweg.
  3. Ursprungsbefund vergleichen. Prüfe für dieselbe Zeit, welche Anfrage am Ursprung ankam. Vergleiche mit einem erlaubten direkten Test unter passendem Hostnamen. „Die Startseite funktioniert“ ersetzt diesen WebSocket-spezifischen Vergleich nicht.
  4. Zwischenstationen erfassen. Liste weitere Reverse Proxys, Zugangsschichten und relevante Headerregeln auf. Suche die erste Station, an der die erwartete Anfrage verändert oder anders beantwortet wird. Ändere nicht mehrere Stationen gleichzeitig.
  5. Transporthypothese begrenzt prüfen. Wenn das Fehlerbild zum Originalbericht passt, kann ein kontrollierter Vergleich des Connector-Transports sinnvoll sein. --protocol http2 betrifft die Verbindung zu Cloudflare, nicht automatisch HTTP/2 zum Ursprung. Q3 Beachte andere Routen und benötigte UDP-Dienste.

Eine echte Verbindung abnehmen

Nach der Korrektur muss nicht nur der erste Handshake gelingen. Prüfe eine harmlose Live-Aktualisierung und beobachte, ob die Verbindung stabil bleibt. Ein späterer Leerlaufabbruch ist ein neuer Befund und sollte nicht als fortbestehender Headerfehler behandelt werden.

Für Unterstützung helfen Browserstatus, anonymisierter Pfad, Ursprungsfehler, Tunnelversion und Proxykette. Notiere auch, ob der Fehler vor oder nach erfolgreichem Verbindungsaufbau entsteht. Zugangsschutz bleibt während des Vergleichs gezielt erhalten.

Häufige Fragen

Beweist 1006 einen Fehler bei Cloudflare?

Nein. Erst die Antwort beim Aufbau und die beteiligten Logs grenzen die fehlschlagende Station ein.

Kann ich den Upgrade-Header pauschal an jede Anfrage hängen?

Das ist keine saubere Diagnose. Prüfe zuerst, ob und wo eine echte WebSocket-Anfrage falsch verarbeitet wird.

Fall beschreiben

Unterstützung bei diesem Fehler

Wir können den Handshake durch Zugangsschutz, Tunnel und Ursprung verfolgen.

Fall beschreiben →Passende Leistung: Daten & Weiterentwicklung

Quellen