FR

Applications

Relier ses serveurs avec Tailscale

Installer Tailscale sur Debian ou Ubuntu, relier plusieurs serveurs dans un réseau privé, écrire des règles d'accès et réserver SSH à ce réseau avec UFW.

9 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ce guide vous explique comment relier vos serveurs et votre poste de travail avec Tailscale. Chaque machine reçoit une adresse privée en 100.x.y.z et communique avec les autres dans un tunnel WireGuard chiffré, sans que vous ayez à gérer les clés ni à ouvrir de port pour chaque liaison.

À la fin du guide, vos serveurs dialoguent sur ce réseau privé, appelé tailnet, seuls les accès que vous avez définis sont autorisés, et SSH n’est plus joignable depuis l’adresse publique.

Commander un serveur

Ce guide s’applique aux serveurs que vous administrez vous-même :

Prérequis

  • Un ou plusieurs serveurs sous Debian 12 ou 13, ou Ubuntu 22.04 ou 24.04
  • Un accès SSH avec un utilisateur disposant de sudo
  • Un compte Tailscale
  • Tailscale installé sur votre poste de travail, depuis la page de téléchargement
  • Un accès de secours au serveur, comme la console VNC de votre VPS ou le mode rescue

Le guide nomme les serveurs web-1 et db-1.

Ports utilisés

Tailscale ne demande en général aucun port entrant : les machines ouvrent des connexions sortantes.

Port Sens Rôle
443/tcp Sortant Service de coordination et relais DERP
41641/udp (source) Sortant Tunnels WireGuard directs
3478/udp Sortant STUN, pour découvrir l’adresse publique
41641/udp Entrant, facultatif Favorise les connexions directes

Étape 1 : installer Tailscale

Sur chaque serveur, ajoutez le dépôt officiel correspondant à votre système, puis installez le paquet :

Terminal
. /etc/os-release
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL "https://pkgs.tailscale.com/stable/${ID}/${VERSION_CODENAME}.noarmor.gpg" | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
curl -fsSL "https://pkgs.tailscale.com/stable/${ID}/${VERSION_CODENAME}.tailscale-keyring.list" | sudo tee /etc/apt/sources.list.d/tailscale.list
sudo apt-get update
sudo apt-get install -y tailscale
tailscale version

Étape 2 : connecter les serveurs

Lancez la connexion, puis ouvrez dans votre navigateur l’URL affichée pour autoriser la machine :

Terminal
sudo tailscale up

Donnez ensuite un nom clair à chaque serveur, ici web-1 sur le premier et db-1 sur le second :

Terminal
sudo tailscale set --hostname=web-1

Relevez son adresse Tailscale et affichez les machines du tailnet :

Terminal
tailscale ip -4
tailscale status

Étape 3 : vérifier la liaison

Depuis web-1, testez db-1 :

Terminal
tailscale ping db-1
ping -c 3 db-1

La réponse de tailscale ping indique le chemin utilisé. via DERP(...) signale un passage par un relais, alors qu’une adresse IP:port indique une connexion directe. Les noms courts reposent sur MagicDNS, activé par défaut sur les tailnets récents. Si db-1 n’est pas résolu, utilisez son adresse 100.x.y.z.

Étape 4 : éviter l’expiration des serveurs

La clé d’une machine expire par défaut au bout de 180 jours. Un serveur dont la clé expire sort du tailnet, ce qui est bloquant si SSH n’est plus accessible autrement.

Dans la page Machines, ouvrez le menu à droite de chaque serveur, puis choisissez Disable Key Expiry.

Étape 5 : étiqueter les serveurs

Les tags donnent aux serveurs une identité indépendante de votre compte. Ils permettent d’écrire des règles lisibles.

Ouvrez la page Access controls. Ajoutez ces deux sections au fichier existant, ou complétez-les si elles y figurent déjà, sans retirer le reste. Remplacez TAILSCALE_EMAIL par l’adresse exacte de votre compte, puis enregistrez :

JSON
"groups": {
  "group:admins": ["TAILSCALE_EMAIL"]
},
"tagOwners": {
  "tag:server": ["group:admins"]
},

