Guía de despliegue

TLS handshake timeout: diagnosticar el ClientHello poscuántico

Desplegar en un VPS Cloud →

TLS handshake timeout: diagnosticar el ClientHello poscuántico

Desde finales de octubre de 2026, herramientas como `ollama pull` fallan con `net/http: TLS handshake timeout` en servidores que sí responden a curl. El servidor no está caído: los clientes recientes anuncian por defecto un intercambio de claves poscuántico, su primer mensaje es mucho mayor y un equipo del camino lo descarta. Esta guía explica el mecanismo, da dos comandos openssl que lo prueban en pocos minutos y ordena las soluciones: reparar primero el camino y desactivar lo poscuántico en un solo proceso como último recurso.

10 min de lectura16 pasos
Contenido· El síntoma: curl responde, la herramienta caduca1/12
  1. 01El síntoma: curl responde, la herramienta caduca
  2. 02Por qué un ClientHello mayor puede bloquearlo todo
  3. 03Síntoma, causa probable y prueba que decide
  4. 04Diagnosticar en diez minutos
  5. 05Quién bloquea: servidor remoto, equipo intermedio o camino de acceso
  6. 06Corregir o, en su defecto, rodear
  7. 07Ollama en un VPS: el caso del hilo #19430
  8. 08Lo que cuesta el parche GODEBUG=tlsmlkem=0
  9. 09Probar antes de rodear
  10. 10Resolución de problemas: los mensajes que encontrará
  11. 11Conservar la prueba, no solo el parche
  12. 12Para ir más lejos

El síntoma: curl responde, la herramienta caduca

El escenario típico cabe en tres líneas. Una descarga lanzada por una herramienta escrita en Go se detiene con Error: pull model manifest: Get "https://registry.ollama.ai/...": net/http: TLS handshake timeout. El mismo servidor, consultado con un curl de generación anterior, responde en una fracción de segundo. Y repetir no cambia nada: tres intentos de tres fallan igual.

Éste es el patrón del hilo ollama/ollama#19430, abierto el 31 de octubre de 2026. Lo que hay que retener es la asimetría: la conexión TCP se establece y luego el handshake TLS nunca termina. No es un DNS roto, un puerto cerrado ni un certificado caducado, que darían otros mensajes. Cuando TCP funciona y solo el primer mensaje TLS queda sin respuesta, se mira el tamaño y la forma de ese mensaje, el ClientHello.

Por qué un ClientHello mayor puede bloquearlo todo

El ClientHello es el primer mensaje de una conexión TLS: el cliente lista ahí sus algoritmos y envía sus partes del intercambio de claves. Desde Go 1.24, la biblioteca estándar activa por defecto el intercambio híbrido poscuántico X25519MLKEM768 cuando Config.CurvePreferences es nil. OpenSSL 3.5.0, publicado el 8 de abril de 2025, hace lo mismo: su lista de grupos por defecto pone X25519MLKEM768 en cabeza y envía dos partes de clave, X25519MLKEM768 y X25519.

La parte ML-KEM es voluminosa. En el hilo #19430 el ClientHello poscuántico pesa 1573 bytes, frente a 512 del clásico: ya no cabe en un solo paquete. Ahora bien, algunos servidores y equipos suponen que el ClientHello llega en una sola lectura TCP. El sitio tldr.fail describe este fallo: el servidor lee el primer fragmento, juzga inválido el handshake y corta, cuando un servidor correcto ignoraría la opción desconocida. El fallo es anterior a lo poscuántico y el tamaño solo lo revela. La documentación de Go lo presenta como la razón para usar GODEBUG=tlsmlkem=0.

Síntoma, causa probable y prueba que decide

Desplace la tabla

SíntomaCausa probablePrueba que decide
Solo el grupo híbrido caduca con `openssl s_client`ClientHello poscuántico filtrado o mal leído`-groups X25519MLKEM768` y luego `-groups X25519`
curl pasa con `--curves X25519:P-256`, el cliente Go caducaEl cliente Go anuncia el grupo híbrido por defecto`GODEBUG=tlsmlkem=0` solo en ese proceso
Todo caduca, incluso con X25519 soloCortafuegos o enrutamiento: el tamaño no es la causa`curl -v` a otro servidor y otro puerto
Las peticiones pequeñas pasan, los intercambios grandes se congelanMTU o MSS, agujero negro ICMP`ping -M do -s 1472` y luego `tcp_mtu_probing`
Un solo servidor falla, desde todas sus redesServidor que lee mal un ClientHello fragmentadoLa misma prueba desde una segunda red
Fallo en una red, éxito en otraFiltrado del acceso: operador, empresa, equipo intermedioSegundo camino: un VPS o la conexión del móvil
Corte inmediato (reset) tras el ClientHelloEquipo que corta ante un mensaje inesperado`tcpdump`: un RST justo después del ClientHello

