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.
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).
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.
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:
# 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
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.
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.
ein Wegwerfserver Ubuntu 24.04 → `…/linux/debian noble Release does not have
a Release file. Jetzt wird die Quelle aus ansible_distribution` abgeleitet.
/var/lib/headscale existiert vor dem erstenStart nicht — der Copy-Task brach ab. Jetzt wird das Verzeichnis vor dem
Zurückspielen angelegt.
/lib/systemd/system, nicht in /etc/systemd/system.** Sie steckt deshalb im kleinen Zusatzpaket, und die
Pflichtprüfung schaut auf den richtigen Ort.
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.
(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).
dann Webserver+Zertifikat, dann alte Maschine abschalten. Die Clients merken
vom Wechsel nichts, weil die Knoten-Schlüssel gleich bleiben.