SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Tailscale : corriger « relay server unavailable »

Votre tailnet ne répond plus et le client annonce un relais injoignable. Voici le diagnostic ordonné : status, netcheck, DNS, sortie 443, horloge et IPv6.

« Relay server unavailable » : la réponse courte

Quand Tailscale affiche « relay server unavailable », le client n'arrive plus à ouvrir une connexion vers un serveur relais DERP. Le tailnet n'est pas cassé et vos clés sont intactes. La cause se trouve sur la machine, devant elle ou sur le relais concerné : la sortie réseau, la résolution DNS, l'horloge ou une indisponibilité du serveur. Le diagnostic ci-dessous se déroule dans un ordre précis, et il s'arrête presque toujours avant la fin.

La documentation Tailscale publie cet avertissement sous l'identifiant no-derp-connection. Son titre est « Relay server unavailable » et son texte est « Tailscale could not connect to the <derp-server> relay server. Your internet connection might be down, or the server might be temporarily unavailable. » Un message voisin existe, no-derp-home, intitulé « No home relay server », avec le texte « Tailscale could not connect to any relay server. » La formulation a changé au fil des versions du client, donc notez la vôtre avec tailscale version et comparez avec la référence officielle des messages plutôt qu'avec une capture trouvée sur un forum.

Que sont les relais DERP

Tailscale opère un réseau de relais qu'il nomme DERP (Designated Encrypted Relay for Packets). Ces serveurs font deux choses. Ils aident deux machines à percer leur NAT (network address translation, la traduction d'adresses faite par votre box), et ils transportent le trafic WireGuard chiffré quand aucun chemin direct ni relais de pair n'est disponible. Le relais ne voit jamais votre trafic en clair : il transmet des paquets déjà chiffrés de bout en bout, ce qui est aussi la raison pour laquelle un relais hébergé par Tailscale ne détient pas les clés qui chiffrent vos données.

Un relais se joint en TCP sur le port 443, avec du TLS (transport layer security, le chiffrement du web). C'est volontaire : le 443 sort de presque tous les réseaux, y compris ceux qui bloquent l'UDP. Chaque nœud choisit ensuite une région de relais « maison » et s'y enregistre, pour que ses pairs sachent où le trouver. La région parisienne porte le code par, et la liste complète des régions et de leurs noms d'hôtes est publique, servie par https://login.tailscale.com/derpmap/default.

Pourquoi plus rien n'est joignable, pas même en direct

C'est le point qui surprend. Une session Tailscale ne commence pas en direct : elle commence par le relais, puis elle est promue en direct si les deux côtés y arrivent. L'absence de relais joignable gêne donc l'établissement de nouvelles connexions, mais cet avertissement ne prouve pas que les chemins directs existants sont coupés. L'état en ligne dans la console dépend de la connexion au plan de contrôle (controlplane.tailscale.com), distincte de celle aux relais : elle privilégie HTTP sur TCP 80 avec un transport chiffré, puis HTTPS sur TCP 443 en repli.

Tailscale échoue en fermant, pas en ouvrant. Il n'existe aucun repli en clair, donc le client préfère ne rien transporter plutôt que de transporter mal. C'est pour cela qu'un seul problème de sortie réseau vous coupe de tout votre parc d'un coup. Si vous voulez l'image d'ensemble avant de creuser, le rôle du plan de contrôle et celui du plan de données est expliqué à part.

Un détail aggrave souvent le tableau. Si MagicDNS et --accept-dns sont actifs et qu'aucun gestionnaire DNS n'est détecté, Tailscale réécrit votre /etc/resolv.conf pour utiliser 100.100.100.100, une adresse servie par tailscaled lui-même. Quand le démon va mal, la résolution des noms en .ts.net échoue aussi, donc votre ssh monvps s'arrête au DNS et pas au réseau. Le message d'erreur n'est alors pas celui que vous attendez, et savoir distinguer un refus de connexion d'un délai d'attente vous évite de chercher au mauvais endroit.

Étape 1 : lire tailscale status avant tout

tailscale status
tailscale version

Ne lisez pas d'abord la liste des pairs. Lisez le bloc de santé que tailscale status ajoute, sur les lignes commençant par #. C'est là que le client écrit ses avertissements, dont celui qui nous occupe. Pour un pair actif, l'état indique direct, relay suivi du code de la région utilisée, ou peer-relay pour un relais de pair. Un chemin direct déjà établi reste distinct de la connexion aux relais.

Si la commande ne répond pas du tout et se plaint de ne pas joindre le démon local, vérifiez d'abord si tailscaled tourne.