Diagnosticar en diez minutos

  1. Reproducir con curl

    Mida el tiempo y el código de respuesta: curl -sS -o /dev/null -w '%{http_code} %{time_total}\n' https://example.com/. Si curl responde rápido y su herramienta caduca, el servidor es alcanzable y el fallo está en otra parte.

  2. Forzar un ClientHello clásico

    Repita con curl --curves X25519:P-256 -sS -o /dev/null -w '%{http_code} %{time_total}\n' https://example.com/. En el hilo #19430, este ClientHello de 512 bytes obtiene respuesta en 0,32 s. Según la biblioteca TLS de su curl, la opción puede rechazarse: lea el mensaje antes de concluir.

  3. Comparar los dos grupos con openssl

    Hace falta OpenSSL 3.5 o superior para la primera prueba. Ejecute timeout 10 openssl s_client -connect example.com:443 -servername example.com -tls1_3 -groups X25519MLKEM768 </dev/null y luego el mismo comando con -groups X25519.

  4. Leer el veredicto

    Si X25519 solo termina y el grupo híbrido queda sin respuesta hasta el límite, el ClientHello poscuántico es demasiado grande o está filtrado. En el hilo, el híbrido caduca a los 8 segundos. Si ambos fallan, no es este fallo.

  5. Descartar la MTU

    Pruebe ping -M do -s 1472 example.com: el paquete de 1500 bytes sin fragmentación debe pasar. Lea también sysctl net.ipv4.tcp_mtu_probing: 0 desactiva la detección, 1 la activa cuando se detecta un agujero negro ICMP, 2 la mantiene siempre activa.

  6. Capturar el diálogo, opcional

    Con sudo tcpdump -ni any host IP_DEL_SERVIDOR and tcp port 443, mire lo que sigue al ClientHello: retransmisiones sin respuesta indican un paquete descartado, un RST indica un corte activo.

  7. Cambiar de camino de red

    Repita los dos comandos openssl desde otra conexión: la conexión compartida del móvil o un VPS. Mismo resultado en todas partes, el fallo está en el servidor remoto. Resultado distinto, está en su acceso.

Quién bloquea: servidor remoto, equipo intermedio o camino de acceso

La prueba desde una segunda red señala al culpable. Si el servidor falla desde todas partes, es un servidor o un equipo situado delante: un proxy inverso antiguo, un cortafuegos de aplicación, un balanceador que lee mal un ClientHello fragmentado. No puede corregirlo, pero sí avisar al operador adjuntando los dos comandos openssl y su resultado, lo que ahorra la ida y vuelta habitual.

Si el servidor responde desde una red y no desde la otra, el fallo está en su camino de acceso: un equipo de inspección TLS de empresa, un cortafuegos que no reconoce el código del grupo híbrido o un filtrado de un proveedor de acceso. Es el caso descrito en el hilo #19430, donde el informante está en un operador que descarta en silencio estos ClientHello. En ese hilo el bloqueo sigue a la dirección IP de destino, no al nombre SNI, y la prueba de MTU pasa: la pista de la MTU quedó descartada.

Corregir o, en su defecto, rodear

  1. Corregir el camino cuando es suyo

    Actualice el proxy inverso, el cortafuegos o el equipo de inspección que rechaza el ClientHello. Es la única solución que conserva lo poscuántico.

  2. Tratar la MTU si la prueba la mostró

    Si ping -M do -s 1472 falla, active la detección con sudo sysctl -w net.ipv4.tcp_mtu_probing=1 y haga persistente el valor en un archivo de /etc/sysctl.d/. Es una pista distinta, que se prueba después del grupo híbrido.

  3. Desactivar lo poscuántico en un cliente Go

    Lance el comando con GODEBUG=tlsmlkem=0, por ejemplo GODEBUG=tlsmlkem=0 ./mi-herramienta. El cliente solo anuncia grupos clásicos y el ClientHello vuelve a un tamaño ordinario.

  4. Ponerlo en un servicio systemd

    Cree un drop-in con sudo systemctl edit mi-servicio, añada bajo [Service] la línea Environment="GODEBUG=tlsmlkem=0" y luego sudo systemctl restart mi-servicio.

  5. Ponerlo en un contenedor

    Con Docker, añada -e GODEBUG=tlsmlkem=0 a docker run. Con Compose, añada - GODEBUG=tlsmlkem=0 bajo environment: del servicio afectado y ejecute docker compose up -d.

  6. Retirar el parche en cuanto se repare el camino

    Anote en su repositorio de configuración por qué está la variable. Cuando se corrija el equipo o el servidor, elimínela y repita la prueba openssl para comprobar que el grupo híbrido pasa.

