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.
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 :
. /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 :
sudo tailscale upDonnez ensuite un nom clair à chaque serveur, ici web-1 sur le premier et db-1 sur le second :
sudo tailscale set --hostname=web-1Relevez son adresse Tailscale et affichez les machines du tailnet :
tailscale ip -4
tailscale statusÉtape 3 : vérifier la liaison
Depuis web-1, testez db-1 :
tailscale ping db-1
ping -c 3 db-1La 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 :
"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 :
{
"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 :
sudo apt-get install -y netcat-openbsd
nc -vz -w 3 db-1 5432
nc -vz -w 3 db-1 22Le 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 :
ssh VOTRE_USER@web-1Dans cette session, autorisez l’interface Tailscale et appliquez les politiques par défaut :
sudo ufw allow in on tailscale0
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw enable
sudo ufw status numberedConfirmez 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 :
sudo ufw delete allow 22/tcp
sudo ufw status verboseSi 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 :
ssh VOTRE_USER@web-1Depuis une machine hors du tailnet, ou après avoir arrêté Tailscale sur votre poste, la connexion à l’adresse publique doit expirer :
ssh -o ConnectTimeout=5 VOTRE_USER@VOTRE_IP_SERVEUROption : 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é :
"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.
sudo tailscale set --sshPour 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 :
sudo tailscale up --auth-key=TAILSCALE_AUTH_KEYTraitez 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 :
sudo apt-get update
sudo apt-get install --only-upgrade -y tailscale
tailscale versionVous pouvez aussi activer les mises à jour automatiques :
sudo tailscale set --auto-updateLe 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é :
sudo systemctl enable --now tailscaled
sudo journalctl -u tailscaled --no-pager -n 50Si 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 :
tailscale netcheck
sudo ufw allow 41641/udpLe ping fonctionne, mais pas le service
- Vérifiez qu’une règle
grantsautorise 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.
sudo tailscale set --accept-dns=falseVous 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 :
sudo ufw allow 22/tcp
sudo tailscale status
sudo tailscale up