PKR-Lab

e0000 - Cloudflare Tunnel — Externe Erreichbarkeit ohne VPN

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/e-externe-erreichbarkeit/e0000-cloudflare-tunnel.md

Cloudflare Tunnel — Externe Erreichbarkeit ohne VPN

Dieses Dokument beschreibt, wie ausgewählte Dienste aus argocd/apps/tech/ und
argocd/apps/prod/ über Cloudflare Tunnel
öffentlich im Internet erreichbar gemacht werden — ohne Portfreigabe am
Router, ohne öffentliche IP und ohne dass du für jeden Zugriff erst
Tailscale verbinden musst.

Deploy-/Rollout-Schritte (Day-2-Betrieb, neuen Dienst freigeben,
Troubleshooting) stehen separat in
capulus-core/e-externe-erreichbarkeit/e0010-cloudflare-deploy.md.


Inhaltsverzeichnis

  1. Warum Cloudflare Tunnel?
  2. Voraussetzungen
  3. Schritt 1 — Domain zu Cloudflare hinzufügen (Netcup-spezifisch)
  4. Schritt 2 — Tunnel erstellen
  5. Schritt 3 — Credentials versiegeln
  6. Schritt 4 — DNS-Routing: Wildcard statt Einzel-Records
  7. Schritt 5 — values.yaml befüllen
  8. Zusätzliche Absicherung: Cloudflare Access
  9. Welche Dienste eignen sich zur Freigabe?
  10. Sicherheitsprinzipien
  11. Troubleshooting

Warum Cloudflare Tunnel?

Der Home-Server sitzt hinter der Fritz!Box, hat keine öffentliche IP und
soll auch keine bekommen. Bisher ist der einzige Weg von außen Tailscale
(siehe capulus-core/c-netzwerk-dns/c0010-tailscale.md) — super für dich selbst,
aber unpraktisch, wenn z. B. ein DLRG-Kamerad im Wachdienst schnell im Wiki
nachschauen will und weder Tailscale installiert noch einen Account hat.

┌──────────────┐        ausgehende Verbindung        ┌───────────────────┐
│  Home-Server │ ───────────────────────────────────▶│  Cloudflare Edge  │
│  (cloudflared)│      (TLS, kein offener Port nötig) │  (Reverse Proxy)  │
└──────────────┘                                      └─────────┬─────────┘
                                                                  │
                                                        https://dienst.domain.de
                                                                  │
                                                                  ▼
                                                         Beliebiger Browser
                                                     (kein VPN, kein Client nötig)

Tailscale bleibt für alles mit Admin-Charakter (ArgoCD, Semaphore,
Headlamp, kubectl, SSH) der richtige Weg — Cloudflare Tunnel ergänzt das
nur für die Dienste, bei denen "irgendwer ohne VPN-Client" tatsächlich
Zugriff braucht.

Zwei Tunnel: TECH und PROD

Seit der Multi-Cluster-Umstellung (40080) läuft in
TECH und PROD je ein eigenes cloudflared mit eigenem Tunnel. Seit dem Wechsel auf pkr-lab.de
(2026-11-12) kommt der gesamte externe Verkehr beim TECH-Tunnel an, der PROD-Tunnel bekommt keinen Verkehr mehr:

