--- titel: Server 08 (headscale / VPN) wieder aufbauen stand: 31.10.2026, 18:35 zweck: Alles, was zum Neuaufbau von 08 gehört — Sicherung, Playbook, geprüfte Ergebnisse, offene Punkte. --- # Server 08 — VPN-Infrastruktur neu aufbauen ## 1. Was auf 08 läuft `08-headscale` (167.233.84.159, cx23, Debian 12) ist der einzige Server mit **Kundendaten**. Drei headscale-Instanzen, drei Admin-Oberflächen, vier Kunden-Apps: | Baustein | Art | Ort / Port | |---|---|---| | `headscale` (Hauptinstanz) | systemd-Dienst, Debian-Paket 0.29.2 | `/etc/headscale`, `/var/lib/headscale/db.sqlite`, 127.0.0.1:8080 | | `headscale-kunde2` | Docker `headscale/headscale:0.29.2` | `/opt/headscale-kunde2`, 127.0.0.1:8081 | | `headscale-kunde3` | Docker, gleiche Fassung | `/opt/headscale-kunde3`, 127.0.0.1:8082 | | `headplane`, `headplane2`, `headplane3` | Docker `ghcr.io/tale/headplane:latest` | 3000 / 3001 / 3002 | | `privyx` | **selbst gebaut** aus `/opt/ki-stack/privyx-presidio` | 8000 intern | | `privyx-kunde3`, `formular-kunde3` | selbst gebaut aus `/opt/ki-stack/kunde3/...` | 8010 / 8020 | | `openwebui` | Docker `ghcr.io/open-webui/open-webui:main` | 127.0.0.1:3005 | | `exitnode-kunde3` | Docker `tailscale/tailscale:latest` | Netzwerk-Modus host | Nötig ist außerdem das Docker-Netz **`ki-netzwerk`** (`external: true` in den Compose-Dateien). ## 2. Sicherung Bauen: `sudo -n bash hilfsskripte/08-paket-bauen.sh` (läuft auf dem Steuerserver, arbeitet über SSH auf 08). Ergebnis in `/root/work/sicherungen/08-headscale/`: | Datei | Inhalt | Größe | |---|---|---| | `08-headscale-paket.tar.gz` | `/opt` **komplett**, `/etc/headscale`, Einheit, `/usr/bin/headscale`, nginx-Sites, `/etc/letsencrypt`, konsistente DB-Kopien | 824 MB | | `08-headscale-ergaenzung.tar.gz` | `/lib/systemd/system/headscale.service` (liegt auf dem Original dort, nicht in `/etc`) | 714 B | | `08-headscale-klein.tar.gz` | nur Konfiguration + Datenbanken | 20 KB | **Datenbanken** werden nicht einfach kopiert, sondern über die SQLite-Backup-API (`sqlite3.backup`) — bei laufendem Betrieb wäre eine Dateikopie womöglich inkonsistent. Geprüft mit `PRAGMA integrity_check`. > **Geheimhaltung:** Das Paket enthält die headscale-Schlüssel und damit die > Kontrolle über die Kunden-VPNs. Es liegt auf dem Steuerserver mit > `0600`-Rechten und gehört **nicht** ins Git und nicht in den Vault-Text. ## 3. Das Playbook `playbooks/08-headscale.yml`, sechs Phasen wie bei 05 und 09: | Phase | Tag | Was | |---|---|---| | 1 | `pakete` | apt, nginx, certbot, Docker (Quelle je nach Betriebssystem: Ubuntu → `linux/ubuntu`, Debian → `linux/debian`) | | 2 | `dateien` | Paket + Zusatzpaket entpacken, Benutzer `headscale` anlegen, **konsistente Datenbanken zurückspielen** | | 3 | `dienste` | headscale starten + `headscale health`, Netz `ki-netzwerk`, alle Compose-Stacks (baut die lokalen Images) | | 4 | `webserver` | nginx-Sites verknüpfen, `nginx -t`, reload | | 5 | `zertifikat` | certbot für die neun Namen | | 6 | `abnahme` | Gesundheit, Knotenlisten, Container, Ports | Aufrufe: ```bash # Erstprobe auf einem Wegwerfserver (ohne DNS und Zertifikat): ansible-playbook playbooks/08-headscale.yml -i inventory/wegwerf.ini \ -l wegwerf-08-headscale -e "mit_webserver=false mit_zertifikat=false" \ --tags pakete,dateien,dienste,abnahme # Nur ein Teil der Stacks (schneller Ersttest): -e '{"compose_stacks":["/opt/headscale-kunde2","/opt/headscale-kunde3","/opt/headplane"]}' # Vollständig auf dem Zielserver: ansible-playbook playbooks/08-headscale.yml -i inventory/produktion.ini \ -l 08-headscale --tags pakete,dateien,dienste,webserver,zertifikat,abnahme ``` ## 4. Geprüft am 31.10.2026 (Testserver `wegwerf-08-headscale`) Frischer Ubuntu-24.04-Server, Paket aus der Sicherung eingespielt: | Prüfung | Ergebnis | |---|---| | Lauf | `ok=39 changed=8 failed=0` | | `headscale health` | bestanden | | Hauptinstanz | **identische Knoten** wie in der Produktion: `DESKTOP-U8HD9ES` (MachineKey `[Qlgfg]`), `debian-4gb-nbg1-1` (`[64Flk]`) — gleiche Schlüssel, also gleiche Identität | | `headscale-kunde2` | 1 Knoten | | `headscale-kunde3` | 2 Knoten | | Container | 8 von 9 laufen: `headplane`, `headplane2`, `headplane3`, `headscale-kunde2`, `headscale-kunde3`, `privyx`, `formular-kunde3`, `openwebui` (healthy) | | Dienste | `headscale`, `docker`, `nginx` aktiv; Ports 8080/8081/8082/9090 lauschen | **Damit ist bewiesen:** Der Aufbau aus der Sicherung funktioniert, und die Kunden-Identitäten bleiben erhalten — niemand muss sich neu anmelden. ## 5. Vier Fehler, die erst der Test gezeigt hat 1. **`get_url` über HTTPS geht auf dem Steuerserver nicht** (`HTTPSConnection.__init__() got an unexpected keyword argument 'cert_file'`, Ansible 2.14 + urllib3). Ersatz: `curl` per `command`. Derselbe Fehler wie bei `uri` in `09b`. 2. **Falsche Docker-Paketquelle auf Ubuntu.** Die Produktion ist Debian 12, ein Wegwerfserver Ubuntu 24.04 → `…/linux/debian noble Release does not have a Release file`. Jetzt wird die Quelle aus `ansible_distribution` abgeleitet. 3. **Datenbank-Zielpfad fehlte.** `/var/lib/headscale` existiert vor dem ersten Start nicht — der Copy-Task brach ab. Jetzt wird das Verzeichnis **vor** dem Zurückspielen angelegt. 4. **Die systemd-Einheit liegt in `/lib/systemd/system`, nicht in `/etc/systemd/system`.** Sie steckt deshalb im kleinen Zusatzpaket, und die Pflichtprüfung schaut auf den richtigen Ort. ## 6. Offene Punkte 1. **`exitnode-kunde3` startet in der Schleife.** Ursache: Der Einmal-Schlüssel `TS_AUTHKEY` im Compose ist verbraucht, und `TS_LOGIN_SERVER` zeigt auf `https://kunde3.weiter.online` (also auf die Produktion). Für einen echten Wiederaufbau braucht es einen **frischen Preauth-Key** aus der Kundeninstanz — oder man lässt den Exit-Node neu aufnehmen. Kein Codefehler, ein Betriebsschritt. 2. **nginx-Sites und Zertifikate** wurden im Test bewusst ausgelassen (`mit_webserver=false mit_zertifikat=false`), weil ein Wegwerfserver keine passenden DNS-Namen hat. Vollständiger Test nur mit echten Namen möglich — und der kostet Let's-Encrypt-Kontingent (5 Duplikate pro Woche). 3. **Reihenfolge bei echter Umstellung:** erst DNS der neun Namen umstellen, dann Webserver+Zertifikat, dann alte Maschine abschalten. Die Clients merken vom Wechsel nichts, weil die Knoten-Schlüssel gleich bleiben.