PKR-Lab

Rolle `wireguard_backup`

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/wireguard_backup.md

Rolle wireguard_backup

Notfall-Tunnel, falls die Tailscale-Control-Plane ausfällt.

Läuft gegen controlplane-0
Tags backup, vpn, wireguard
Quellcode roles/wireguard_backup

Variablen

Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.

Variable Default Bedeutung
wireguard_backup_interface wg-backup –
wireguard_backup_server_tunnel_ip 10.99.99.1/24 –
wireguard_backup_peer_tunnel_ip 10.99.99.2/32 –
wireguard_backup_peer_name admin-backup-device –

Ablauf

  1. wireguard-tools installieren
  2. sicherstellen dass /etc/wireguard mit restriktiven rechten existiert
  3. prüfen ob schon ein privater server-schlüssel existiert
  4. privaten server-schlüssel erzeugen (nur beim ersten lauf)
  5. privaten server-schlüssel lesen
  6. öffentlichen server-schlüssel ableiten
  7. konfiguration des wireguard-backup-tunnels templaten
  8. backup-port von wireguard in ufw freigeben
  9. wg-quick-dienst für den backup-tunnel aktivieren und starten
  10. öffentlichen server-schlüssel und verbindungsdaten anzeigen

Handler

Templates


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 wg-quick@wg-backup
sudo wg show
sudo ufw status | grep -i wireguard
Symptom Ursache Lösung
Notfall-Tunnel verbindet nicht Dienst aus, UFW-Port nicht offen, Peer-Konfiguration stimmt nicht sudo wg show, Peer-Schlüssel, WireGuard-Backup
Server-Schlüssel unbekannt wird beim ersten Lauf erzeugt und am Ende des Laufs angezeigt sudo wg show wg-backup public-key
Tunnel-IP-Konflikt 10.99.99.0/24 kollidiert mit einem anderen Netz wireguard_backup_*_tunnel_ip ändern

Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.

Alle Rollen