Le symptôme : curl répond, l'outil expire
Le scénario type tient en trois lignes. Un téléchargement lancé par un outil écrit en Go s'arrête sur Error: pull model manifest: Get "https://registry.ollama.ai/...": net/http: TLS handshake timeout. Le même hôte, interrogé avec un curl d'ancienne génération, répond en une fraction de seconde. Et rien ne change en relançant, trois essais sur trois échouent de la même façon.
Ce motif est celui du fil ollama/ollama#19430, ouvert le 31 octobre 2026. Le point à retenir est l'asymétrie : la connexion TCP s'établit, puis la poignée de main TLS ne se termine jamais. Ce n'est ni un DNS cassé, ni un port fermé, ni un certificat expiré, qui produiraient des messages différents. Quand le TCP passe et que seul le premier message TLS reste sans réponse, on cherche du côté de la taille et de la forme de ce message, le ClientHello.
Pourquoi un ClientHello plus gros peut tout bloquer
Le ClientHello est le premier message d'une connexion TLS : le client y liste ses algorithmes et envoie ses parts d'échange de clés. Depuis Go 1.24, la bibliothèque standard active par défaut l'échange hybride post-quantique X25519MLKEM768 quand Config.CurvePreferences est nil. OpenSSL 3.5.0, publié le 8 avril 2025, fait de même : sa liste de groupes par défaut place X25519MLKEM768 en tête et envoie deux parts de clés, X25519MLKEM768 et X25519.
La part ML-KEM est volumineuse. Dans le fil #19430, le ClientHello post-quantique pèse 1573 octets, contre 512 pour la version classique : il ne tient plus dans un seul paquet. Or certains serveurs et équipements supposent que le ClientHello arrive en une seule lecture TCP. Le site tldr.fail décrit ce défaut : le serveur lit le premier fragment, juge la poignée de main invalide et coupe, alors qu'un serveur correct ignorerait l'option inconnue. Le défaut est antérieur au post-quantique, la taille ne fait que le révéler. La documentation Go le présente d'ailleurs comme la raison d'utiliser GODEBUG=tlsmlkem=0.
Symptôme, cause probable et test qui tranche
Faites défiler le tableau
| Symptôme | Cause probable | Test qui tranche |
|---|---|---|
| Seul le groupe hybride expire avec `openssl s_client` | ClientHello post-quantique filtré ou mal lu | `-groups X25519MLKEM768` puis `-groups X25519` |
| curl passe avec `--curves X25519:P-256`, le client Go expire | Le client Go annonce le groupe hybride par défaut | `GODEBUG=tlsmlkem=0` sur ce seul processus |
| Tout expire, même en X25519 seul | Pare-feu ou routage : la taille n'est pas en cause | `curl -v` vers un autre hôte et un autre port |
| Les petites requêtes passent, les gros échanges se figent | MTU ou MSS, trou noir ICMP | `ping -M do -s 1472` puis `tcp_mtu_probing` |
| Un seul hôte échoue, depuis tous vos réseaux | Serveur qui lit mal un ClientHello fragmenté | Même test depuis un second réseau |
| Échec sur un réseau, succès sur un autre | Filtrage de l'accès : FAI, entreprise, boîtier | Second chemin : VPS ou partage de connexion |
| Coupure immédiate (reset) après le ClientHello | Équipement qui coupe sur un message inattendu | `tcpdump` : un RST juste après le ClientHello |
Diagnostiquer en dix minutes
Reproduire avec curl
Mesurez le temps et le code de réponse :
curl -sS -o /dev/null -w '%{http_code} %{time_total}\n' https://mondomaine.com/. Si curl répond vite et que votre outil expire, le serveur est joignable et le défaut est ailleurs.Forcer un ClientHello classique
Relancez avec
curl --curves X25519:P-256 -sS -o /dev/null -w '%{http_code} %{time_total}\n' https://mondomaine.com/. Dans le fil #19430, ce ClientHello de 512 octets obtient une réponse en 0,32 s. Selon la bibliothèque TLS de votre curl, l'option peut être refusée : lisez alors le message avant de conclure.Comparer les deux groupes avec openssl
Il faut OpenSSL 3.5 ou plus pour le premier test. Lancez
timeout 10 openssl s_client -connect mondomaine.com:443 -servername mondomaine.com -tls1_3 -groups X25519MLKEM768 </dev/null, puis la même commande avec-groups X25519.Lire le verdict
Si le groupe X25519 seul aboutit et que le groupe hybride reste sans réponse jusqu'au délai, le ClientHello post-quantique est trop gros ou filtré. Dans le fil, l'hybride expire après 8 secondes. Si les deux échouent, ce n'est pas ce défaut.
Écarter la MTU
Testez
ping -M do -s 1472 mondomaine.com: le paquet de 1500 octets sans fragmentation doit passer. Lisez aussisysctl net.ipv4.tcp_mtu_probing: 0 désactive la détection, 1 l'active quand un trou noir ICMP est détecté, 2 la maintient toujours active.Capturer le dialogue, facultatif
Avec
sudo tcpdump -ni any host IP_DE_L_HOTE and tcp port 443, regardez ce qui suit le ClientHello : des retransmissions sans réponse signalent un paquet éliminé, un RST signale une coupure active.Changer de chemin réseau
Refaites les deux commandes openssl depuis une autre connexion : partage de connexion mobile, ou un VPS. Même résultat partout, le défaut est chez l'hôte distant. Résultat différent, il est sur votre accès.
Qui bloque : serveur distant, boîtier ou chemin d'accès
Le test depuis un second réseau désigne le coupable. Si l'hôte échoue de partout, c'est un serveur ou un équipement placé devant lui : un reverse proxy ancien, un pare-feu applicatif, un répartiteur de charge qui lit mal un ClientHello fragmenté. Vous ne pouvez rien y corriger, mais vous pouvez prévenir l'exploitant en joignant les deux commandes openssl et leur résultat, ce qui évite l'aller-retour habituel.
Si l'hôte répond depuis un réseau et pas depuis l'autre, le défaut est sur votre chemin d'accès : boîtier d'inspection TLS d'entreprise, pare-feu qui ne reconnaît pas le code du groupe hybride, ou filtrage d'un fournisseur d'accès. C'est le cas décrit dans le fil #19430, où le rapporteur est sur un FAI qui élimine silencieusement ces ClientHello. Dans ce fil, le blocage suit l'adresse IP de destination, pas le nom SNI, et le test de MTU passe : la piste MTU a été écartée.
Corriger, ou à défaut contourner
Corriger le chemin quand il vous appartient
Mettez à jour le reverse proxy, le pare-feu ou le boîtier d'inspection qui rejette le ClientHello. C'est le seul correctif qui conserve le post-quantique.
Traiter la MTU si le test l'a montrée
Si
ping -M do -s 1472échoue, activez la détection avecsudo sysctl -w net.ipv4.tcp_mtu_probing=1, puis persistez la valeur dans un fichier de/etc/sysctl.d/. C'est une piste distincte, à tester après le groupe hybride.Désactiver le post-quantique pour un client Go
Lancez la commande avec
GODEBUG=tlsmlkem=0, par exempleGODEBUG=tlsmlkem=0 ./mon-outil. Le client n'annonce plus que des groupes classiques, et le ClientHello retombe à une taille ordinaire.Le poser dans un service systemd
Créez un drop-in avec
sudo systemctl edit mon-service, ajoutez sous[Service]la ligneEnvironment="GODEBUG=tlsmlkem=0", puissudo systemctl restart mon-service.Le poser dans un conteneur
Avec Docker, ajoutez
-e GODEBUG=tlsmlkem=0àdocker run. Avec Compose, ajoutez- GODEBUG=tlsmlkem=0sousenvironment:du service concerné, puisdocker compose up -d.Retirer le palliatif dès que le chemin est réparé
Notez dans votre dépôt de configuration pourquoi la variable est là. Quand le boîtier ou le serveur est corrigé, supprimez-la et refaites le test openssl pour vérifier que le groupe hybride passe.
Ollama sur un VPS : le cas du fil #19430
Le fil rapporte ce comportement avec Ollama 0.40.13, dans l'image officielle ollama/ollama:latest sous Docker, sur une connexion d'un fournisseur d'accès sans VPN ni proxy. L'erreur est celle citée plus haut, sur registry.ollama.ai. Le rapporteur a mesuré 1573 octets pour le ClientHello post-quantique, qui expire, et 512 pour le classique, qui reçoit une réponse 404 en 0,32 s. Avec GODEBUG=tlsmlkem=0 sur le processus qui télécharge, trois essais sur trois réussissent, contre trois échecs sur trois sans.
À la date de rédaction, ce fil est ouvert et ne mentionne aucun correctif officiel : le contournement est celui du rapporteur, présenté comme temporaire. Pour un Ollama sur VPS, la conséquence est pratique. Si ollama pull expire alors que curl atteint le registre, appliquez le diagnostic ci-dessus depuis le VPS, puis posez la variable sur le conteneur ollama, avec docker run -e GODEBUG=tlsmlkem=0 ... ou sous environment: dans Compose, et relancez docker exec ollama ollama pull le-modèle. Un VPS offre aussi un chemin réseau différent du vôtre : s'il tire le modèle sans variable, le filtrage est sur votre accès.
Ce que coûte le palliatif GODEBUG=tlsmlkem=0
- Plus de post-quantique — le processus n'annonce plus X25519MLKEM768 : ses connexions ne profitent plus de la protection contre la capture de trafic pour un déchiffrement futur.
- Un périmètre large — la variable vaut pour tout le processus, donc pour tous ses appels sortants, pas seulement pour l'hôte qui pose problème.
- Un réglage temporaire — c'est un palliatif, pas un correctif : il masque un défaut du chemin réseau qui reste en place.
- Une dette à documenter — sans commentaire dans la configuration, la variable survit des années et personne ne sait pourquoi.
- Aucune garantie universelle — si le filtrage ne vient pas du ClientHello, la variable ne change rien : refaites le test openssl pour le savoir.
Prouver avant de contourner
Gardez la sortie des deux commandes openssl s_client (avec et sans le groupe hybride), datée, dans votre ticket ou dans le message à l'exploitant. Elle suffit à montrer que l'hôte répond en classique et pas en hybride, et elle évite d'installer un palliatif sur un faux diagnostic.
Dépannage : les messages que vous allez rencontrer
Un même défaut s'affiche différemment selon l'outil. Voici les formes les plus courantes, et ce que chacune dit de la panne.
net/http: TLS handshake timeout— le client Go a établi le TCP puis n'a reçu aucune réponse au ClientHello. Lancez le test openssl avec et sans le groupe hybride.curl: (28) SSL connection timeout— même symptôme côté curl : la poignée de main n'aboutit pas dans le délai. Comparez avec--curves X25519:P-256.timeout 10 openssl s_client ...sans sortie, code de retour 124 — la poignée de main n'a pas abouti en dix secondes. C'est le résultat attendu pour le groupe hybride filtré.read: connection reset by peer— l'autre bout ou un équipement coupe activement. Cherchez un RST juste après le ClientHello avectcpdump.connect:errno=110dans la sortie d'openssl — c'est le TCP lui-même qui expire, avant tout ClientHello : pare-feu ou routage, pas ce défaut.
Garder la preuve, pas seulement le contournement
Un TLS handshake timeout qui touche un seul outil donne l'impression d'un bug du logiciel. La comparaison de deux groupes avec openssl remet la question dans le bon ordre : l'hôte répond-il à un ClientHello classique, et à un ClientHello hybride ? Selon la réponse, le correctif se trouve sur le serveur, sur le boîtier, sur votre accès ou, en dernier recours, dans une variable d'environnement posée sur un processus.
Ce qui est sûr aujourd'hui : Go et OpenSSL annoncent le groupe hybride par défaut, et des équipements le traitent mal. Ce qui ne l'est pas : un correctif officiel côté Ollama, absent du fil à ce jour. Traitez donc GODEBUG=tlsmlkem=0 comme une rustine datée, et refaites le test à chaque mise à jour du chemin.
Pour aller plus loin
Monter un serveur Ollama sur un VPS
Installation, modèles et exposition de l'API : Comment héberger Ollama sur un VPS.
Fermer les accès répétés sur ce serveur
Pour bloquer les tentatives qui frappent le même service, voir Fail2Ban Enhanced sur VPS.
Choisir le reverse proxy qui termine le TLS
Caddy, Traefik ou Nginx Proxy Manager gèrent chacun le TLS à leur façon : le comparatif.
servorbit.com/ma-fr/blog/tls-handshake-timeout-clienthello-post-quantique-diagnostiquer