Info::wireguard:HeadScale entre deux CPUs pour sortir avec une autre IP
KEYWORDS: WIREGUARD, HEADSCALE, UK
Le 27/08/2026:
Installation Headscale + DERP multi-sites (France / UK)
Page de référence pour le déploiement d'un tailnet auto-hébergé reliant srv18 (poste local, LAN privé 192.168.1.18) à voilou.nl (VPS Debian, UK), avec srv18 maintenu en isolation maximale (aucun port exposé, aucun service hébergé dessus).
Vue d'ensemble
Principe de sécurité retenu : srv18 reste un client tailscale pur — aucun service Headscale ni DERP n'y est installé, aucune redirection de port n'est nécessaire sur sa box. Toute l'infrastructure exposée publiquement (control plane + les deux relais DERP) tourne sur des serveurs déjà publics et durcis : ovh1 (OVH Roubaix, France, 51.83.2.131) et voilou.nl (VPS UK). srv18 ne fait qu'initier des connexions sortantes vers eux.
┌─────────────────────────┐ ┌──────────────────────────┐
│ ovh1 (France) │ │ voilou.nl (UK) │
│ - Headscale │ │ - Client tailscale │
│ (control plane) │◄──────►│ - DERP region_id=901 │
│ - DERP region_id=900 │ │ (UK) │
│ - IP publique déjà │ │ - IP publique VPS │
│ exposée (mail, etc.) │ └──────────────────────────┘
└────────────┬─────────────┘
│ connexions sortantes uniquement
│ (srv18 n'écoute jamais)
┌────────────▼─────────────┐
│ srv18 (France, LAN) │
│ - Client tailscale pur │
│ - Aucun port exposé │
│ - Aucune redirection NAT │
└─────────────────────────────┘
srv18 apparaîtra dans le tailnet avec une IP privée type 100.64.x.x, joignable par les autres nœuds via le tunnel WireGuard, sans jamais avoir de port ouvert côté box/routeur.
Prérequis
- Debian 13 sur ovh1 et voilou.nl (déjà le cas pour ovh1), opération en root
- Un nom de domaine pointant vers ovh1 pour Headscale (ex :
headscale.pcstreet.fr) — attention aux ports déjà utilisés sur ovh1 (mail Postfix/Dovecot, ports 80/443/800/8103/1883/1115 déjà ouverts, voir la note firewall existante) - Un nom de domaine pointant vers voilou.nl (ex :
derp-uk.voilou.nl) - Ports à ouvrir uniquement sur ovh1 et voilou.nl (jamais sur srv18) :
- 443/tcp : API Headscale (ovh1) + DERP UK (voilou.nl)
- Un port dédié pour DERP FR sur ovh1 si 443 est déjà pris par un autre service (ex.
8444/tcpexposé publiquement) - 3478/udp sur ovh1 et voilou.nl : STUN (NAT traversal)
- Sur srv18 : aucun port entrant à ouvrir, juste sortie sortante autorisée (déjà le cas normalement)
Installation Headscale sur ovh1
Paquet
cd /tmp
curl -LO https://github.com/juanfont/headscale/releases/download/vX.Y.Z/headscale_X.Y.Z_linux_amd64.deb
dpkg -i headscale_X.Y.Z_linux_amd64.deb
Configuration
# /etc/headscale/config.yaml (extrait pertinent)
server_url: https://headscale.pcstreet.fr:443
listen_addr: 0.0.0.0:8080
metrics_listen_addr: 127.0.0.1:9090
database:
type: sqlite
sqlite:
path: /var/lib/headscale/db.sqlite
derp:
server:
enabled: true
region_id: 900
region_code: "pcstreet-fr"
region_name: "ovh1 self-hosted DERP (FR)"
stun_listen_addr: "0.0.0.0:3478"
urls: [] # vide = pas de DERP publics Tailscale
paths:
- /etc/headscale/derp-uk.yaml # DERP additionnel côté UK, voir plus bas
auto_update_enabled: false
dns:
magic_dns: true
base_domain: pcstreet.internal
Reverse proxy TLS
Vérifier d'abord qu'aucun service existant sur ovh1 n'utilise déjà le port choisi (le firewall actuel ouvre 80,443,800,8103,1883,1115 — confirmer si 443 est déjà occupé par un vhost avant de router Headscale dessus, sinon utiliser un sous-domaine avec un bloc server{} nginx dédié).
apt install nginx certbot python3-certbot-nginx
certbot --nginx -d headscale.pcstreet.fr
# /etc/nginx/sites-available/headscale
server {
listen 443 ssl;
server_name headscale.pcstreet.fr;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Real-IP $remote_addr;
}
}
Activation
systemctl enable --now headscale
systemctl status headscale
Création de l'utilisateur/namespace et d'une clé de préauthentification
headscale users create pcstreet
headscale preauthkeys create --user pcstreet --expiration 1h --reusable
# Copier la clé générée, elle servira pour tailscale up --authkey=...
Déploiement des relais DERP
Le binaire derper vient du dépôt officiel tailscale/tailscale (BSD-3-Clause), séparé de headscale. Les deux relais tournent sur ovh1 et voilou.nl uniquement — jamais sur srv18.
DERP FR sur ovh1
apt install golang-go git
git clone https://github.com/tailscale/tailscale.git /usr/local/src/tailscale
cd /usr/local/src/tailscale
go build -o /usr/local/bin/derper ./cmd/derper
# /etc/systemd/system/derper-fr.service
[Unit]
Description=Derper DERP relay (FR - ovh1)
After=network.target
[Service]
ExecStart=/usr/local/bin/derper \
--hostname=derp-fr.pcstreet.fr \
--certmode=letsencrypt \
--certdir=/var/lib/derper-fr/certs \
--a=:8444 \
--stun=true \
--stun-port=3478
Restart=on-failure
User=derper
DynamicUser=yes
StateDirectory=derper-fr
[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable --now derper-fr
DERP UK sur voilou.nl
Mêmes étapes sur le VPS voilou.nl :
# /etc/systemd/system/derper-uk.service
[Unit]
Description=Derper DERP relay (UK - voilou.nl)
After=network.target
[Service]
ExecStart=/usr/local/bin/derper \
--hostname=derp-uk.voilou.nl \
--certmode=letsencrypt \
--certdir=/var/lib/derper-uk/certs \
--a=:8443 \
--stun=true \
--stun-port=3478
Restart=on-failure
User=derper
DynamicUser=yes
StateDirectory=derper-uk
[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable --now derper-uk
Déclarer le DERP UK dans Headscale
# /etc/headscale/derp-uk.yaml (sur ovh1)
regions:
901:
regionid: 901
regioncode: "voilou-uk"
regionname: "voilou.nl self-hosted DERP (UK)"
nodes:
- name: "derp-uk"
regionid: 901
hostname: "derp-uk.voilou.nl"
stunport: 3478
stunonly: false
derpport: 8443
systemctl restart headscale
Installation des clients tailscale
Sur srv18 (client isolé, aucun port entrant)
curl -fsSL https://tailscale.com/install.sh | sh
# ip_forward n'est nécessaire que si srv18 doit lui-même relayer du trafic
# (ex. exit-node ou subnet router) — à NE PAS activer si le but est
# de rester un client isolé pur
tailscale up --login-server=https://headscale.pcstreet.fr \
--authkey=<clé-préauth-générée-plus-haut>
Rien d'autre à faire côté box/routeur de srv18 : le client initie toujours la connexion sortante (vers Headscale et vers les DERP), aucune ouverture entrante requise. Le NAT traversal direct entre peers, quand il fonctionne, se négocie via STUN sans que srv18 n'écoute jamais sur un port public.
Sur voilou.nl
curl -fsSL https://tailscale.com/install.sh | sh
sysctl -w net.ipv4.ip_forward=1
sysctl -w net.ipv6.conf.all.forwarding=1
tailscale up --login-server=https://headscale.pcstreet.fr \
--authkey=<clé-préauth-générée-plus-haut>
Tests de validation
tailscale status # les deux nœuds doivent apparaître "active"
tailscale ping voilou-nl # depuis srv18 : direct ou via DERP ?
tailscale netcheck # confirme quels DERP (900/901) sont vus et leur latence
Si tailscale ping depuis srv18 indique systématiquement un relais DERP (jamais de liaison directe), c'est attendu et acceptable dans ce modèle : srv18 étant volontairement injoignable en direct (pas de port ouvert), le trafic passe par le DERP le plus proche (900, FR) — la latence supplémentaire est le prix de l'isolation recherchée.
Durcissement supplémentaire côté srv18
- Ne jamais activer
--advertise-exit-nodeni--advertise-routessur srv18 : ça transformerait srv18 en relais, contraire à l'objectif d'isolation. - Restreindre les ACL Headscale pour limiter ce que srv18 peut atteindre dans le tailnet (fichier
acl_policy_pathdansconfig.yaml), plutôt que de laisser un accès total par défaut. - Le pare-feu local de srv18 (nftables/iptables) peut rester en
policy DROPsur toutes les entrées : l'interfacetailscale0n'a besoin d'aucune règle INPUT particulière pour fonctionner en client pur, seul l'trafic sortant UDP vers Headscale/DERP est nécessaire. - Envisager de limiter dans les ACL Headscale les pairs autorisés à initier une connexion vers srv18 (et pas seulement srv18 vers eux), pour réduire la surface même à l'intérieur du tailnet.
Pièges connus
- Conflit de port sur ovh1 : 443 est probablement déjà utilisé (mail, autres vhosts) — le DERP FR utilise ici
:8444exposé publiquement en plus de 443/Headscale ; vérifier la cohérence avec le firewall iptables existant sur ovh1 (ajouter la règle ACCEPT correspondante). - rp_filter : sans DNAT sur ovh1/voilou.nl pour ce montage, pas d'impact attendu — à revérifier seulement si d'autres règles NAT coexistent.
- Renouvellement TLS :
derper --certmode=letsencryptse renouvelle automatiquement tant que le port choisi reste joignable publiquement. - SQLite vs PostgreSQL : SQLite suffit pour un tailnet à quelques nœuds ; migrer vers PostgreSQL si le parc grandit significativement.
- Sauvegarde : intégrer
/var/lib/headscale/db.sqliteet/etc/headscale/(sur ovh1) dans la routine rsync existante vers srv09 (zfs-12To-Mirror).