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
- wireguard-tools installieren
- sicherstellen dass /etc/wireguard mit restriktiven rechten existiert
- prüfen ob schon ein privater server-schlüssel existiert
- privaten server-schlüssel erzeugen (nur beim ersten lauf)
- privaten server-schlüssel lesen
- öffentlichen server-schlüssel ableiten
- konfiguration des wireguard-backup-tunnels templaten
- backup-port von wireguard in ufw freigeben
- wg-quick-dienst für den backup-tunnel aktivieren und starten
- öffentlichen server-schlüssel und verbindungsdaten anzeigen
Handler
- wireguard-backup-tunnel neu starten
Templates
wg-backup.conf.j2
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.