systemctl status tailscaled
sudo journalctl -u tailscaled -n 100 --no-pager

Le journal du démon est la source la plus utile de toute cette page. Cherchez-y les erreurs de certificat, les échecs de résolution et les délais d'attente vers les relais. L'avertissement de santé DERP donne un nom de région ou un identifiant, sans garantir le nom d'hôte exact ni l'erreur sous-jacente. Si le service ne démarre pas du tout, ou s'il a disparu après une mise à jour du système, le sujet est ailleurs et les erreurs d'installation du paquet Tailscale sur Ubuntu couvrent ce cas.

Étape 2 : tailscale netcheck et les champs à regarder

tailscale netcheck

Cette commande sonde vos conditions réseau réelles. Voici ce que veulent dire les champs utiles ici. Les valeurs, elles, dépendent de votre ligne : lisez les vôtres, ne cherchez pas à les comparer à des chiffres recopiés.

  • UDP indique si la machine arrive à envoyer des paquets UDP sortants. Une réponse négative indique l'échec des sondes STUN (session traversal utilities for NAT, ceux qui vous renvoient votre adresse publique) : les connexions directes sont alors peu probables, sans être catégoriquement exclues.
  • IPv4 et IPv6 donnent l'adresse et le port publics tels qu'ils sont vus de l'extérieur. Un champ IPv6 rempli ne garantit pas que le TCP 443 fonctionne en IPv6, ce que vérifie l'étape 6.
  • MappingVariesByDestIP dit si votre adresse et votre port publics vus changent selon la destination. Une réponse positive indique un mappage NAT dépendant de la destination, qui complique le chemin direct.
  • PortMapping liste les protocoles de mappage de ports que votre routeur propose, parmi UPnP, NAT-PMP et PCP.
  • La liste des latences par région de relais indique quelles sondes ont obtenu une réponse. Si aucune région ne répond, poursuivez les vérifications DNS et TCP 443 ci-dessous.

La distinction est importante. Des latences qui s'affichent pour plusieurs régions peuvent provenir de réponses STUN en UDP : elles ne prouvent pas qu'une connexion DERP en TCP/TLS fonctionne. Un chemin qui reste relayé alors que les relais répondent est une autre histoire, traitée dans pourquoi une connexion Tailscale reste relayée au lieu de passer en direct.

Étape 3 : est-ce simplement le DNS ?

Le client ne peut pas ouvrir de TLS vers un nom qu'il n'arrive pas à résoudre. Vérifiez les deux noms qui comptent, celui du plan de contrôle et celui d'un relais.

resolvectl query controlplane.tailscale.com
resolvectl query derp18b.tailscale.com
dig +short controlplane.tailscale.com @1.1.1.1

Le troisième appel contourne votre résolveur local et interroge un résolveur public. S'il réussit alors que la requête locale du même nom échoue, vérifiez la configuration DNS locale. Une boucle est possible si /etc/resolv.conf pointe encore vers 100.100.100.100, l'adresse servie par tailscaled, alors que le démon est arrêté ou en mauvaise santé. Le client a besoin du DNS pour joindre le plan de contrôle, et le DNS attend le client.

cat /etc/resolv.conf
resolvectl status

Pour sortir de cette boucle, remettez un résolveur public dans la configuration du système le temps de relancer le tunnel, ou coupez la reprise du DNS avec sudo tailscale set --accept-dns=false, puis réactivez-la une fois le nœud revenu. Le mécanisme est celui décrit dans la réparation du DNS qui casse au montage d'un tunnel WireGuard ; Tailscale essaie toutefois de coopérer avec les gestionnaires DNS avant de réécrire /etc/resolv.conf.

Étape 4 : la sortie réseau, TCP 443 pour les relais et UDP pour le direct

Un client Tailscale utilise ces destinations. TCP vers *:443 pour le plan de contrôle et les relais. TCP vers *:80 pour le transport chiffré privilégié du plan de contrôle et la détection de portail captif ; le plan de contrôle utilise HTTPS sur 443 en repli si le port 80 ne répond pas. UDP depuis le port 41641 par défaut vers n'importe quelle destination, pour les tunnels WireGuard directs. UDP vers *:3478 pour le STUN. Les noms à autoriser sont controlplane.tailscale.com, login.tailscale.com, console.tailscale.com, log.tailscale.com et les noms de relais en derp*.tailscale.com. Tailscale demande d'autoriser des noms et des plages larges plutôt que des adresses IP figées, parce que ces adresses changent.

