Comment installer Headscale sur Saplo : un réseau privé avec des clients Tailscale

Ton ordinateur portable à la maison, ton serveur au bureau et ton ordinateur de test chez un collaborateur doivent fonctionner sur un seul réseau privé, même si chaque appareil utilise une connexion différente. Headscale te permet de gérer un tel réseau depuis ton propre serveur de coordination. Dans ce guide, nous allons te montrer comment installer Headscale sur Saplo, connecter les premiers appareils et vérifier la communication entre eux.

Qu'est-ce que Headscale

Headscale est une implémentation open source du serveur de coordination pour les clients Tailscale. Tu installes le client Tailscale sur tes appareils, mais tu le pointes vers ton propre serveur Headscale. Le projet est principalement destiné aux réseaux personnels et aux petites organisations. Le périmètre du projet est décrit dans la documentation officielle de Headscale.

C'est la solution idéale pour l'administrateur d'un laboratoire à domicile, un développeur travaillant sur plusieurs machines ou une petite équipe. Il est conseillé de commencer avec deux de tes propres appareils avant d'ajouter le matériel de tes collaborateurs et de définir les règles d'accès.

L'installation de Headscale ne donne pas automatiquement accès au réseau privé de la Box Saplo. Le serveur coordonne les appareils que tu y enregistres toi-même. Le simple fait d'exécuter l'application sur la Box ne fait pas de la Box un participant à ce réseau.

Exigences et hébergement Headscale sur Saplo

Le plan le moins cher qui réponde aux exigences d'installation est la Box S pour 27 € par an. La recette Headscale nécessite un minimum de 256 Mo de RAM et 2 Go de disque. Si d'autres applications sont exécutées sur la Box, vérifie également les autres ressources disponibles. Tu trouveras une description du service sur la page d'hébergement Headscale sur Saplo.

Prépare une Box active, le nom de l'application, son adresse cible et deux appareils pour tenter la connexion. La Box S fournit le Panneau et le SFTP, sans SSH. Tu effectueras l'installation depuis le Panneau, et tu téléchargeras le fichier d'instructions de démarrage depuis le Catalogue d'applications via SFTP. Tu exécuteras les commandes client Tailscale de ce tutoriel sur ton ordinateur, pas sur la Box.

Installation étape par étape

1. Connecte-toi au Panneau Saplo et va dans le catalogue d'applications.
2. Choisis Headscale et commence à créer l'application.
3. Donne-lui un nom, par exemple my-network, et indique la Box avec les ressources disponibles.
4. Choisis le Domaine ou le sous-domaine disponible *.saploapp.pl. Conserve l'adresse exacte affichée dans le panneau.
5. Confirme l'installation et attends la fin du déploiement. Vérifie le Statut et les messages de l'application au lieu de supposer un temps d'attente spécifique.
6. Connecte-toi via SFTP, en utilisant les informations d'accès de ta Box, et recherche le fichier HEADSCALE-SETUP.txt dans le répertoire de cette application. Télécharge-le sur ton ordinateur et ouvre-le comme du texte.

L'installateur prépare le service Headscale, la base de données SQLite locale, la configuration et l'utilisateur de démarrage admin. Il n'est pas nécessaire de créer une base de données distincte. L'adresse HTTPS est l'adresse du serveur de coordination, et non un panneau de gestion dans le navigateur. Cette installation ne contient pas de panneau graphique Headscale séparé.

Clé de démarrage et premier appareil

Le fichier HEADSCALE-SETUP.txt contient l'adresse du serveur et la commande de connexion avec la clé générée. La clé de démarrage est valable 24 heures à compter de sa génération et peut être utilisée plusieurs fois pendant cette période. Traite l'intégralité du fichier comme des données d'accès : ne le publie pas dans un dépôt ni sur des captures d'écran.

Sur le premier ordinateur Linux, installe le client depuis la page officielle de Tailscale. Exécute ensuite la commande du fichier de démarrage dans le terminal, avec les autorisations requises par le système. Son format est le suivant :

sudo tailscale up --login-server=https://YOUR-HEADSCALE-ADDRESS --authkey=KEY-FROM-FILE

Remplace les deux champs d'exemple par tes propres valeurs. N'entre pas ici le mot de passe du Panneau Saplo. La méthode d'enregistrement avec une clé est décrite dans la documentation de démarrage du client Headscale.

