Headscale et Tailscale – Installation sur Linux Debian

Voici la procédure pour ajouter un système Debian sur Headscale (native ou via une machine virtuelle). Ce billet est aussi disponible en anglais.

En premier, il faut ajouter la clé de signature du package et le référentiel de Tailscale dans le système via un terminal ou ssh.

curl -fsSL https://pkgs.tailscale.com/stable/debian/bookworm.noarmor.gpg | tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
curl -fsSL https://pkgs.tailscale.com/stable/debian/bookworm.tailscale-keyring.list | tee /etc/apt/sources.list.d/tailscale.list

Puis installer Tailscale proprement dit :

apt-get update
apt-get install tailscale -y

Et initialiser la connexion de Tailscale à Headscale :

tailscale login --login-server https://hs.xxxx.xxx --accept-dns=false

Récupérer la valeur de mkey, puis ouvrir un terminal sur la machine de Headscale et exécuter cette commande :

docker exec headscale headscale nodes register --user NOM-UTILISATEUR --key mkey:xxxxxxxxxxxxxxxxxxxxxxxx 

Pour le faire via l’interface de HeadPlane, sur la page “Machines”, cliquez sur “Add Device”, ajoutez la chaîne de caractères mkey:xxx, choisissez l’utilisateur et cliquez sur “Register”.

Je vous invite à lire ou à retourner sur le billet Headscale et Tailscale.