← zur Übersicht

Server 08 (headscale / VPN) wieder aufbauen


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:

BausteinArtOrt / Port
headscale (Hauptinstanz)systemd-Dienst, Debian-Paket 0.29.2/etc/headscale, /var/lib/headscale/db.sqlite, 127.0.0.1:8080
headscale-kunde2Docker headscale/headscale:0.29.2/opt/headscale-kunde2, 127.0.0.1:8081
headscale-kunde3Docker, gleiche Fassung/opt/headscale-kunde3, 127.0.0.1:8082
headplane, headplane2, headplane3Docker ghcr.io/tale/headplane:latest3000 / 3001 / 3002
privyxselbst gebaut aus /opt/ki-stack/privyx-presidio8000 intern
privyx-kunde3, formular-kunde3selbst gebaut aus /opt/ki-stack/kunde3/...8010 / 8020
openwebuiDocker ghcr.io/open-webui/open-webui:main127.0.0.1:3005
exitnode-kunde3Docker tailscale/tailscale:latestNetzwerk-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/:

DateiInhaltGröße
08-headscale-paket.tar.gz/opt komplett, /etc/headscale, Einheit, /usr/bin/headscale, nginx-Sites, /etc/letsencrypt, konsistente DB-Kopien824 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.gznur Konfiguration + Datenbanken20 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:

PhaseTagWas
1paketeapt, nginx, certbot, Docker (Quelle je nach Betriebssystem: Ubuntu → linux/ubuntu, Debian → linux/debian)
2dateienPaket + Zusatzpaket entpacken, Benutzer headscale anlegen, konsistente Datenbanken zurückspielen
3diensteheadscale starten + headscale health, Netz ki-netzwerk, alle Compose-Stacks (baut die lokalen Images)
4webservernginx-Sites verknüpfen, nginx -t, reload
5zertifikatcertbot für die neun Namen
6abnahmeGesundheit, 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

4. Geprüft am 31.10.2026 (Testserver wegwerf-08-headscale)

Frischer Ubuntu-24.04-Server, Paket aus der Sicherung eingespielt:

PrüfungErgebnis
Laufok=39 changed=8 failed=0
headscale healthbestanden
Hauptinstanzidentische Knoten wie in der Produktion: DESKTOP-U8HD9ES (MachineKey [Qlgfg]), debian-4gb-nbg1-1 ([64Flk]) — gleiche Schlüssel, also gleiche Identität
headscale-kunde21 Knoten
headscale-kunde32 Knoten
Container8 von 9 laufen: headplane, headplane2, headplane3, headscale-kunde2, headscale-kunde3, privyx, formular-kunde3, openwebui (healthy)
Diensteheadscale, 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

(`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.

Start nicht — der Copy-Task brach ab. Jetzt wird das Verzeichnis vor dem

Zurückspielen angelegt.

/etc/systemd/system.** Sie steckt deshalb im kleinen Zusatzpaket, und die

Pflichtprüfung schaut auf den richtigen Ort.

6. Offene Punkte

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.