Si l'ordinateur est déjà connecté à un autre réseau Tailscale, planifie le changement en connaissance de cause. Ne change pas de cette manière la seule connexion à distance avec la machine. Pour le premier essai, choisis un équipement auquel tu as également un accès local.

Si le fichier indique que la clé n'a pas pu être générée, ou que la clé a expiré, une nouvelle clé créée côté Headscale est nécessaire. Box S ne fournit pas de SSH pour exécuter les commandes administratives du fichier. Dans ce cas, contacte le Support Saplo pour une configuration ultérieure, en indiquant le nom de l'application et le message, sans envoyer la clé. Ne supprime pas une installation fonctionnelle juste pour réenregistrer l'appareil.

Deuxième appareil et vérification de la connexion

Sur le deuxième ordinateur Linux, installe le client et indique la même adresse de serveur. Pendant la validité de la clé de démarrage, tu peux la réutiliser pour cet essai. Pour Windows, Android et les appareils Apple, utilise les instructions spécifiques à chaque plateforme dans la documentation des clients Headscale ; la manière d'indiquer ton propre serveur dépend du système.

Sur les deux ordinateurs, vérifie l'état du client et l'adresse attribuée :

tailscale status
tailscale ip -4

Ensuite, sur le premier ordinateur, exécute la commande suivante, en substituant l'adresse du second :

tailscale ping SECOND-DEVICE-ADDRESS

Ces commandes sont décrites dans la documentation CLI Tailscale. Vérifie également le service spécifique que tu comptes utiliser, par exemple une connexion SSH à ton propre serveur via son adresse sur le réseau VPN. Le service doit être en cours d'exécution et son accès autorisé par le pare-feu et les règles réseau. La simple apparition de l'appareil dans la liste ne confirme pas le fonctionnement de l'application.

Il est recommandé de répéter l'essai avec différentes connexions Internet, par exemple avec le deuxième ordinateur connecté via le hotspot d'un téléphone. Enregistre le résultat et vérifie la reconnexion après le redémarrage du client.

Que se passe-t-il avec le trafic et l'accès

La recette de Saplo utilise la carte de relais publique DERP de Tailscale et ne lance pas son propre DERP. Un serveur de coordination interne ne signifie donc pas que toute l'installation est indépendante de l'infrastructure de Tailscale. Ne considère pas non plus les paramètres de la Box comme une garantie de bande passante de connexion entre les appareils.

Avant d'ajouter une équipe, planifie des utilisateurs distincts, des règles d'accès et un moyen de supprimer les appareils inutilisés. L'utilisateur de démarrage commun sert à commencer, mais ne remplace pas la répartition finale des autorisations. Conserve une copie sécurisée de la configuration et des données de Headscale. Le fichier de clé de démarrage lui-même n'est pas une sauvegarde du service.

Questions fréquentes

Combien coûte l'hébergement Headscale ?

Au début, une Box S à 27 € par an est suffisante. Si tu partages la Box avec d'autres applications, prends en compte leur consommation de mémoire et d'espace disque.

Pourquoi ne vois-je pas le Panneau de connexion sous mon Domaine ?

Cette installation fournit un serveur de coordination sans Panneau d'administration graphique. Commence par le Statut de l'application et le fichier HEADSCALE-SETUP.txt, et vérifie le fonctionnement du réseau depuis le client Tailscale.

Pourquoi l'appareil ne se connecte-t-il pas ?

Compare l'adresse du serveur avec le fichier de démarrage, vérifie la disponibilité HTTPS et la validité de la clé. Assure-toi que le client n'essaie pas de se connecter au service Tailscale par défaut. Conserve le contenu de l'erreur, en supprimant les clés avant de le transmettre au Support.

Headscale remplace-t-il le client Tailscale ?

Non. Sur tes appareils, tu utilises toujours le client Tailscale. Headscale agit comme ton propre serveur de coordination.

Faut-il ouvrir le SSH sur la Box pour commencer ?

Pas pour l'installation depuis le catalogue et la première connexion utilisant une clé correctement générée. La gestion ultérieure des utilisateurs, des clés et de la politique d'accès nécessite des actions administratives côté Headscale. Tiens-en compte si tu envisages une utilisation permanente du service sur une Box S sans SSH.

Ouvre l'offre Headscale sur Saplo, démarre l'application et commence par connecter deux de tes propres appareils. Ce n'est qu'après avoir vérifié la communication et les règles d'accès que tu pourras connecter d'autres machines.