cloudflared (cluster)
Conector de Cloudflare Tunnel dentro del cluster k3s (túnel homelab).
Resumen
cloudflared corre como Deployment en el cluster y conecta con el túnel
Cloudflare homelab, que expone servicios del cluster (Vaultwarden, Homepage y
Authentik) hacia internet sin abrir puertos en el router. Sustituye al patrón
legacy donde cloudflared corría en lebron junto a Nginx Proxy Manager (ver
Legacy cloudflared).
Estado
| Campo |
Valor |
| Estado |
Operativo |
| Argo CD Application |
cloudflared |
| Namespace |
cloudflared |
Despliegue
| Campo |
Valor |
| Método |
manifests planos (imagen oficial) |
| Imagen |
cloudflare/cloudflared:2026.8.3 |
| Origen |
clusters/luka/config/cloudflared/ |
| Config en el repo |
clusters/luka/apps/cloudflared/ |
Red
| Campo |
Valor |
| Service |
— (conexión saliente al edge de Cloudflare) |
| URL |
— |
Acceso y usuarios
- Credenciales: token JWT del túnel en SealedSecret
cloudflared-token.
El túnel y sus reglas de ingress se gestionan con Terraform
(terraform/cloudflare/tunnel.tf).
Configuración
cloudflared tunnel --no-autoupdate run --token $TUNNEL_TOKEN (config remota).
- El túnel
homelab usa hostnames explícitos (no *.gorkarevilla.com); origen
HTTP plano http://traefik.traefik.svc.cluster.local:80.
Almacenamiento
Dependencias
- Depende de: k3s, Traefik (listener
web), Sealed Secrets.
- Usado por: exposición externa de servicios del cluster (Vaultwarden,
Homepage, Authentik).
Backup y recuperación
- Re-desplegable desde Git; el token se re-sella si rota el túnel.
Monitorización
Referencias
- https://github.com/cloudflare/cloudflared
Notas / TODO
- Añadir al túnel
homelab el resto de hostnames (hoy aún en hometunnel/NPM).