Ollama en un VPS: el caso del hilo #19430

El hilo informa de este comportamiento con Ollama 0.40.13, en la imagen oficial ollama/ollama:latest bajo Docker, en una conexión de un proveedor de acceso sin VPN ni proxy. El error es el citado arriba, sobre registry.ollama.ai. El informante midió 1573 bytes para el ClientHello poscuántico, que caduca, y 512 para el clásico, que recibe una respuesta 404 en 0,32 s. Con GODEBUG=tlsmlkem=0 en el proceso que descarga, tres intentos de tres funcionan, frente a tres fallos de tres sin ella.

En el momento de escribir, este hilo está abierto y no menciona ninguna corrección oficial: la solución provisional es la del informante, presentada como temporal. Para un Ollama en un VPS, la consecuencia es práctica. Si ollama pull caduca mientras curl alcanza el registro, aplique el diagnóstico anterior desde el VPS, ponga después la variable en el contenedor ollama, con docker run -e GODEBUG=tlsmlkem=0 ... o bajo environment: en Compose, y repita docker exec ollama ollama pull el-modelo. Un VPS ofrece además un camino de red distinto del suyo: si descarga el modelo sin la variable, el filtrado está en su acceso.

Lo que cuesta el parche GODEBUG=tlsmlkem=0

  • Se acabó lo poscuántico — el proceso ya no anuncia X25519MLKEM768: sus conexiones pierden la protección frente al tráfico capturado hoy y descifrado más tarde.
  • Un alcance amplio — la variable vale para todo el proceso, es decir, para todas sus llamadas salientes, no solo para el servidor que da problemas.
  • Un ajuste temporal — es un parche, no una corrección: oculta un defecto del camino de red que sigue ahí.
  • Una deuda que documentar — sin un comentario en la configuración, la variable sobrevive años y nadie sabe por qué.
  • Sin garantía universal — si el filtrado no viene del ClientHello, la variable no cambia nada: repita la prueba openssl para saberlo.

Probar antes de rodear

Conserve la salida de los dos comandos openssl s_client (con y sin el grupo híbrido), con fecha, en su ticket o en el mensaje al operador. Basta para mostrar que el servidor responde en clásico y no en híbrido, y evita instalar un parche sobre un diagnóstico erróneo.

Resolución de problemas: los mensajes que encontrará

Un mismo fallo se muestra de forma distinta según la herramienta. Estas son las formas más comunes y lo que dice cada una de la avería.

  • net/http: TLS handshake timeout — el cliente Go estableció TCP y luego no recibió respuesta a su ClientHello. Ejecute la prueba openssl con y sin el grupo híbrido.
  • curl: (28) SSL connection timeout — el mismo síntoma en curl: el handshake no termina en el plazo. Compare con --curves X25519:P-256.
  • timeout 10 openssl s_client ... sin salida, código de retorno 124 — el handshake no terminó en diez segundos. Es el resultado esperado con un grupo híbrido filtrado.
  • read: connection reset by peer — el otro extremo o un equipo corta activamente. Busque un RST justo después del ClientHello con tcpdump.
  • connect:errno=110 en la salida de openssl — es el propio TCP el que caduca, antes de cualquier ClientHello: cortafuegos o enrutamiento, no este fallo.

Conservar la prueba, no solo el parche

Un TLS handshake timeout que afecta a una sola herramienta parece un error del software. Comparar dos grupos con openssl devuelve la pregunta a su orden: ¿responde el servidor a un ClientHello clásico y a uno híbrido? Según la respuesta, la solución está en el servidor, en el equipo intermedio, en su acceso o, como último recurso, en una variable de entorno puesta en un proceso.

Lo que hoy es seguro: Go y OpenSSL anuncian el grupo híbrido por defecto y algunos equipos lo tratan mal. Lo que no: una corrección oficial en Ollama, ausente del hilo hasta ahora. Trate GODEBUG=tlsmlkem=0 como un parche con fecha y repita la prueba tras cada cambio del camino.

Para ir más lejos

  1. Montar un servidor Ollama en un VPS

    Instalación, modelos y exposición de la API: Cómo alojar Ollama en un VPS.

  2. Cerrar los accesos repetidos a este servidor

    Para bloquear los intentos que golpean el mismo servicio, vea Fail2Ban en VPS.

  3. Elegir el proxy inverso que termina el TLS

    Caddy, Traefik o Nginx Proxy Manager gestionan el TLS cada uno a su manera: la comparativa.

Compartir este artículoservorbit.com/ma-es/blog/tls-handshake-timeout-clienthello-poscuantico-diagnostico