c0010 - Tailscale-VPN-Guide
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/c-netzwerk-dns/c0010-tailscale.md
Tailscale-VPN-Guide
Dieses Dokument behandelt Tailscale-Setup, MagicDNS, Subnet-Routing und Client-Konfiguration.
Überblick
Tailscale baut ein WireGuard-basiertes Mesh-VPN (ein „tailnet") zwischen allen
eigenen Geräten. Sobald der Home-Server im Tailnet ist, sind seine Services
von jedem Tailscale-Gerät erreichbar — ohne Port-Forwarding, ohne Dynamic-DNS,
ohne offene Ports am Router.
Auth-Key besorgen
Auth-Keys lassen Geräte automatisch dem Tailnet beitreten (praktisch für
Server, bei denen ein interaktiver Browser-Login nicht passt).
- Im Tailscale-Admin-Panel einloggen.
- Settings → Keys.
- Generate auth key.
- Optionen:
- Reusable: deaktivieren (Single-Use ist sicherer)
- Ephemeral: deaktivieren (Server soll persistent bleiben)
- Tags: optional — z. B.
tag:homeserverfür ACLs - Expiry: vernünftiges Ablaufdatum setzen (oder ganz deaktivieren)
- Generate key.
- Key sofort kopieren — er wird nur einmal angezeigt.
Mit Ansible-Vault verschlüsseln (niemals plaintext speichern):
ansible-vault encrypt_string 'tskey-auth-DEIN_KEY' --name 'tailscale_auth_key'
Den verschlüsselten Block in capulus-ansible/group_vars/all.yml einsetzen.
MagicDNS einrichten
Tailscale-MagicDNS löst Hostnamen aller Tailnet-Geräte automatisch auf. Mit
MagicDNS erreichst du den Home-Server unter homeserver oder
homeserver.tail12345.ts.net von jedem Tailscale-Client.
MagicDNS aktivieren:
- Tailscale-Admin-Panel → DNS.
- Enable MagicDNS anschalten.
- Optional einen Global nameserver (z. B.
1.1.1.1) für Nicht-Tailscale-Hostnamen setzen.
Nach Aktivierung — Server-Zugriff:
# Kurzer Hostname (im Tailnet)
https://argocd.tech.homeserver # ArgoCD (HTTPS über Traefik, interne CA)
ssh homeserver # SSH
# Voller Tailnet-Hostname
https://argocd.tech.homeserver # ArgoCD-API/CLI (HTTPS über Traefik)
ssh homeserver.tail12345.ts.net
Den Tailnet-Namen findest du im Admin-Panel unter Settings → General.
MagicDNS testen:
# Vom Client mit laufendem Tailscale
ping homeserver
nslookup homeserver
curl -s https://argocd.tech.homeserver/api/version
Zugriff über die Tailscale-IP
Jedes Gerät im Tailnet bekommt eine stabile IP im Bereich 100.x.x.x (CGNAT).
Tailscale-IP des Servers ermitteln:
# Auf dem Server
tailscale ip -4
# Oder im Admin-Panel:
# https://login.tailscale.com/admin/machines
Beispiel — Server-Tailscale-IP 100.101.102.103:
http://100.101.102.103:80 # Traefik HTTP
ssh 100.101.102.103 # SSH
kubectl --server=https://100.101.102.103:6443 get nodes
Subnet-Routing
Subnet-Routing erlaubt anderen Tailscale-Clients, Geräte im Heim-LAN zu
erreichen, auf denen kein Tailscale läuft — z. B. eine NAS, ein Smart-TV
oder ein Drucker.
Die Ansible-Rolle konfiguriert den Server so, dass er das eigene Subnetz
(local_subnet, Default 192.168.1.0/24) advertised.
Nicht jeder Host soll Subnetz-Router sein: Die Rolle liest dafür die
Variable tailscale_advertise_routes (Default {{ local_subnet }}, siehe
capulus-ansible/roles/tailscale/defaults/main.yml). Geräte, die nur selbst im
Tailnet erreichbar sein sollen, ohne fremden LAN-Traffic weiterzuleiten —
z. B. die xibosignage-Raspberry-Pis, siehe
capulus-core/3-apps-workloads/300e0-xibosignage.md — setzen sie in ihren
group_vars auf "", dann lässt die Rolle --advertise-routes beim
tailscale up/tailscale set-Aufruf komplett weg:
# capulus-ansible/group_vars/<gruppe>.yml
tailscale_advertise_routes: ""
Subnet-Routes freischalten:
Nach dem Playbook-Run die advertised Routes im Admin-Panel approven:
- Admin-Panel öffnen.
- Home-Server auswählen.
- ... → Edit route settings.
- Das advertised Subnet (
192.168.1.0/24) aktivieren. - Save.
Subnet-Zugriff testen:
# Von einem Tailscale-Client
ping 192.168.1.1
curl http://192.168.1.1/ # Router-Admin-Seite (falls erreichbar)
# Server direkt über die LAN-IP
curl -s https://argocd.tech.homeserver/api/version
Subnet-Routing am Client aktivieren:
Auf macOS/Windows/iOS/Android-Clients muss in den App-Settings „Use Tailscale
subnets" aktiviert sein, damit Subnet-Routes greifen.
Auf Linux:
sudo tailscale up --accept-routes
Client-Geräte verbinden
Tailscale auf allen Geräten installieren:
Linux
# Installation
curl -fsSL https://tailscale.com/install.sh | sh
# Verbinden (öffnet Browser zur Auth)
sudo tailscale up
# Verbinden mit Subnet-Routing
sudo tailscale up --accept-routes
# Status
tailscale status
tailscale ip -4
macOS
# Via Homebrew
brew install --cask tailscale
# Oder Mac App Store:
# https://apps.apple.com/app/tailscale/id1475387142
Nach der Installation auf das Tailscale-Icon in der Menü-Leiste → Log In.
Windows
Download: https://tailscale.com/download/windows
Tailscale-Icon im Tray → Log In.
iOS / Android
App Store bzw. Google Play, „Tailscale".
Konnektivität verifizieren
Nach dem Verbinden eines Clients:
# Vom Client
tailscale status # homeserver sollte in der Liste stehen
ping homeserver # MagicDNS
curl -s https://argocd.tech.homeserver/api/version # ArgoCD
ssh ubuntu@homeserver # SSH
Tailscale-Management auf dem Server
Status:
tailscale status
Zeigt alle Tailnet-Geräte und deren Verbindungsstatus.
Details:
tailscale status --json | jq .
tailscale ping homeserver # Latenz zu einem anderen Tailnet-Gerät
tailscale netcheck # Netz-Diagnostik
Häufige Server-Kommandos:
# Verbindung trennen
sudo tailscale down
# Wieder verbinden (nutzt bestehende Auth)
sudo tailscale up
# Re-Authentifizierung erzwingen
sudo tailscale up --force-reauth
# Tailscale-IP
tailscale ip -4
tailscale ip -6
# Logs
sudo journalctl -u tailscaled -f
sudo journalctl -u tailscaled --since "1 hour ago"
# Service-Management
sudo systemctl status tailscaled
sudo systemctl restart tailscaled
Exit-Node (optional)
Wenn der Home-Server als Exit-Node konfiguriert wird, routet sämtlicher
Internet-Traffic vom Client durch die Heim-Internet-Verbindung. Praktisch
in unsicheren Netzen (Public WiFi).
Exit-Node auf dem Server aktivieren:
# Als Exit-Node advertisen
sudo tailscale up \
--advertise-exit-node \
--advertise-routes=192.168.1.0/24 \
--hostname=homeserver
Im Admin-Panel approven:
- Admin-Panel → eigener Server.
- ... → Edit route settings.
- Use as exit node aktivieren.
- Save.
Exit-Node auf dem Client nutzen:
# Linux: Home-Server als Exit-Node
sudo tailscale up --exit-node=homeserver
# Oder über die Tailscale-IP
sudo tailscale up --exit-node=100.101.102.103
# Exit-Node deaktivieren
sudo tailscale up --exit-node=
Auf macOS/Windows: Tailscale-Icon → Exit Node → eigenen Server wählen.
Verifizieren:
# Sollte die Heim-IP zeigen, nicht die IP des aktuellen Netzes
curl ifconfig.me
ACL-Konfiguration
Tailscale-ACLs (Access Control Lists) steuern, welches Gerät welches andere
Gerät erreichen darf. Default ist „all-to-all".
ACL-Policy im Admin-Panel editieren:
Beispiel: nur bestimmte Geräte dürfen auf den Home-Server zugreifen:
{
"acls": [
{
"action": "accept",
"src": ["tag:personal-devices"],
"dst": ["tag:homeserver:*"]
}
],
"tagOwners": {
"tag:homeserver": ["autogroup:admin"],
"tag:personal-devices": ["autogroup:admin"]
}
}
Auth-Keys werden dann mit den passenden Tags erstellt (tag:homeserver für den Server,
tag:personal-devices für Laptops/Phones).
Multi-Cluster: wer im Tailnet ist
Nur die physischen Hosts sind Tailnet-Mitglieder: homeserver, worker-0, worker-1 (plus
Kiosk-Geräte wie der Banana Pi und die Xibo-Displays). Die KVM-VMs prod-vm (PROD) und entw-vm
(ENTW) tragen bewusst keinen Tailscale-Schlüssel (ENTW ist eine absichtlich verwundbare
Trainingsumgebung). Sie sind aus der Ferne nur über den Subnet-Router erreichbar: der homeserver
bewirbt 192.168.178.0/24 (tailscale_advertise_routes), worker-0 und worker-1 sind reine
Clients ohne --advertise-routes. Im Admin-Panel muss die beworbene Route freigegeben sein.
Für eine restriktivere Policy ist in 40080, Baustein 2
ein Tag-Schema pro Cluster vorgesehen (tag:tech-node, tag:prod-node, tag:entw-node; laut Plan
homeserver = tech + prod, worker-1 = entw). Welche Policy im Admin-Panel tatsächlich gespeichert ist,
steht nicht im Repo — dort prüfen, bevor man sich auf eine Trennung verlässt.
Troubleshooting
Detaillierte Schritte in ../a-betriebssystem/a0040-troubleshooting.md.
Schnell-Checks:
# Läuft tailscaled?
sudo systemctl status tailscaled
# Verbindung aktiv?
tailscale status
# Netzdiagnose
tailscale netcheck
# Erreicht der Server die Tailscale-Services?
curl -sv https://login.tailscale.com/
# Vollständige Logs
sudo journalctl -u tailscaled --since "30 minutes ago"