Notez la séparation, elle vous fait gagner du temps. Les relais n'ont besoin que du TCP 443. Si le blocage ne portait que sur l'UDP, vous auriez un tunnel lent mais vivant. Un message de relais injoignable signale l'échec vers un serveur précis : il ne prouve pas un blocage du TCP 443.

curl -sS -I --max-time 10 https://controlplane.tailscale.com
nc -vz derp18b.tailscale.com 443

Sur le premier appel, le code HTTP renvoyé n'a aucune importance. Ce qui compte est d'obtenir une réponse TLS plutôt qu'un délai d'attente. Un délai d'attente sur les deux commandes justifie de vérifier le filtrage en sortie et la connectivité, sans prouver à lui seul la présence d'un filtre. Cherchez-le sur la machine elle-même, dans le pare-feu réseau de votre hébergeur, qui est un réglage séparé sur la plupart des panneaux, puis sur la box ou le proxy placé devant. Si vous avez récemment durci la machine, une politique de sortie fermée est le premier suspect, et les règles de base d'ufw sur un VPS rappellent qu'un deny outgoing casse Tailscale sans écrire le moindre message côté pare-feu. Pour tester un port sans nc, plusieurs méthodes pour vérifier qu'un port est ouvert sous Linux donnent des équivalents disponibles partout.

Étape 5 : l'horloge d'un VPS sans écran

Les relais sont joints en TLS, comme le plan de contrôle lorsqu'il utilise HTTPS, et la validation d'un certificat compare ses dates de validité à l'horloge locale. Un décalage fait échouer cette validation si l'heure locale tombe avant le début ou après la fin de validité d'un certificat de la chaîne. Le journal de tailscaled montre alors une erreur x509 disant que le certificat a expiré ou n'est pas encore valide, ce qui ressemble à une panne de Tailscale sans en être une.

