Pourquoi HTTP seul ne suffit pas
HTTP classique, c'est requête et réponse. Le client demande, le serveur répond, et le serveur ne peut pas reprendre la parole tant qu'on ne le lui demande pas. Pour une page qui change quand l'utilisateur clique, c'est suffisant. Pour une fenêtre de chat, un cours de bourse en direct ou un jeu, le serveur a des nouvelles que le client n'a pas demandées.
Les contournements ont un nom. Le polling demande toutes les quelques secondes si quelque chose a changé ; la plupart des réponses sont « non », et chacune coûte une requête complète. Le long polling garde une requête ouverte jusqu'à ce que le serveur ait quelque chose à dire, puis recommence. Les deux fonctionnent, et les deux ajoutent de la latence et de la surcharge pour plier requête et réponse vers un usage pour lequel ils n'ont pas été conçus.
WebSocket (RFC 6455) résout cela dans le protocole : une seule connexion, ouverte une fois, sur laquelle client et serveur s'envoient des messages quand ils le souhaitent, dans les deux sens, avec quelques octets de trame par message.
Le handshake d'upgrade
Un WebSocket naît en HTTP. Le navigateur envoie une requête GET avec Upgrade: websocket et Connection: Upgrade, une Sec-WebSocket-Key aléatoire et la version du protocole. Un serveur qui accepte répond 101 Switching Protocols avec une valeur Sec-WebSocket-Accept calculée à partir de la clé, ce qui prouve qu'il a compris la requête au lieu de rejouer une réponse en cache.
Après le 101, HTTP est terminé sur cette connexion. La même connexion TCP et TLS transporte désormais des trames WebSocket : des messages texte ou binaires, plus de petites trames de contrôle appelées ping, pong et close. Le schéma d'URL est ws://, ou wss:// sur TLS. Sur un site public, utilisez toujours wss:// : il passe par le port 443 comme HTTPS et traverse les réseaux qui bloquent tout ce qui sort de l'ordinaire.
Voilà pour la forme HTTP/1.1. HTTP/2 et HTTP/3 ont leur propre manière de transporter WebSocket (RFC 8441 et RFC 9220), mais l'upgrade HTTP/1.1 reste ce que la plupart des serveurs et des proxys parlent vers l'application.
Le handshake : requête et réponse
GET /chat HTTP/1.1
Host: app.example.com
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==
Sec-WebSocket-Version: 13
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=
Quand utiliser WebSocket, et quand ne pas l'utiliser
Bons cas d'usage. Les widgets de chat et de support, les tableaux de bord en direct et les écrans de trading, les jeux multijoueurs, les éditeurs collaboratifs, la présence (« qui est en ligne »), et toute application où le serveur pousse des événements et où le client répond rapidement.
Les Server-Sent Events (SSE) sont le choix le plus simple quand seul le serveur parle : fils d'actualité, logs de build, barres de progression, notifications. SSE, c'est du HTTP ordinaire avec une réponse qui continue d'être diffusée, se reconnecte toute seule et passe partout où HTTP passe.
HTTP ordinaire reste la bonne solution pour tout ce qui est requête et réponse : pages, API, téléchargements de fichiers. Ceux-là peuvent être mis en cache ; un message WebSocket, non. Une bonne conception utilise les deux : HTTP pour charger les données et les ressources, un WebSocket pour les mises à jour en direct.
Pourquoi les connexions WebSocket tombent derrière des proxys
Un WebSocket traverse chaque saut entre le navigateur et votre application : proxys d'entreprise, répartiteurs de charge, un CDN, nginx devant votre application. Chacun d'eux doit réussir deux choses.
Laisser passer l'upgrade. Upgrade et Connection sont des en-têtes hop-by-hop : un proxy ne les transmet que si on le lui demande. Si un saut les supprime, votre application reçoit un simple GET et répond 400 ou 404, et le navigateur signale l'échec du handshake.
Tolérer l'inactivité. Les proxys ferment les connexions sur lesquelles rien ne s'est passé depuis un moment. Un WebSocket peut rester silencieux pendant des minutes entre deux messages ; une limite d'inactivité pensée pour HTTP le ferme donc. Dans nginx, cette limite est proxy_read_timeout, 60 secondes par défaut : si le backend n'envoie rien pendant 60 secondes, nginx ferme la connexion et le navigateur voit le code de fermeture 1006.
La solution comporte deux volets. Augmentez la limite d'inactivité sur les sauts qui transportent du trafic WebSocket, et faites envoyer par l'application un ping, ou un petit message de heartbeat, plus souvent que la plus courte limite d'inactivité du chemin ; toutes les 20 à 30 secondes est typique. Tant que des données circulent, la connexion reste ouverte.
nginx devant une application WebSocket
Si nginx fait proxy vers votre application, le bloc location WebSocket a besoin de HTTP/1.1 vers le backend, des deux en-têtes d'upgrade, et de timeouts plus longs que votre intervalle de heartbeat. Le map envoie Connection: upgrade pour les requêtes WebSocket et ferme normalement les requêtes ordinaires, si bien qu'un seul bloc location sert les deux.
proxy_read_timeout est le temps pendant lequel nginx attend que le backend envoie quelque chose ; proxy_send_timeout est le temps pendant lequel il attend lors de l'envoi vers le backend. Aucun des deux ne limite la durée totale d'une connexion : un socket qui porte un message toutes les 30 secondes peut rester ouvert des jours.
nginx : proxy des connexions WebSocket vers une application sur le port 3000
# http {} level
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
# ...
location /ws/ {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
# longer than the app's ping interval
proxy_read_timeout 300s;
proxy_send_timeout 300s;
}
}
WebSocket sur cdn.com.tr
Sur cdn.com.tr, WebSocket est un réglage de chaque règle de diffusion. Créez une règle pour le chemin que votre application utilise pour WebSocket, comme /ws/ ou /socket.io/, et activez Autoriser les connexions WebSocket. La périphérie transmet le handshake du visiteur à votre origine, et dès que votre origine répond 101, la connexion reste ouverte entre eux tant que des données circulent. Les réponses sur ce chemin ne sont pas mises en cache, ce qui est exactement ce dont une connexion en direct a besoin.
La même règle comporte deux timeouts, chacun de 1 à 3 600 secondes : le temps pendant lequel la périphérie attend que votre origine envoie quelque chose, et le temps pendant lequel elle attend lors de l'envoi vers votre origine. La valeur par défaut est de 60 secondes. Sur le domaine de vos applications Managed Container, WebSocket est activé par défaut et les deux timeouts sont de 300 secondes, sauf si la règle définit d'autres valeurs. Réglez le timeout de lecture au-dessus de l'intervalle de ping de votre application et les sockets inactifs restent ouverts.
Donnez à WebSocket sa propre règle. Le reste du site conserve sa mise en cache, son optimisation d'images et sa compression, et le chemin WebSocket obtient une connexion transmise directement à votre origine. Le guide de la connexion à l'origine présente les champs ; les mêmes timeouts servent aussi aux requêtes HTTP de longue durée, qui se terminent sinon par une 504 Gateway Timeout.
Garder les clients connectés
Même avec tous les timeouts bien réglés, les connexions se terminent : un téléphone change de réseau, un portable se met en veille, une nouvelle version de votre application est déployée. Traitez un socket fermé comme un événement normal et concevez en conséquence.
Reconnectez-vous automatiquement, avec un délai qui augmente après chaque tentative échouée (par exemple 1, 2, 4 et 8 secondes, jusqu'à un plafond) plus un peu d'aléa, pour que des milliers de clients ne se reconnectent pas tous dans la même seconde.
Reprenez, ne recommencez pas. Envoyez l'ID ou l'horodatage du dernier message à la reconnexion, pour que le serveur puisse rejouer ce que le client a manqué.
Envoyez des heartbeats depuis le serveur, ou depuis le client si votre bibliothèque ne le fait pas, et considérez l'absence de pong comme une connexion morte.
Socket.IO et de nombreuses bibliothèques client WebSocket font l'essentiel de cela pour vous ; vérifiez que c'est activé.
Là où WebSocket brille
Les messages et les indicateurs de saisie arrivent à l'instant où ils sont envoyés, sans une requête toutes les quelques secondes.
Prix, commandes et métriques poussés à l'écran au fur et à mesure qu'ils changent.
Déplacements, curseurs et modifications partagés entre joueurs ou éditeurs avec un délai minimal.
Comment le mettre en place
Guides pas à pas dans le centre d'aide :
FAQ WebSocket
WebSocket est-il plus rapide que HTTP ?
Pour de petits messages fréquents, oui : après le handshake, chaque message ne porte que quelques octets de trame au lieu d'un jeu complet d'en-têtes HTTP, et le serveur peut envoyer sans attendre de requête. Pour les pages, les fichiers et les réponses d'API, HTTP est le meilleur outil, et il peut être mis en cache.
Quelle est la différence entre ws:// et wss:// ?
wss:// est WebSocket sur TLS, comme https:// est HTTP sur TLS. Il est chiffré et traverse les proxys et les pare-feu de façon bien plus fiable. Utilisez wss:// sur tout site public.
Pourquoi mon WebSocket se ferme-t-il au bout d'exactement 60 secondes ?
Un proxy du chemin ferme les connexions restées inactives pendant 60 secondes, ce qui est la valeur par défaut de nginx pour proxy_read_timeout. Augmentez le timeout sur ce saut et faites envoyer un ping par votre application toutes les 20 à 30 secondes.
Les connexions WebSocket fonctionnent-elles à travers un CDN ?
Oui, quand le CDN laisse passer l'upgrade. Sur cdn.com.tr, vous activez WebSocket dans la règle de diffusion de ce chemin ; la connexion atteint alors votre origine et reste ouverte tant que des données circulent.
Les messages WebSocket peuvent-ils être mis en cache ?
Non. Les messages appartiennent à une connexion en direct. Mettez en cache la partie HTTP de votre application, ses pages, ses ressources et ses réponses d'API, et gardez le chemin WebSocket sur une règle à part.
Combien de temps une connexion WebSocket peut-elle rester ouverte ?
Sur cdn.com.tr, il n'y a pas de limite à la durée totale : tant que des données circulent, la connexion reste ouverte. Ce que vous réglez par règle, jusqu'à 3 600 secondes, c'est la durée pendant laquelle elle peut rester inactive.