{"canonical_url":"https://engineer.company/de/glossary/websocket/","content_markdown":"# WebSocket\n\n## Was es ist\n\nWebSocket ist ein Protokoll für eine Verbindung, auf der beide Seiten jederzeit\nDaten senden können. Ein HTTP-Handshake stellt sie her. Sie bleibt offen, bis eine\nSeite sie schließt oder die Verbindung ausfällt. Die IETF veröffentlichte das\nProtokoll im Dezember 2011 als RFC 6455. Den Teil, den ein Browser Skripten\nbereitstellt, das `WebSocket`-Objekt, definiert der WebSockets-Standard der WHATWG.\nIn Code und Dokumentation stehen häufig auch die Schreibweisen „websocket“ und\n„web socket“. Der Plural WebSockets bezeichnet meist die Technologie insgesamt.\n\nBeim klassischen HTTP/1.1-Handshake beginnt die Verbindung mit einem gewöhnlichen\n`GET`. Der Client ergänzt `Upgrade:\nwebsocket` und `Connection: Upgrade`, eine `Sec-WebSocket-Version` von 13 und\neinen `Sec-WebSocket-Key`: einen zufälligen, in base64 kodierten 16-Byte-Wert.\nEin Server, der den Wechsel akzeptiert, antwortet mit dem Status 101 Switching Protocols und\neinem `Sec-WebSocket-Accept`-Header. Dessen Wert belegt, dass der Server genau\ndiesen Handshake gelesen hat, statt eine alte Antwort erneut abzuspielen: An den\nSchlüssel des Clients wird eine feste GUID angehängt, das Ergebnis mit SHA-1\ngehasht und in base64 kodiert. Ab dann endet HTTP auf dieser Verbindung; beide\nSeiten tauschen stattdessen Frames aus. HTTP/2 und HTTP/3 übertragen WebSocket\nhingegen über einen einzelnen Stream mit erweitertem CONNECT, wie RFC 8441 und\nRFC 9220 es festlegen.\n\nEin Frame ist klein. Sein Header beginnt bei zwei Bytes. Ist die Nutzlast länger\nals 125 Bytes, kommen zwei oder acht Bytes hinzu. Bei Frames vom Client kommen\nweitere vier Bytes für einen Maskierungsschlüssel dazu. Jeder Frame trägt einen\nOpcode: Text, Binärdaten oder Fortsetzung für eine über mehrere Frames verteilte\nNachricht. Dazu kommen drei Steuerframes für Schließen, Ping und Pong. Eine\nvollständige Textnachricht muss gültiges UTF-8 sein; ein einzelnes Fragment darf\neine UTF-8-Sequenz aufteilen. Jeden gesendeten Frame maskiert der Client mit einem\nneuen zufälligen 32-Bit-Schlüssel. Ein Server maskiert nie. Maskierung ist keine\nVerschlüsselung. Sie verhindert, dass ein bösartiges Skript die genauen über das Netz übertragenen\nBytes festlegt und damit den Zwischenspeicher eines Proxys auf dem Weg manipuliert.\n\nAdressen verwenden die Schemata `ws://` und `wss://`, mit Port 80 und Port 443\nals Standardwerten. Bei `wss` läuft der gesamte Austausch innerhalb von TLS.\nDass dies die schon von HTTP verwendeten Ports sind, ist Absicht: Für Firewalls\nund Proxys auf dem Weg sieht der Handshake wie jede andere Webanfrage aus.\n\n## Warum es wichtig ist\n\nBei kurzen HTTP-Antworten spricht der Server nur, wenn er angesprochen wird.\nViele Produkte brauchen das Gegenteil: eine Chatnachricht, einen gerade\ngeänderten Preis, einen Cursor in einem gemeinsam bearbeiteten Dokument oder\neinen abgeschlossenen Hintergrundauftrag. Ohne einen Kanal, auf dem der Server\nvon sich aus senden kann, muss der Client regelmäßig nachfragen. Er fragt alle\npaar Sekunden; die meisten Antworten besagen nur, dass sich nichts geändert\nhat. Jede bringt einen vollständigen Satz Header mit, und Neuigkeiten warten bis\nzu einem Abfrageintervall, bevor jemand sie sieht. Eine offene\nWebSocket-Verbindung beseitigt beide Kosten. Der Server kann senden, sobald etwas\npassiert, ohne die nächste Abfrage abzuwarten. Jede Nachricht braucht nur wenige\nBytes zur Rahmung statt eines vollständigen Satzes HTTP-Header.\n\nDer Preis ist der Verbindungszustand. Eine HTTP-Anfrage kann bei jedem Server\nhinter einem Lastverteiler landen. Eine WebSocket-Verbindung gehört dagegen für\nihre gesamte Lebensdauer zu einem Prozess. Dieser hält für jede offene\nVerbindung Speicher vor. Ein Deployment oder Neustart trennt sie alle auf einmal,\nund jeder Proxy und Lastverteiler auf dem Weg muss den Handshake unterstützen\nund eine möglicherweise minutenlang stille Verbindung dulden. Mit mehr als\neinem Server stellt sich eine Frage, die gewöhnliches HTTP nicht kennt: Wie\nerreicht ein Ereignis auf Server A einen Client, dessen Verbindung auf Server B\nliegt? Die übliche Antwort ist ein gemeinsamer Publish-Subscribe-Kanal, den alle\nServer abonnieren. Damit kommt ein weiteres zu betreibendes System hinzu.\n\nWebSocket ist deshalb eine bewusste Wahl, keine Standardeinstellung. Hat nur der\nServer Neuigkeiten zu senden, übertragen die im HTML-Standard definierten\nServer-Sent Events Ereignisse über eine gewöhnliche HTTP-Antwort vom Typ\n`text/event-stream`. Bricht die Antwort ab, verbindet sich der Browser von selbst\nneu. Die zusätzlichen Bestandteile von WebSocket lohnen sich, wenn der Client\nebenso viel mitzuteilen hat wie der Server, etwa bei Chats, Spielen und der\ngemeinsamen Bearbeitung von Dokumenten.\n\n## Wie es in der Praxis aussieht\n\nDer folgende Austausch öffnet eine Chatverbindung. Der Schlüssel ist der\nBeispielwert aus RFC 6455 selbst. Auch der Accept-Wert stammt aus dem Standard;\njeder korrekte Server muss ihn für diesen Schlüssel zurückgeben.\n\n```http\nGET /chat HTTP/1.1\nHost: example.com\nUpgrade: websocket\nConnection: Upgrade\nSec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\nSec-WebSocket-Version: 13\nOrigin: https://example.com\n\nHTTP/1.1 101 Switching Protocols\nUpgrade: websocket\nConnection: Upgrade\nSec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=\n```\n\nNach der Leerzeile, die die Serverantwort beendet, ist nichts auf der Verbindung\nmehr HTTP. Ein Browser erledigt den gesamten Handshake mit einem einzigen\nKonstruktoraufruf und überlässt den Rest den Ereignisbehandlern:\n\n```js\nconst socket = new WebSocket(\"wss://example.com/chat\");\nsocket.addEventListener(\"open\", () =\u003e socket.send(\"hello\"));\nsocket.addEventListener(\"message\", (event) =\u003e console.log(event.data));\nsocket.addEventListener(\"close\", (event) =\u003e {\n  console.log(event.code, event.reason, event.wasClean);\n});\n```\n\nDas Schließereignis meldet, wie die Verbindung endete. Code 1000 steht für ein\nnormales Schließen. 1001 bedeutet, dass eine Seite geht, etwa weil ein Server\nherunterfährt oder der Browser die Seite verlässt. Code 1006 bedeutet, dass die\nVerbindung ohne jeglichen Schließframe abbrach. Kein Endpunkt darf ihn senden.\nEr dient nur dazu, dass das darüberliegende Programm einen ungewöhnlichen Abbruch\nvon einem sauberen Ende unterscheiden kann.\n\nDer Unterschied zwischen Anfrage und Antwort einerseits und einem Socket\nandererseits zeigt sich deutlich in einem Projekt dieses Portfolios. Beim\nUmstieg einer API auf Huma v2 wurden\n[alle Routen bis auf genau zwei auf Humas Anfrage- und Antwortmodell umgestellt](/de/portfolio/migrated-the-api-to-huma-v2-at-100-parity/).\nDie WebSocket-Endpunkte blieben direkt auf Fiber, weil der Code dort tatsächlich\nden Socket selbst braucht und Humas Modell nicht passt. Ein am Aufbau von HTTP\nausgerichtetes Framework beschreibt und validiert Anfragen und Antworten gut.\nEine langlebige Verbindung in beide Richtungen ist schlicht etwas anderes.\n\n## Wo es schiefgeht\n\n**Eine fremde Seite öffnet eine Verbindung mit den Cookies Ihrer Besucher.**\nDer Browser sendet die Handshake-Anfrage an den Host des Servers und kann dabei\nnach Maßgabe seiner Cookie-Regeln dessen Cookies mitsenden. Erlauben diese Regeln\nauthentifizierte Anfragen von fremden Websites, kann ein per Cookie\nauthentifizierender Server, der den `Origin`-Header ignoriert, eine von einer\nfremden Seite geöffnete Verbindung als die des Besuchers akzeptieren. Laut\nRFC 6455 sollte ein nur für bestimmte Websites vorgesehener Server `Origin`\nmit den erwarteten Websites abgleichen und alle anderen mit 403 Forbidden\nabweisen. Prüfen Sie dies während des Handshakes, bevor Sie die Verbindung\nannehmen.\n\n**Das Zugriffstoken landet in den Protokollen.** Der `WebSocket`-Konstruktor des\nBrowsers nimmt eine URL und eine optionale Liste von Unterprotokollen entgegen,\nsonst nichts. Ein Skript kann daher keinen `Authorization`-Header ergänzen.\nDer schnelle Umweg ist ein Token in der URL, das Reverse-Proxys und\nZugriffsprotokolle mitschreiben. Der RFC lässt die Authentifizierung offen und\nnennt Cookies, HTTP- und TLS-Authentifizierung als Möglichkeiten. Ein Cookie mit\nder oben beschriebenen `Origin`-Prüfung funktioniert ebenso wie ein kurzlebiges,\nnur einmal verwendbares Ticket, das die Seite über einen authentifizierten\nHTTP-Aufruf abruft und beim Handshake einlöst.\n\n**Ein Neustart lässt sämtliche Clients den Server überfluten.** Ein abruptes\nDeployment oder ein Neustart kann alle Verbindungen zugleich schließen. Clients,\ndie keinen Schließframe erhalten, melden Code 1006. Verbinden sich alle sofort\nneu und versuchen es immer weiter, wird der wieder startende Server mit etwas\nkonfrontiert, das der RFC mit einem Denial-of-Service-Angriff vergleicht. RFC 6455 fordert\nClients auf, vor dem ersten Versuch eine zufällige Zeit zu warten, und schlägt\nzwischen 0 und 5 Sekunden vor. Nach jedem Fehlschlag sollen sie länger warten,\netwa mit begrenztem binärem exponentiellem Backoff. Ein Server, der seine\nVerbindungen vor dem Anhalten mit 1001 schließt, teilt den Clients zumindest\nmit, dass die Unterbrechung geplant war.\n\n```js\nfunction reconnectDelay(attempt) {\n  if (attempt === 0) return Math.random() * 5000;\n  const ceiling = Math.min(60_000, 1000 * 2 ** attempt);\n  return Math.random() * ceiling;\n}\n```\n\n**Verbindungen brechen ab, und niemand merkt es.** Eine Verbindung ohne Verkehr\ngibt keiner Seite ein Zeichen, dass der Weg noch besteht. Eine ohne Schließframe\nverschwundene Gegenstelle sieht bis zum nächsten fehlgeschlagenen Schreibzugriff\ngenauso aus wie eine stille. Dafür gibt es Ping und Pong: Ein Endpunkt muss auf\neinen Ping mit einem Pong antworten, sofern er nicht bereits einen Schließframe\nerhalten hat. Sind mehrere Pings unbeantwortet, darf er nur auf den jüngsten\nantworten. Der RFC hält fest, dass ein Ping als Lebenszeichen oder zur Prüfung\ndienen kann, ob die Gegenstelle noch reagiert. Die Browser-API bietet keine\nMöglichkeit, einen Ping zu senden. Der Timer gehört daher auf den Server: Pingen\nSie jede Verbindung in festen Abständen und schließen Sie diejenigen, deren Pong\nausbleibt.\n\n**Eine Nachricht verbraucht den gesamten Serverspeicher.** Das Längenfeld im\nFrame-Header lässt Nutzlasten zu, die viel größer sind als der Speicher eines\nServers. Der RFC warnt vor einer bösartigen Gegenstelle, die einen riesigen Frame\noder eine endlose Folge kleiner Fragmente sendet. Implementierungen müssen sich\nschützen. Setzen Sie deshalb in der Serverbibliothek eine maximale\nNachrichtengröße und schließen Sie bei Überschreitung mit Code 1009, Nachricht\nzu groß. Derselbe Rückstau entsteht in der Gegenrichtung. Im Browser meldet\n`bufferedAmount` die Bytes, die `send()` eingereiht hat und die noch auf ihre\nÜbertragung warten. Das WHATWG-Beispiel sendet die nächste Aktualisierung erst,\nwenn diese Zahl null ist. Auf dem Server füllt ein langsam lesender Client den\nAusgabepuffer ebenso. Jede Verbindung braucht daher eine Obergrenze dafür und\neine Regel, was beim Erreichen dieser Grenze geschieht.\n\n## Weiterführende Lektüre\n\n- [RFC 6455: The WebSocket Protocol](https://www.rfc-editor.org/rfc/rfc6455) —\n  Handshake, Rahmung, Maskierung und Schließcodes sowie die Sicherheitsgründe\n  hinter jeder dieser Entscheidungen.\n- [WebSockets-Standard](https://websockets.spec.whatwg.org/) — die Browser-API:\n  Konstruktor, `send()`, `close()`, `bufferedAmount` und das Schließereignis.\n- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110) — das\n  Headerfeld `Upgrade` und der Status 101 Switching Protocols, auf denen der\n  Handshake beruht.\n- [Server-Sent Events](https://html.spec.whatwg.org/multipage/server-sent-events.html)\n  — die einseitige Alternative des HTML-Standards mit eingebautem Neuverbinden.\n- [RFC 8441: Bootstrapping WebSockets with HTTP/2](https://www.rfc-editor.org/rfc/rfc8441)\n  — erweitertes CONNECT überträgt WebSocket auf einem multiplexierten\n  HTTP/2-Stream.\n- [RFC 9220: Bootstrapping WebSockets with HTTP/3](https://www.rfc-editor.org/rfc/rfc9220)\n  — der entsprechende Mechanismus mit erweitertem CONNECT für HTTP/3.\n\n\u003chttps://engineer.company/de/glossary/websocket/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Wie aus einer HTTP-Anfrage eine offene Zweiwegeverbindung wird, wann sie Abfragen überlegen ist und welche fünf Fehler langlebige Sockets beeinträchtigen.","formats":{"gemtext":"https://engineer.company/de/glossary/websocket/index.gmi","gopher":"https://engineer.company/de/glossary/websocket/gophermap","html":"https://engineer.company/de/glossary/websocket/","json":"https://engineer.company/de/glossary/websocket/index.json","markdown":"https://engineer.company/de/glossary/websocket/index.md","pdf":"https://engineer.company/de/glossary/websocket/index.pdf"},"kind":"page","language":"de","title":"Was ist WebSocket?","url":"https://engineer.company/de/glossary/websocket/","version":1}