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
- Warum Cloudflare Tunnel?
- Voraussetzungen
- Schritt 1 — Domain zu Cloudflare hinzufügen (Netcup-spezifisch)
- Schritt 2 — Tunnel erstellen
- Schritt 3 — Credentials versiegeln
- Schritt 4 — DNS-Routing: Wildcard statt Einzel-Records
- Schritt 5 — values.yaml befüllen
- Zusätzliche Absicherung: Cloudflare Access
- Welche Dienste eignen sich zur Freigabe?
- Sicherheitsprinzipien
- 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)
- Kein Port-Forwarding.
cloudflaredbaut die Verbindung aktiv nach
außen auf (wie ein Client, der eine Webseite lädt). Es muss am Router
nichts freigegeben werden, und die UFW-Firewall bleibt unverändert. - Keine öffentliche IP nötig. Funktioniert auch hinter CGNAT / DS-Lite.
- TLS ist bereits erledigt. Cloudflare terminiert HTTPS an der Edge,
du musst dich nicht um Zertifikate für öffentliche Hostnamen kümmern. - DDoS-Schutz und WAF von Cloudflare liegen automatisch vor jedem
getunnelten Dienst. - Granular. Es wird nur freigegeben, was du explizit in der
Ingress-Liste einträgst — alles andere bleibt ausschließlich über LAN
oder Tailscale erreichbar (siehe Sicherheitsprinzipien).
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
-
Eine eigene Domain, die auf Cloudflare verwaltet wird (Cloudflare
Free-Plan reicht vollständig aus). In diesem Setup liegt die Domain bei
Netcup — sie muss nicht zu Cloudflare transferiert werden, es reicht,
die Nameserver umzustellen (siehe Schritt 1). Der Registrar bleibt
Netcup, nur die DNS-Verwaltung wandert zu Cloudflare. -
Ein kostenloser Cloudflare-Account.
-
cloudflaredCLI lokal auf deiner Workstation:# macOS brew install cloudflared # Linux (Debian/Ubuntu) curl -L --output cloudflared.deb \ https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb sudo dpkg -i cloudflared.deb -
kubesealCLI lokal installiert (bereits Voraussetzung für
capulus-core/3-apps-workloads/30000-zammad.md). -
kubectlmit dem Cluster verbunden (für den DNS-Routing-Schritt reicht
aber die Cloudflare-Anmeldung,kubectlwird nur für kubeseal gebraucht).
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
- Cloudflare-Dashboard → Add a Site.
- Domain eingeben (genau wie bei Netcup registriert, ohne
www.),
Free Plan wählen. - 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. mancheTXT-Einträge).
1.3 — Nameserver bei Netcup umstellen
- Cloudflare zeigt jetzt zwei Nameserver an, z. B.:
bob.ns.cloudflare.com flora.ns.cloudflare.com - Im Netcup CCP einloggen →
Domains → betroffene Domain auswählen → Nameserver ändern. - Die beiden bei Netcup voreingestellten Nameserver
(ns1.netcup.net/ns2.netcup.net/ns3.netcup.net) durch die
beiden Cloudflare-Nameserver ersetzen, speichern. - 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:
- Die Tunnel-ID (UUID, z. B.
a1b2c3d4-...). - Den Pfad zur erzeugten Credentials-Datei, z. B.
~/.cloudflared/a1b2c3d4-....json.
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-Namecloudflared-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.deals 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
dervalues.yamldes jeweiligen Dienstes: dort iningress.hostseinen
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):
- Zero Trust Dashboard → Access →
Applications → Add an application → Self-hosted. - Domain/Hostname eintragen (z. B.
support.deine-domain.de). - 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). - 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:
- Zero Trust Dashboard → Access →
Applications → Add an application → Self-hosted. - Application domain:
grafana-tech.pkr-lab.de(kompletter Hostname, kein
Pfad-Suffix nötig — die Policy greift dann für die ganze App). - Session Duration: z. B.
24h— danach muss die Cloudflare-Login-Seite
erneut durchlaufen werden, auch wenn die Grafana-Session selbst länger
gilt. - Identity provider: Standard reicht One-Time PIN (Cloudflare
verschickt einen Code per E-Mail, kein zusätzlicher Account nötig). - Policy anlegen:
- Name: z. B.
grafana-only-me - Action:
Allow - Include:
Emails→ deine eigene Adresse
(die, mit der du dich bei Cloudflare anmeldest)
- Name: z. B.
- 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
- UFW-Firewall bleibt unverändert.
cloudflaredbraucht keinen
eingehenden Port — es öffnet nur eine ausgehende Verbindung. Die
bestehende Firewall-Tabelle in README.md
bleibt exakt so, wie sie ist. - Opt-in pro Dienst. Es wird nichts automatisch öffentlich — nur
Hostnamen, die explizit intunnel.ingress.rulesstehen, sind über
Cloudflare erreichbar. Alles andere bleibt ausschließlich unter
*.homeserver(LAN/Tailnet). - Secrets bleiben verschlüsselt in Git, wie bei jedem anderen Dienst
in diesem Repo (SealedSecrets). - Least Privilege beim Access: wo möglich Cloudflare Access vorschalten,
statt einen Dienst komplett offen ins Internet zu hängen.
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.