Por qué el HTTP simple no basta
El HTTP clásico es solicitud y respuesta. El cliente pregunta, el servidor responde, y el servidor no puede volver a hablar hasta que se le pregunta. Para una página que cambia cuando el usuario hace clic, eso está bien. Para una ventana de chat, un teletipo de precios o un juego, el servidor tiene novedades que el cliente no pidió.
Las soluciones alternativas tienen nombre. El polling pregunta cada pocos segundos si algo ha cambiado; la mayoría de las respuestas son «no», y cada una cuesta una solicitud completa. El long polling mantiene una solicitud abierta hasta que el servidor tiene algo que decir y luego vuelve a empezar. Ambos funcionan, y ambos añaden latencia y sobrecarga al forzar solicitud y respuesta hacia algo para lo que no fueron diseñadas.
WebSocket (RFC 6455) lo resuelve en el propio protocolo: una conexión, abierta una vez, por la que cliente y servidor envían mensajes cuando quieren, en ambos sentidos, con unos pocos bytes de entramado por mensaje.
El handshake de actualización
Un WebSocket nace como HTTP. El navegador envía una solicitud GET con Upgrade: websocket y Connection: Upgrade, una Sec-WebSocket-Key aleatoria y la versión del protocolo. Un servidor que acepta responde 101 Switching Protocols con un valor Sec-WebSocket-Accept calculado a partir de la clave, que demuestra que entendió la solicitud en lugar de repetir una respuesta en caché.
Tras el 101, HTTP termina en esa conexión. La misma conexión TCP y TLS transporta ahora tramas WebSocket: mensajes de texto o binarios, además de pequeñas tramas de control llamadas ping, pong y close. El esquema de URL es ws://, o wss:// sobre TLS. En un sitio público use siempre wss://: funciona en el puerto 443 como HTTPS y atraviesa redes que bloquean cualquier cosa fuera de lo normal.
Esta es la forma HTTP/1.1. HTTP/2 y HTTP/3 tienen su propia manera de transportar WebSocket (RFC 8441 y RFC 9220), pero la actualización de HTTP/1.1 sigue siendo lo que hablan la mayoría de los servidores y proxies hacia la aplicación.
El handshake: solicitud y respuesta
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=
Cuándo usar WebSocket y cuándo no
Buenos casos de uso. Chats y widgets de soporte, paneles en vivo y pantallas de trading, juegos multijugador, editores colaborativos, presencia («quién está en línea») y cualquier aplicación en la que el servidor envía eventos y el cliente responde rápido.
Los Server-Sent Events (SSE) son la opción más sencilla cuando solo habla el servidor: feeds de noticias, logs de compilación, barras de progreso, notificaciones. SSE es HTTP simple con una respuesta que sigue transmitiéndose, se reconecta por sí solo y pasa por donde pasa HTTP.
El HTTP simple sigue siendo lo correcto para todo lo que es solicitud y respuesta: páginas, API, descargas de archivos. Eso se puede almacenar en caché; un mensaje de WebSocket no. Un buen diseño usa ambos: HTTP para cargar datos y recursos, un WebSocket para las actualizaciones en vivo.
Por qué las conexiones WebSocket se caen detrás de proxies
Un WebSocket atraviesa todos los saltos entre el navegador y su aplicación: proxies corporativos, balanceadores de carga, un CDN, el nginx delante de su aplicación. Cada uno de ellos tiene que acertar en dos cosas.
Dejar pasar la actualización. Upgrade y Connection son cabeceras hop-by-hop: un proxy no las reenvía a menos que se le indique. Si un salto las descarta, su aplicación recibe un GET normal y responde 400 o 404, y el navegador informa de que el handshake falló.
Permitir tiempo de inactividad. Los proxies cierran las conexiones en las que no ha pasado nada durante un tiempo. Un WebSocket puede quedarse en silencio durante minutos entre mensajes, así que un límite de inactividad pensado para HTTP lo cierra. En nginx ese límite es proxy_read_timeout, 60 segundos por defecto: si el backend no envía nada durante 60 segundos, nginx cierra la conexión y el navegador ve el código de cierre 1006.
La solución tiene dos mitades. Suba el límite de inactividad en los saltos que transportan tráfico WebSocket, y haga que la aplicación envíe un ping, o un pequeño mensaje de latido, con más frecuencia que el límite de inactividad más corto del camino; cada 20 a 30 segundos es lo habitual. Mientras fluyan datos, la conexión sigue abierta.
nginx delante de una aplicación WebSocket
Si nginx hace de proxy hacia su aplicación, el location de WebSocket necesita HTTP/1.1 hacia el backend, las dos cabeceras de actualización y timeouts más largos que su intervalo de latido. El map envía Connection: upgrade para las solicitudes WebSocket y cierra las normales de la forma habitual, así que un solo location sirve para ambas.
proxy_read_timeout es cuánto espera nginx a que el backend envíe algo; proxy_send_timeout es cuánto espera mientras envía al backend. Ninguno limita la duración total de una conexión: un socket que lleva un mensaje cada 30 segundos puede seguir abierto durante días.
nginx: proxy de conexiones WebSocket a una aplicación en el puerto 3000
# a nivel de http {}
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;
# más largo que el intervalo de ping de la aplicación
proxy_read_timeout 300s;
proxy_send_timeout 300s;
}
}
WebSocket en cdn.com.tr
En cdn.com.tr, WebSocket es un ajuste de cada regla de entrega. Cree una regla para la ruta que su aplicación usa para WebSocket, como /ws/ o /socket.io/, y active Permitir conexiones WebSocket. El edge pasa el handshake del visitante a su origen y, cuando su origen responde 101, la conexión permanece abierta entre ambos mientras fluyen los datos. Las respuestas en esa ruta no se almacenan en caché, que es justo lo que necesita una conexión en vivo.
La misma regla tiene dos timeouts, cada uno de 1 a 3600 segundos: cuánto espera el edge a que su origen envíe algo y cuánto espera mientras envía a su origen. El valor por defecto es de 60 segundos. En el dominio de sus aplicaciones de Managed Container, WebSocket está activado por defecto y ambos timeouts son de 300 segundos a menos que la regla defina otros valores. Fije el timeout de lectura por encima del intervalo de ping de su aplicación y los sockets inactivos seguirán abiertos.
Dé a WebSocket su propia regla. El resto del sitio conserva su caché, su optimización de imágenes y su compresión, y la ruta de WebSocket obtiene una conexión que pasa directamente a su origen. La guía de conexión con el origen muestra los campos; los mismos timeouts sirven también para solicitudes HTTP de larga duración, que de otro modo terminan en un 504 Gateway Timeout.
Mantener conectados a los clientes
Incluso con todos los timeouts bien, las conexiones terminan: un teléfono cambia de red, un portátil se suspende, se despliega una nueva versión de su aplicación. Trate un socket cerrado como un evento normal y diseñe en consecuencia.
Reconecte automáticamente, con una espera que crece tras cada intento fallido (por ejemplo 1, 2, 4 y 8 segundos, hasta un techo) más un poco de aleatoriedad, para que miles de clientes no se reconecten todos en el mismo segundo.
Reanude, no reinicie. Envíe el ID o la marca de tiempo del último mensaje al reconectar, para que el servidor pueda reenviar lo que el cliente se perdió.
Envíe latidos desde el servidor, o desde el cliente si su biblioteca no lo hace, y trate un pong ausente como una conexión muerta.
Socket.IO y muchas bibliotecas cliente de WebSocket hacen la mayor parte de esto por usted; compruebe que esté activado.
Dónde brilla WebSocket
Los mensajes y los indicadores de escritura llegan en el momento en que se envían, sin una solicitud cada pocos segundos.
Precios, pedidos y métricas enviados a la pantalla a medida que cambian.
Movimientos, cursores y ediciones compartidos entre jugadores o editores con un retraso mínimo.
Cómo configurarlo
Guías paso a paso en el centro de ayuda:
Preguntas frecuentes sobre WebSocket
¿Es WebSocket más rápido que HTTP?
Para mensajes pequeños y frecuentes, sí: tras el handshake cada mensaje lleva unos pocos bytes de entramado en lugar de un conjunto completo de cabeceras HTTP, y el servidor puede enviar sin esperar una solicitud. Para páginas, archivos y respuestas de API, HTTP es la mejor herramienta, y se puede almacenar en caché.
¿Cuál es la diferencia entre ws:// y wss://?
wss:// es WebSocket sobre TLS, igual que https:// es HTTP sobre TLS. Va cifrado y atraviesa proxies y firewalls con mucha más fiabilidad. Use wss:// en cualquier sitio público.
¿Por qué mi WebSocket se cierra exactamente a los 60 segundos?
Un proxy del camino cierra las conexiones que permanecen inactivas durante 60 segundos, que es el valor por defecto de nginx para proxy_read_timeout. Suba el timeout en ese salto y haga que su aplicación envíe un ping cada 20 a 30 segundos.
¿Funcionan las conexiones WebSocket a través de un CDN?
Sí, cuando el CDN deja pasar la actualización. En cdn.com.tr activa WebSocket en la regla de entrega de esa ruta; la conexión llega entonces a su origen y permanece abierta mientras fluyen los datos.
¿Se pueden almacenar en caché los mensajes de WebSocket?
No. Los mensajes pertenecen a una conexión en vivo. Almacene en caché la parte HTTP de su aplicación, sus páginas, recursos y respuestas de API, y mantenga la ruta de WebSocket en una regla propia.
¿Cuánto tiempo puede permanecer abierta una conexión WebSocket?
En cdn.com.tr no hay límite para la duración total: mientras fluyan datos, la conexión sigue abierta. Lo que fija por regla, hasta 3600 segundos, es cuánto tiempo puede permanecer inactiva.