Ce cas arrive surtout après une restauration de snapshot, après une longue suspension de la machine, ou quand le service NTP (network time protocol, la synchronisation de l'heure) n'a jamais démarré sur une image minimale.

timedatectl status
sudo timedatectl set-ntp true
sudo systemctl restart tailscaled

timedatectl status doit annoncer une horloge synchronisée. L'absence de synchronisation ne prouve toutefois pas que l'heure est fausse : vérifiez l'heure affichée avant d'attribuer l'échec à un certificat.

Étape 6 : l'IPv6 à moitié configurée

Voici le cas le plus difficile à voir. La machine a une adresse IPv6 globale, le résolveur renvoie bien des enregistrements AAAA, mais la route IPv6 de l'hébergeur ou du fournisseur d'accès ne fonctionne pas. Le client DERP met IPv4 et IPv6 en concurrence : lorsqu'il préfère IPv6, il retarde IPv4 de seulement 200 millisecondes. Une IPv6 défaillante ne suffit donc pas à expliquer une connexion suspendue si IPv4 fonctionne.

curl -4 -sS -I --max-time 10 https://derp18b.tailscale.com
curl -6 -sS -I --max-time 10 https://derp18b.tailscale.com

Si l'appel en -4 répond et que l'appel en -6 expire, le chemin IPv6 vers ce relais échoue pendant ce test. Réparez la route, ou retirez l'adresse IPv6 que l'hébergeur vous a attribuée sans route utilisable. Ne coupez pas l'IPv6 par réflexe sur tout votre parc : là où elle fonctionne, elle donne souvent le meilleur chemin direct.

Freebox, Livebox, box 4G et réseaux d'hôtel

La plupart des conseils que vous trouverez en français parlent d'ouvrir un port sur la box. Pour ce problème précis, c'est hors sujet, et il faut le dire clairement. Un relais se joint en sortie sur le 443 : aucune redirection de port n'est nécessaire, mais le pare-feu d'une box peut filtrer cette sortie. Le NAT de votre Freebox ou de votre Livebox gêne le chemin direct, pas le chemin relayé.

Vérifiez donc aussi les règles du pare-feu de la box. Un contrôle parental ou un filtrage DNS activé sur la box peut refuser de résoudre les noms de Tailscale, et vous obtenez alors le symptôme de l'étape 3. Un profil horaire de contrôle parental peut couper l'accès d'un appareil entier à heure fixe, ce qui donne un tailnet vivant le matin et muet le soir. Un serveur DNS personnalisé saisi dans l'interface de la box, oublié là après un changement d'opérateur, produit le même effet.

Sur une box 4G ou 5G, la connexion peut passer par du CGNAT (carrier grade NAT, le partage d'une même adresse publique entre plusieurs abonnés). Le CGNAT complique les connexions entrantes, mais Tailscale sait établir des chemins directs à travers certains CGNAT. Il n'empêche pas de sortir en 443, donc il ne produit pas ce message. Un tailnet en CGNAT n'est donc pas forcément relayé.

Le vrai réseau hostile est celui d'une entreprise ou d'un hôtel. Deux cas s'y présentent. Le portail captif, où rien ne sort avant que vous n'ayez accepté les conditions dans un navigateur : authentifiez-vous, puis vérifiez si l'avertissement disparaît. Puis le proxy à inspection TLS, qui présente son propre certificat à la place de celui du relais. Si le client ne reconnaît pas l'autorité de certification du proxy, la validation échoue et la connexion est refusée. Demandez à l'exploitant du réseau de vérifier cette interception et d'exempter les noms de domaine listés à l'étape 4 si elle bloque Tailscale.

Redémarrer le client proprement

Quand la cause est corrigée, relancez la pile dans cet ordre.

sudo tailscale down --accept-risk=lose-ssh
sudo systemctl restart tailscaled
sudo tailscale up
tailscale status

Attention avec tailscale down si votre seul accès à la machine passe par Tailscale SSH : vous perdez la session tout de suite. Gardez une console de secours ouverte chez votre hébergeur avant de lancer cette commande. Si rien n'a bougé, tailscale bugreport produit un identifiant de diagnostic à joindre à une demande au support, et https://status.tailscale.com vous dit si une région de relais est réellement en incident. Si un serveur est indisponible, le client en essaie un autre dans la région ; si la région est indisponible, il sélectionne la région suivante.

Où cette page s'arrête

Cette page traite un client qui ne joint pas un relais ou qui n'en joint aucun. Elle ne traite pas un client qui les joint et qui reste lent. Si une connexion DERP fonctionne et que vos pairs restent en relay, le sujet devient l'analyse du chemin, couverte par le diagnostic d'une liaison Tailscale qui reste relayée. Si vous administrez votre propre plan de contrôle, son nom d'hôte change, mais Headscale conserve les relais publics de Tailscale tant que leur carte n'est pas désactivée dans sa configuration ; un plan de contrôle Headscale auto-hébergé impose donc de vérifier les destinations réellement configurées.

FAQ

Pourquoi mon nœud est-il hors ligne alors que le VPS répond au ping ?

Parce que l'état « en ligne » dans la console d'administration décrit la connexion du nœud au plan de contrôle de Tailscale, pas sa joignabilité en ICMP. Le VPS répond au ping sur son adresse publique pendant que tailscaled n'arrive pas à joindre controlplane.tailscale.com, sur TCP 80 avec un transport chiffré ou sur TCP 443 en HTTPS. Lisez le bloc de santé de tailscale status, puis journalctl -u tailscaled : cherchez un délai d'attente, un échec de résolution ou une erreur x509, sans attendre de l'avertissement DERP le détail exact de la cause.

« Relay server unavailable » signifie-t-il que Tailscale est en panne ?

Le message décrit l'échec de votre client à joindre un relais précis ; il peut aussi signaler une indisponibilité temporaire de ce serveur. Vérifiez d'abord votre sortie réseau, votre DNS et votre horloge, puis consultez https://status.tailscale.com si ces trois points sont sains. En cas d'incident réel sur une région, le client tente la région suivante de lui-même, donc une panne régionale isolée ne coupe pas un tailnet entier.

Faut-il ouvrir un port sur ma Freebox pour que les relais fonctionnent ?

Non. Les relais se joignent en connexion sortante sur le port 443 en TCP ; vérifiez que le pare-feu de la box autorise cette sortie. Ouvrir l'UDP 41641 en entrée aide le chemin direct, ce qui améliore la latence et le débit, mais cela ne change rien à un client qui ne joint aucun relais. Si le blocage vient bien de la box, regardez son pare-feu, son contrôle parental et son filtrage DNS, pas ses redirections de port.

Une horloge décalée peut-elle vraiment casser Tailscale ?

Oui, et c'est une cause classique sur un VPS restauré depuis un snapshot. Les connexions TLS aux relais et au plan de contrôle vérifient les dates des certificats par rapport à l'heure locale. Le décalage provoque un échec si cette heure tombe hors de l'intervalle de validité d'un certificat de la chaîne ; quelques minutes ne suffisent pas à elles seules. Le journal du démon affiche alors une erreur x509 signalant un certificat expiré ou pas encore valide. Vérifiez l'heure affichée par timedatectl status et son état de synchronisation.

Cet article vous a-t-il été utile ?