Retournez dans Machines. Dans le menu de chaque serveur, choisissez Edit tags, ajoutez tag:server, puis enregistrez.

Étape 6 : limiter les accès

Par défaut, toutes les machines du tailnet peuvent se joindre. Remplacez le contenu du fichier de politique par celui-ci pour n’autoriser que le nécessaire :

JSON
{
  "groups": {
    "group:admins": ["TAILSCALE_EMAIL"]
  },
  "tagOwners": {
    "tag:server": ["group:admins"]
  },
  "acls": [],
  "grants": [
    {
      "src": ["group:admins"],
      "dst": ["tag:server"],
      "ip": ["tcp:22", "icmp:*"]
    },
    {
      "src": ["tag:server"],
      "dst": ["tag:server"],
      "ip": ["tcp:5432", "icmp:*"]
    }
  ],
  "tests": [
    {
      "src": "group:admins",
      "proto": "tcp",
      "accept": ["tag:server:22"]
    },
    {
      "src": "tag:server",
      "proto": "tcp",
      "accept": ["tag:server:5432"],
      "deny": ["tag:server:22"]
    }
  ]
}
Section Rôle
groups Regroupe les comptes autorisés
tagOwners Indique qui peut attribuer chaque tag
acls Forme historique des règles. Vide ici, elle évite de retomber sur la politique par défaut qui autorise tout
grants Forme recommandée des règles d’accès. Tout ce qui n’y figure pas est refusé
tests Contrôles exécutés à chaque enregistrement. Le fichier est refusé si l’un d’eux échoue

Avec cet exemple, vos appareils joignent les serveurs en SSH et les serveurs communiquent entre eux sur le port 5432, celui de PostgreSQL. Remplacez ce port par ceux de vos services. Pour plusieurs ports, écrivez par exemple "ip": ["tcp:5432", "tcp:6379"].

Contrôlez ensuite le résultat depuis web-1. La commande sur le port 22 doit échouer :

Terminal
sudo apt-get install -y netcat-openbsd
nc -vz -w 3 db-1 5432
nc -vz -w 3 db-1 22

Le test du port 5432 réussit seulement si un service y écoute sur une adresse accessible par Tailscale. Depuis votre poste, ssh VOTRE_USER@web-1 doit fonctionner.

Étape 7 : réserver SSH au réseau privé

Depuis votre poste, ouvrez d’abord une session par Tailscale :

Terminal
ssh VOTRE_USER@web-1

Dans cette session, autorisez l’interface Tailscale et appliquez les politiques par défaut :

Terminal
sudo ufw allow in on tailscale0
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw enable
sudo ufw status numbered

Confirmez l’activation d’UFW en répondant y. Le filtrage entre machines du tailnet est assuré par les règles de l’étape 6. Si le serveur publie un site, conservez ou ajoutez les règles 80/tcp et 443/tcp.

Retirez ensuite la règle SSH publique, si elle existe :

Terminal
sudo ufw delete allow 22/tcp
sudo ufw status verbose

Si votre règle porte un autre nom, comme OpenSSH, utilisez sudo ufw delete allow OpenSSH.

Vérifier le résultat

Ouvrez une nouvelle session par Tailscale. Elle doit aboutir :

Terminal
ssh VOTRE_USER@web-1

Depuis une machine hors du tailnet, ou après avoir arrêté Tailscale sur votre poste, la connexion à l’adresse publique doit expirer :

Terminal
ssh -o ConnectTimeout=5 VOTRE_USER@VOTRE_IP_SERVEUR

Option : utiliser Tailscale SSH

Avec Tailscale SSH, l’authentification repose sur votre identité Tailscale plutôt que sur des clés SSH. OpenSSH et ses fichiers ne sont pas modifiés, mais Tailscale prend en charge le port 22 sur l’adresse Tailscale.

Ajoutez cette section au fichier de politique, en indiquant le compte Linux autorisé :

JSON
"ssh": [
  {
    "action": "accept",
    "src": ["group:admins"],
    "dst": ["tag:server"],
    "users": ["VOTRE_USER"]
  }
],

