Info::network::headscale VPN PCStreet/android

De wiki_pcwiki2
Aller à la navigationAller à la recherche

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.

  1. Installer F-Droid si ce n'est pas déjà fait (autoriser « installer des sources inconnues » si demandé)
  2. Dans F-Droid, rechercher « Tailscale » et l'installer
  3. Si la version Play Store est déjà installée, la désinstaller avant pour éviter tout conflit

Configuration du serveur

  1. Lancer l'app → Get Started
  2. Appuyer sur l'engrenage ⚙️ → Accounts
  3. Sur l'écran Accounts, taper sur les trois points ⋮ en haut à droite
  4. Choisir Use an alternate server
  5. Entrer : https://headscale.pcstreet.org
  6. 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.

  1. Installer Tailscale depuis l'App Store (éditeur Tailscale Inc.)
  2. 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

  1. Lancer l'app → écran de connexion
  2. 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)
  3. Entrer : https://headscale.pcstreet.org
  4. 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.

Voir aussi