Info::network::headscale VPN PCStreet/android
KEYWORDS: HEADSCALE, TAILSCANE, VPN, ANDROID, IPHONE
Le 13/10/2026:
Installer Tailscale sur mobile (tailnet pcstreet)
Ce guide couvre l'installation de Tailscale pour rejoindre le tailnet pcstreet, un serveur Headscale auto-hébergé sur srv18 (https://headscale.pcstreet.org). Ce tailnet n'utilise pas le service officiel tailscale.com et n'a pas d'OIDC configuré (pas de connexion Google/Microsoft) : l'enregistrement se fait via une clé de pré-authentification générée côté serveur.
Android
Installation
Important : la version Play Store de l'app Tailscale a un bug connu (voir issue GitHub #15660) qui rend inaccessible le menu permettant de choisir un serveur personnalisé. Utiliser la version F-Droid à la place.
- Installer F-Droid si ce n'est pas déjà fait (autoriser « installer des sources inconnues » si demandé)
- Dans F-Droid, rechercher « Tailscale » et l'installer
- Si la version Play Store est déjà installée, la désinstaller avant pour éviter tout conflit
Configuration du serveur
- Lancer l'app → Get Started
- Appuyer sur l'engrenage ⚙️ → Accounts
- Sur l'écran Accounts, taper sur les trois points ⋮ en haut à droite
- Choisir Use an alternate server
- Entrer :
https://headscale.pcstreet.org - L'app affiche une page avec une commande du type :
headscale auth register --auth-id <ID> --user USERNAME
Approbation côté serveur (srv18)
Sur srv18, exécuter la commande affichée par le téléphone, en remplaçant USERNAME par pcstreet :
headscale auth register --auth-id <ID> --user pcstreet
Le téléphone apparaît alors dans tailscale status avec une IP de la forme 100.64.254.x.
Alternative : clé de pré-authentification
Si le menu « Use an alternate server » reste inaccessible même sur F-Droid, générer une clé côté serveur :
headscale preauthkeys create -u 1 -e 24h --reusable
Puis, dans le même menu ⋮ de l'app, choisir Use an auth key et coller la clé.
Bonnes pratiques Android
- Batterie : désactiver l'optimisation de batterie pour Tailscale (Paramètres → Batterie → Tailscale → Sans restriction), sinon le tunnel se coupe en arrière-plan
- MagicDNS : si activé sur le tailnet, les machines sont joignables par leur nom (ex.
srv18) plutôt que par IP - Attention : se connecter avec un compte Google/Microsoft personnel dans l'app crée un tailnet officiel tailscale.com séparé, différent de pcstreet (IP dans une autre plage). Toujours passer par « Use an alternate server » pour rejoindre pcstreet.
iPhone (iOS)
Installation
Note : il n'existe pas de client iOS spécifique à Headscale. Headscale ne réimplémente que le serveur de coordination (le « control plane »), pas le client ; on utilise donc l'app officielle Tailscale (éditeur Tailscale Inc. sur l'App Store), qui est elle-même open source (licence BSD-3-Clause), simplement reconfigurée pour pointer vers le serveur Headscale pcstreet au lieu du service officiel tailscale.com.
- Installer Tailscale depuis l'App Store (éditeur Tailscale Inc.)
- L'app iOS n'a pas le bug observé sur Android : le choix du serveur personnalisé est normalement accessible directement dans l'interface
Configuration du serveur
- Lancer l'app → écran de connexion
- Chercher le lien « Use an alternate server » ou taper plusieurs fois sur le logo Tailscale pour le faire apparaître si besoin (variable selon version)
- Entrer :
https://headscale.pcstreet.org - L'app affiche une page avec une commande du type :
headscale auth register --auth-id <ID> --user USERNAME
Approbation côté serveur (srv18)
Sur srv18, exécuter la commande affichée par le téléphone, en remplaçant USERNAME par pcstreet :
headscale auth register --auth-id <ID> --user pcstreet
Le téléphone apparaît alors dans tailscale status avec une IP de la forme 100.64.254.x.
Alternative : clé de pré-authentification
Si le menu « Use an alternate server » reste inaccessible, générer une clé côté serveur :
headscale preauthkeys create -u 1 -e 24h --reusable
Puis, sur l'écran de connexion, choisir Use an auth key et coller la clé.
Bonnes pratiques iOS
- VPN actif : dans Réglages → Général → VPN et gestion de l'appareil, vérifier que le profil VPN Tailscale est actif
- Batterie : iOS peut couper le VPN en arrière-plan sur batterie faible ou en mode économie d'énergie : désactiver le mode économie d'énergie si des coupures sont constatées
- MagicDNS : si activé sur le tailnet, les machines sont joignables par leur nom (ex.
srv18) plutôt que par IP - Attention : se connecter avec un compte Apple/Google personnel dans l'app crée un tailnet officiel tailscale.com séparé, différent de pcstreet (IP dans une autre plage). Toujours passer par « Use an alternate server » pour rejoindre pcstreet.