La règle tcp:22 de l’étape 6 reste nécessaire. Activez ensuite la fonction sur le serveur. Les sessions SSH déjà ouvertes sur l’adresse Tailscale vont se figer : reconnectez-vous ensuite.

Terminal
sudo tailscale set --ssh

Pour revenir en arrière, utilisez sudo tailscale set --ssh=false.

Ajouter un serveur sans navigateur

Une clé d’authentification évite l’ouverture de l’URL. Créez-la sur la page Keys de la console, de préférence à usage unique et avec le tag tag:server, puis utilisez-la sur le nouveau serveur :

Terminal
sudo tailscale up --auth-key=TAILSCALE_AUTH_KEY

Traitez cette clé comme un mot de passe et ne la laissez ni dans un script ni dans l’historique du shell. Sa durée de validité est de 90 jours au maximum.

Mettre à jour

Mettez à jour le paquet avec APT :

Terminal
sudo apt-get update
sudo apt-get install --only-upgrade -y tailscale
tailscale version

Vous pouvez aussi activer les mises à jour automatiques :

Terminal
sudo tailscale set --auto-update

Le redémarrage de Tailscale interrompt les sessions Tailscale SSH et peut perturber les sessions passant par le tailnet. Lancez la mise à jour dans tmux ou screen si Tailscale est votre seul accès.

Sauvegarder

Le serveur conserve son identité dans /var/lib/tailscale/tailscaled.state. Ce fichier contient des clés : il n’a pas besoin d’être sauvegardé, car il suffit de reconnecter la machine avec sudo tailscale up après une réinstallation. Ne le copiez pas sur une autre machine.

L’élément à conserver est votre fichier de politique. Gardez-en une copie à jour dans un dépôt privé ou un coffre de documents.

En cas de problème

Failed to connect to local Tailscale daemon

Le service n’est pas démarré :

Terminal
sudo systemctl enable --now tailscaled
sudo journalctl -u tailscaled --no-pager -n 50

Si les journaux mentionnent /dev/net/tun, le système n’a pas accès au périphérique TUN. Ce cas concerne surtout les systèmes exécutés dans un conteneur.

Logged out. ou Tailscale is stopped.

La machine est déconnectée ou sa clé a expiré. Relancez sudo tailscale up, puis désactivez l’expiration comme indiqué à l’étape 4.

changing settings via 'tailscale up' requires mentioning all non-default flags

tailscale up attend tous les paramètres déjà personnalisés. Pour modifier un seul réglage, utilisez tailscale set, par exemple sudo tailscale set --hostname=web-1.

La connexion passe par un relais

Dans tailscale status, la mention relay indique que le trafic ne passe pas directement. Le service reste utilisable, avec des performances parfois moindres. Analysez le réseau, puis ouvrez le port facultatif si nécessaire :

Terminal
tailscale netcheck
sudo ufw allow 41641/udp

Le ping fonctionne, mais pas le service

  • Vérifiez qu’une règle grants autorise ce port entre ces machines.
  • Vérifiez que le service n’écoute pas seulement sur 127.0.0.1 : sudo ss -ltnp.
  • Vérifiez le tag de la machine dans la console.

Le fichier de politique est refusé

Lisez le message affiché par la console. Il signale une erreur de syntaxe, ou un test de la section tests qui ne correspond pas aux règles. Un tag doit aussi être déclaré dans tagOwners avant d’être utilisé.

Les noms DNS du serveur ne se résolvent plus

Tailscale peut gérer le DNS de la machine. Si cela gêne votre configuration, désactivez cette prise en charge. Les noms courts ne fonctionneront plus sur ce serveur : utilisez alors les adresses 100.x.y.z.

Terminal
sudo tailscale set --accept-dns=false

Vous n’avez plus accès en SSH

Connectez-vous par votre accès de secours, puis rétablissez temporairement la règle publique. Corrigez Tailscale, puis retirez cette règle :

Terminal
sudo ufw allow 22/tcp
sudo tailscale status
sudo tailscale up

Références