Rolle `tailscale`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/tailscale.md
Rolle tailscale
WireGuard-Mesh-VPN, Auth-Key aus Ansible Vault; nur der homeserver ist Subnet-Router.
| Läuft gegen | controlplane-0, controlplane-1, worker-1, xibosignage-Displays, Banana Pi, alert-caller-VM |
| Tags | tailscale, vpn |
| Quellcode | roles/tailscale |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
tailscale_repo_codename |
{{ ansible_distribution_release }} |
– |
tailscale_repo_os |
{{ 'debian' if ansible_distribution == 'Debian' else 'ubuntu' }} |
– |
tailscale_signing_key_fingerprint |
<verdeckt> |
– |
tailscale_accept_routes |
false |
– |
tailscale_advertise_routes |
{{ local_subnet }} |
– |
Ablauf
- verzeichnis für apt-keyrings anlegen
- gpg-signaturschlüssel von tailscale herunterladen
- prüfen ob der tailscale-keyring existiert
- gnupg für die fingerprint-prüfung installieren
- temporäres gnupg-home anlegen
- fingerprint des tailscale-signaturschlüssels lesen
- temporäres gnupg-home entfernen
- fingerprint des tailscale-signaturschlüssels prüfen
- apt-repository für tailscale eintragen
- paket tailscale installieren (oder aktualisieren)
- dienst tailscaled aktivieren und starten
- warten bis tailscaled bereit ist
- aktuellen verbindungsstatus von tailscale prüfen
- tailscale-status auswerten
- aktuellen tailscale-zustand anzeigen
- bei tailscale mit auth-key anmelden
- temporäre datei für den auth-key anlegen
- auth-key in die temporäre datei schreiben
- mit tailscale verbinden und das lokale subnetz ankündigen
- temporäre auth-key-datei entfernen
- tailscale-optionen auffrischen (schon verbunden — hostname/routen aktualisieren)
- abschließenden tailscale-status lesen
- tailscale-ip-adresse lesen
- tailscale-verbindungsdaten anzeigen
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo systemctl status tailscaled
tailscale status
tailscale netcheck
sudo journalctl -u tailscaled -n 100 --no-pager
| Symptom | Ursache | Lösung |
|---|---|---|
Der Fingerprint von …tailscale-archive-keyring.gpg weicht ab |
Signaturschlüssel stimmt nicht mit tailscale_signing_key_fingerprint überein |
Schlüssel nicht vertrauen, Ursache klären |
Download Tailscale GPG signing key scheitert mit Connection reset by peer oder The read operation timed out |
pkgs.tailscale.com setzt Verbindungen zeitweise zurück; die Rolle wiederholt fünfmal, danach bricht sie ab |
Lauf erneut starten; bleibt es dauerhaft, curl -v https://pkgs.tailscale.com/ vom Host prüfen (Hintergrund) |
tailscale up schlägt fehl (invalid key, expired) |
Auth-Key abgelaufen oder verbraucht | neuen Auth-Key erzeugen, mit ansible-vault encrypt_string eintragen (Tailscale) |
| Subnetz nicht erreichbar über den Homeserver | Subnet-Route nicht genehmigt (nur der Homeserver ist Subnet-Router) | Admin-Konsole: Route genehmigen |
| Route ist im Tailnet genehmigt, trotzdem nicht erreichbar | Client akzeptiert keine Subnetzrouten (tailscale_accept_routes: false, Rollen-Default) |
tailscale status --json prüfen: AllowedIPs des eigenen Hosts zeigt nur die eigene /32; tailscale_accept_routes: true setzen (50030) |
Gerät NeedsLogin |
Gerät abgelaufen (zum Beispiel worker-0) | neu anmelden, Ablauf im Token-Register beachten |
| MagicDNS/Split-DNS wirkt nicht | Einstellung in der Admin-Konsole | DNS |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.