Cluster ArgoCD-App Tunnel Stand
TECH argocd/apps/tech/cloudflared/ homeserver nimmt alle externen Hosts an: der Wildcard *.pkr-lab.de → Traefik des TECH-Clusters, davor je eine explizite Regel pro PROD-Host → Traefik des PROD-Clusters (https://192.168.178.99:443)
PROD argocd/apps/prod/cloudflared/ homeserver-prod läuft weiter, aber kein DNS-Eintrag zeigt mehr auf ihn; der Abbau ist vorgesehen

Bei Cloudflare gibt es einen einzigen DNS-Eintrag: * als proxied CNAME auf <TUNNEL-ID>.cfargotunnel.com
des TECH-Tunnels (die ID steht in argocd/apps/tech/cloudflared/values.yaml). Welcher Cluster einen Host
bedient, steht in der cloudflared-Konfiguration im Git und nicht mehr im DNS.
cloudflared prüft die Regeln von
oben nach unten, deshalb stehen die expliziten PROD-Hostregeln vor dem Wildcard:

Host Regel in argocd/apps/tech/cloudflared/values.yaml Ziel
nextcloud-prod.pkr-lab.de, immich-prod.pkr-lab.de, wiki-prod.pkr-lab.de, xibo-prod.pkr-lab.de eigene Regel je Host Traefik des PROD-Clusters, originServerName: nextcloud.prod.homeserver
alle anderen *.pkr-lab.de Wildcard Traefik des TECH-Clusters, originServerName: homeserver

originServerName ist bei den PROD-Regeln ein Name aus der SAN-Liste des PROD-Zertifikats. Verschwindet
nextcloud.prod.homeserver aus dieser Liste, scheitert die Prüfung und alle vier Hosts liefern 502, siehe
028.

Ausfall. Fällt der TECH-Tunnel aus (beide Replicas oder die Verbindung zu Cloudflare), sind jetzt auch die
PROD-Hosts extern nicht erreichbar. Der interne Zugriff über *.homeserver per LAN oder Tailscale bleibt davon
unberührt. Vorher traf ein Tunnelausfall nur den jeweiligen Cluster. Der Tunnel läuft mit zwei Replicas, siehe
60040.

ENTW hat keinen Tunnel (kein cloudflared unter argocd/apps/entw/); die Trainingsumgebung ist nicht aus dem
Internet erreichbar.

Die Schritte 2–5 unten beschreiben den Aufbau für den TECH-Tunnel. Für den PROD-Tunnel sind sie mit Tunnel-Name
homeserver-prod und den Dateien unter argocd/apps/prod/cloudflared/ identisch, wären aber nur nötig, falls er
wieder Verkehr bekommen soll.

Domain. Die öffentliche Zone ist pkr-lab.de (Cloudflare, Plan Free). Die frühere Domain pke-lab.de ist
abgelaufen (DENIC-Status am 2026-11-12: Redemption Period) und löst nicht mehr auf. Ältere Beschreibungen, Belege und Incident-Texte nennen sie noch.


Voraussetzungen


Schritt 1 — Domain zu Cloudflare hinzufügen (Netcup-spezifisch)

1.1 — Bestehende DNS-Records sichern

Wichtig, bevor du irgendetwas umstellst: Sobald die Nameserver auf
Cloudflare zeigen, verwaltet ausschließlich Cloudflare die DNS-Zone —
alle bisher bei Netcup gepflegten Records (insbesondere MX-Einträge,
falls über die Domain E-Mail läuft, sowie bestehende A/CNAME/TXT
für z. B. SPF/DKIM) müssen in Cloudflare nachgezogen werden, sonst gehen
sie beim Umstellen "verloren" (sie existieren bei Netcup weiter, werden
aber nicht mehr abgefragt).

# Aktuellen Zustand vor der Umstellung dokumentieren
dig +short MX deine-domain.de
dig +short TXT deine-domain.de
dig +short A deine-domain.de

Ausgabe notieren — dient als Checkliste für Schritt 1.3.

1.2 — Site in Cloudflare anlegen

  1. Cloudflare-Dashboard → Add a Site.
  2. Domain eingeben (genau wie bei Netcup registriert, ohne www.),
    Free Plan wählen.
  3. Cloudflare scannt automatisch die bestehende DNS-Zone bei Netcup und
    schlägt gefundene Records zur Übernahme vor — das deckt in der Regel
    den Großteil ab, aber gegen die Notizen aus 1.1 gegenprüfen,
    bevor du weitermachst (der automatische Scan findet nicht immer
    jeden Record, z. B. manche TXT-Einträge).

1.3 — Nameserver bei Netcup umstellen

  1. Cloudflare zeigt jetzt zwei Nameserver an, z. B.:
    bob.ns.cloudflare.com
    flora.ns.cloudflare.com
    
  2. Im Netcup CCP einloggen →
    Domains → betroffene Domain auswählen → Nameserver ändern.
  3. Die beiden bei Netcup voreingestellten Nameserver
    (ns1.netcup.net / ns2.netcup.net / ns3.netcup.net) durch die
    beiden Cloudflare-Nameserver ersetzen, speichern.
  4. Warten, bis Cloudflare die Umstellung erkennt — im Cloudflare-Dashboard
    erscheint dann Active statt Pending Nameserver Update. Bei
    Netcup ist das meist innerhalb von 1–4 Stunden propagiert, DNS-TTLs
    können es in Einzelfällen bis zu 24 h dauern lassen.
# Propagation prüfen — sollte irgendwann Cloudflare-Nameserver zeigen
dig +short NS deine-domain.de

Schritt 2 — Tunnel erstellen

# Einmalig: Browser-Login, autorisiert die lokale cloudflared-CLI
cloudflared tunnel login

# Tunnel anlegen — Name frei wählbar, hier "homeserver"
cloudflared tunnel create homeserver

Die Ausgabe enthält:

Beide Werte werden in den nächsten Schritten gebraucht. Die
Credentials-Datei ist das Äquivalent eines privaten Schlüssels für den
Tunnel — niemals im Klartext committen.


Schritt 3 — Credentials versiegeln

Analog zum bestehenden SealedSecrets-Workflow, z. B.
capulus-core/3-apps-workloads/30000-zammad.md:

kubeseal --raw \
  --namespace cloudflared \
  --name cloudflared-credentials \
  --controller-namespace sealed-secrets \
  --controller-name sealed-secrets-controller \
  --from-file=/pfad/zu/~/.cloudflared/<TUNNEL-ID>.json

Den ausgegebenen Ciphertext in
argocd/apps/tech/cloudflared/values.yaml unter
tunnel.encryptedCredentialsJson eintragen.

Alternativ per Web-UI: https://kubeseal-webgui.tech.homeserver, Namespace
cloudflared, Secret-Name cloudflared-credentials, Key
credentials.json, Value = Inhalt der .json-Datei.


Schritt 4 — DNS-Routing: Wildcard statt Einzel-Records

Zwei Optionen, wie öffentliche Hostnamen auf den Tunnel zeigen. Wichtig,
zum Verständnis: das ist reines DNS-Routing zum Tunnel — welcher
interne k8s-Service hinter welchem Hostnamen hängt, entscheidet weiterhin
ausschließlich tunnel.ingress.rules in values.yaml (Schritt 5). Eine
Wildcard-DNS-Route macht also nicht automatisch neue Dienste
erreichbar, sie erspart dir nur den DNS-Schritt bei jedem neuen Dienst.

Empfohlen: eine Wildcard-Route für die ganze Subdomain-Ebene

Ein einziger CNAME für *.deine-domain.de deckt jeden aktuellen und
zukünftigen <name>.deine-domain.de-Hostnamen ab — neue Dienste brauchen
danach nur noch einen Eintrag in values.yaml (kein DNS-Schritt
mehr, kein erneutes cloudflared tunnel route dns):

cloudflared tunnel route dns homeserver "*.deine-domain.de"

Legt einen CNAME * → <tunnel-id>.cfargotunnel.com an
(Proxy-Status: Proxied/orange, Pflicht). Hostnamen, die nicht in
tunnel.ingress.rules stehen, lösen zwar auf, liefern aber wegen
defaultService: "http_status:404" einen 404 — es wird dadurch nichts
zusätzlich exponiert.

Falls die Domain schon einen *-Record für etwas anderes nutzt (z. B.
Catch-all-E-Mail bei Netcup), kollidiert das — dann stattdessen die
Einzel-Record-Variante unten verwenden, oder eine dedizierte
Subdomain-Ebene wie *.ext.deine-domain.de als Wildcard-Ziel wählen.

Alternative: expliziter Record pro Hostname

Etwas mehr Aufwand pro neuem Dienst, dafür ist in der Cloudflare-DNS-Zone
auf einen Blick sichtbar, welche Hostnamen tatsächlich aktiv geroutet
werden:

cloudflared tunnel route dns homeserver wiki.deine-domain.de
cloudflared tunnel route dns homeserver ntfy.deine-domain.de
cloudflared tunnel route dns homeserver support.deine-domain.de

Bei dieser Variante muss der DNS-Schritt bei jedem neuen freigegebenen
Dienst wiederholt werden (siehe
capulus-core/e-externe-erreichbarkeit/e0010-cloudflare-deploy.md → Neuen Dienst freigeben).

Beide Varianten lassen sich auch manuell im Dashboard unter
DNS → Records anlegen/prüfen.


Schritt 5 — values.yaml befüllen

argocd/apps/tech/cloudflared/values.yaml öffnen und ausfüllen:

tunnel:
  name: homeserver
  id: "a1b2c3d4-...."               # aus Schritt 2
  credentialsSecretName: cloudflared-credentials
  encryptedCredentialsJson: "AgB...=="   # aus Schritt 3

  # Zeigt NICHT mehr direkt auf einzelne App-Services, sondern auf Traefik —
  # EINE Wildcard-Regel für die ganze Zone deckt alle aktuellen und
  # künftigen Apps ab, unabhängig vom Tier (cloudflared kann nur "*" als
  # komplettes Label matchen, keine Tier-spezifischen Muster wie
  # "*.tech.deine-domain.de" — Details/Begründung: capulus-core/c-netzwerk-dns/c0040-domain-tiers.md).
  #
  # HTTPS (443), nicht Klartext-Port 80: seit dem früheren SSO-Rollout
  # (Authelia, später Authentik) werden Session-Cookies über eine als "unsicher" gemeldete Verbindung
  # abgelehnt — auf Port 80 setzte Traefik X-Forwarded-Proto: http, obwohl
  # TLS längst an der Cloudflare-Edge terminiert war (401 statt Redirect für
  # jeden extern exponierten, SSO-geschützten Host).
  # Das interne Zertifikat kommt von der privaten Homeserver-CA. cloudflared
  # prüft es mit dieser CA (caPool, als Datei aus der ConfigMap des Charts)
  # gegen einen Namen aus der SAN-Liste (originServerName), siehe
  # capulus-core/6-hintergruende/60040-helm-charts-tech.md, Abschnitt cloudflared.
  ingress:
    rules:
      - hostname: "*.deine-domain.de"
        service: https://traefik.kube-system.svc.cluster.local:443
        originRequest:
          caPool: /etc/cloudflared/origin-ca.pem
          originServerName: homeserver
    defaultService: "http_status:404"

Mit der Wildcard-DNS-Route aus Schritt 4 und der Wildcard-Ingress-Regel
oben ist diese Datei ab jetzt fertig — ein neuer Dienst braucht hier
keine weitere Zeile mehr. Freigeben passiert stattdessen direkt in
der values.yaml des jeweiligen Dienstes: dort in ingress.hosts einen
zusätzlichen Eintrag mit dem externen Hostnamen
(<app>-<tier>.deine-domain.de — Bindestrich, nicht Punkt, siehe
capulus-core/c-netzwerk-dns/c0040-domain-tiers.md) neben dem internen <app>.<tier>.homeserver-Host ergänzen —
Traefik matcht dann automatisch anhand des Host-Headers, ganz ohne
Umweg über diese Datei. Siehe
capulus-core/e-externe-erreichbarkeit/e0010-cloudflare-deploy.md → Neuen Dienst freigeben.

Danach committen und pushen (siehe
capulus-core/e-externe-erreichbarkeit/e0010-cloudflare-deploy.md für den vollen
Rollout- und Verifikations-Ablauf).


Zusätzliche Absicherung: Cloudflare Access

Ein Cloudflare Tunnel macht einen Dienst öffentlich erreichbar — er
ersetzt aber keine Authentifizierung. Zwei Optionen, oft kombiniert:

Option A — Dienst hat bereits einen eigenen Login davor (z. B.
App-eigene Auth wie bei Zammad/Vaultwarden): Cloudflare Tunnel liefert nur
den Transport, der App-eigene Login bleibt die Zugriffskontrolle. Für
interne Admin-artige Dienste reicht das nicht als alleiniger Schutz
für eine öffentliche Freigabe (siehe nächster Abschnitt, welche Dienste
besser gar nicht exponiert werden).

Option B — Cloudflare Access davorschalten (Zero Trust, im Free-Plan
für bis zu 50 Nutzer kostenlos):

  1. Zero Trust Dashboard → Access →
    Applications → Add an application → Self-hosted
    .
  2. Domain/Hostname eintragen (z. B. support.deine-domain.de).
  3. Policy definieren, z. B. "Allow" für eine Liste von E-Mail-Adressen
    (One-Time-PIN per Mail, kein Passwort/Client nötig) oder eine
    E-Mail-Domain (*@dlrg-andernach.de).
  4. Speichern — Cloudflare zeigt jetzt vor dem eigentlichen Dienst eine
    Login-Seite; erst nach erfolgreicher Policy-Prüfung leitet Cloudflare
    zum Tunnel-Ziel weiter.

Für Dienste mit echten externen Nutzern (z. B. Zammad-Ticket-Erstellung
durch DLRG-Mitglieder ohne Cluster-Zugriff) ist Option B die richtige
Wahl. Für Dienste, die nur du selbst von unterwegs brauchst (z. B.
Grafana, das nur den eigenen lokalen Grafana-Login hat), reicht eine
Access-Policy auf deine eigene E-Mail-Adresse als zusätzliche Absicherung.

Konkret: Access-Policy für Grafana anlegen

Grafana (grafana-tech.pkr-lab.de) hat nur den lokalen Grafana-Login und
ist über den Tunnel öffentlich erreichbar — ohne Access-Policy schützt nur
noch das lokale Grafana-Passwort die Cluster-/Infra-Metriken. Empfohlenes
Setup:

  1. Zero Trust Dashboard → Access →
    Applications → Add an application → Self-hosted
    .
  2. Application domain: grafana-tech.pkr-lab.de (kompletter Hostname, kein
    Pfad-Suffix nötig — die Policy greift dann für die ganze App).
  3. Session Duration: z. B. 24h — danach muss die Cloudflare-Login-Seite
    erneut durchlaufen werden, auch wenn die Grafana-Session selbst länger
    gilt.
  4. Identity provider: Standard reicht One-Time PIN (Cloudflare
    verschickt einen Code per E-Mail, kein zusätzlicher Account nötig).
  5. Policy anlegen:
    • Name: z. B. grafana-only-me
    • Action: Allow
    • Include: Emails → deine eigene Adresse
      (die, mit der du dich bei Cloudflare anmeldest)
  6. Speichern. Ab jetzt zeigt Cloudflare vor dem Grafana-Login-Screen
    erst die Access-Seite — ein Angreifer muss also sowohl den
    One-Time-PIN-Check als auch das Grafana-Passwort umgehen.

Testen:

# Ohne gültige Access-Session sollte Cloudflare die Login-Seite zeigen,
# nicht direkt Grafana:
curl -sI https://grafana-tech.pkr-lab.de | head -1
# Im Browser: Inkognito-Fenster öffnen → grafana-tech.pkr-lab.de →
# es muss zuerst die Cloudflare-Access-Seite kommen, nicht der
# Grafana-Login.

Diese Policy lebt ausschließlich im Cloudflare-Zero-Trust-Dashboard —
es gibt dafür keine Repräsentation in diesem Repo (kein Terraform o. Ä.
für Cloudflare Access im Einsatz). Bei einem Cloudflare-Account-Wechsel
oder Reset muss sie manuell neu angelegt werden.


Welche Dienste eignen sich zur Freigabe?

Dienst Empfehlung Begründung
Wiki.js Freigeben SOPs, Alarm-/Ausrückeordnung, Checklisten — genau die Inhalte, die im Wachdienst unterwegs, ohne VPN gebraucht werden. Reiner Lesezugriff für die meisten Nutzer, geringes Risiko. Mit Cloudflare Access (Option B) auf DLRG-Mitglieder einschränken.
ntfy Freigeben Push-Benachrichtigungen (z. B. Unwetterwarnung, Alarmmonitor offline) müssen genau dann ankommen, wenn das Handy nicht im Heimnetz/Tailnet hängt. Ohne externe Erreichbarkeit verpuffen Alerts im Ernstfall.
Zammad Freigeben (mit Access-Policy) Sinnvoll, wenn Tickets/Support-Anfragen auch von Leuten ohne VPN-Zugang reinkommen sollen. Cloudflare Access oder mindestens ein Rate-Limit vorschalten, da das Formular öffentlich erreichbar ist.
Grafana Optional Praktisch, um Pegel-/Wetter-Dashboards unterwegs zu checken. Login läuft über den lokalen Grafana-Account (kein SSO). Zusätzlich mit Cloudflare-Access-Policy auf den eigenen Account freigeben — sonst sind Cluster-/Infra-Metriken hinter nur einem Passwort öffentlich erreichbar.
Immich Freigeben Kernanwendungsfall ist automatisches Foto-Backup vom Handy — ohne externe Erreichbarkeit synct die App nur im WLAN. Absicherung über den eigenen Immich-Login (E-Mail + Passwort, optional 2FA).
Nextcloud Freigeben Datei-Sync/Kalender/Kontakte sind für Mobile-/Desktop-Clients unterwegs gedacht. Eigener Login schützt den Zugriff, siehe capulus-core/3-apps-workloads/300b0-nextcloud.md.
ArgoCD Nicht freigeben Voller GitOps-Controller-Zugriff auf den Cluster. Bleibt Tailscale-only.
Semaphore Nicht freigeben Kann Ansible-Playbooks mit Root-Rechten auf beiden Servern ausführen. Bleibt Tailscale-only.
Headlamp Nicht freigeben Kubernetes-Admin-Dashboard, voller Cluster-Zugriff. Bleibt Tailscale-only.
kubeseal-webgui Nicht freigeben Secret-Verschlüsselungs-UI — reines Admin-Werkzeug ohne externen Bedarf.
Argo Workflows Nicht freigeben Interne CI/CD-Pipeline, kein externer Nutzerkreis.
ArgoCD/k3s-API/SSH Nicht freigeben Infrastruktur-Ports gehören grundsätzlich nicht ins öffentliche Internet, auch nicht per Tunnel.

Faustregel: Alles mit Admin-/Infrastruktur-Charakter bleibt
Tailscale-only. Alles mit einem echten externen Nutzerkreis (Familie,
Vereinsmitglieder, Kunden) ist ein Kandidat für den Tunnel
— idealerweise
mit einer Cloudflare-Access-Policy davor.


Sicherheitsprinzipien


Troubleshooting

Tunnel-Status prüfen (lokal, vor dem Deployment):

cloudflared tunnel info homeserver
cloudflared tunnel list

Pod läuft nicht / CrashLoopBackOff:

kubectl -n cloudflared get pods
kubectl -n cloudflared logs deploy/cloudflared

Häufigste Ursache: encryptedCredentialsJson falsch versiegelt (falscher
Namespace/Name beim kubeseal-Aufruf) oder tunnel.id stimmt nicht mit
der ID in der credentials.json überein.

502/503 vom öffentlichen Hostnamen:

Meist ein falsches service:-Ziel in tunnel.ingress.rules — Service-Name
und Port mit kubectl -n <namespace> get svc gegenprüfen.

DNS löst nicht auf:

dig wiki.deine-domain.de
# Sollte auf eine Cloudflare-IP (Proxied) zeigen, nicht auf die Heim-IP.

# Bei Wildcard-Setup zusätzlich den Record selbst prüfen:
dig +short CNAME wiki.deine-domain.de
# Sollte über den *-Record auf <tunnel-id>.cfargotunnel.com auflösen.

Nameserver zeigen noch auf Netcup (nach Schritt 1):

dig +short NS deine-domain.de

Solange hier ns*.netcup.net erscheint statt der Cloudflare-Nameserver,
ist die Umstellung im Netcup CCP entweder noch nicht gespeichert oder
noch nicht propagiert (siehe capulus-core/e-externe-erreichbarkeit/e0000-cloudflare-tunnel.md, Schritt 1.3).

Weitere Rollout- und Betriebsschritte:
capulus-core/e-externe-erreichbarkeit/e0010-cloudflare-deploy.md.