Saltar al contenido

Túnel de Cloudflare

Tu dominio con HTTPS sin abrir ningún puerto, con un túnel de Cloudflare.

Con un túnel de Cloudflare, un pequeño conector (cloudflared) abre desde tu equipo una conexión de salida hacia Cloudflare, y Cloudflare sirve tu dominio con HTTPS a través de ella. No abres puertos ni necesitas IP pública: funciona en casa, con CG-NAT o con el router del operador.

Necesitas una cuenta de Cloudflare (el plan gratuito sirve) y tu dominio gestionado por Cloudflare.

Crear el túnel

  1. En Cloudflare, Zero Trust → Networks → Tunnels → Create a tunnel, de tipo Cloudflared. Ponle un nombre, por ejemplo kumoyami.
  2. Copia el token: la cadena larga que va tras --token en las instrucciones.
  3. En Public hostnames, añade dos entradas, las dos con el servicio HTTP y la URL web:4890:
    • nube.example.com: Archivos.
    • app.example.com: la Biblioteca.

Cloudflare crea solo los registros DNS.

Con el instalador

curl -fsSL https://kumoyami.com/install.sh | sudo bash

En Acceso desde fuera de casa, elige Túnel de Cloudflare, pega el token y escribe tu dominio. Sin preguntas:

curl -fsSL https://kumoyami.com/install.sh | sudo KUMOYAMI_TUNNEL_TOKEN='eyJ…' bash -s -- --yes \
  --access cloudflare --domain nube.example.com

El instalador añade el servicio cloudflared, pone en el .env lo que hace falta y, al terminar, te recuerda qué hostnames crear en Cloudflare.

A mano

En el .env:

.env
CLOUDFLARE_TUNNEL_TOKEN=eyJhIjoi…
CF_CONNECTING_IP_FROM=cloudflared

Descomenta el servicio cloudflared del docker-compose.yml (o añádelo en un docker-compose.override.yml):

docker-compose.override.yml
services:
  cloudflared:
    image: cloudflare/cloudflared:latest
    restart: unless-stopped
    command: tunnel --no-autoupdate run
    environment:
      TUNNEL_TOKEN: ${CLOUDFLARE_TUNNEL_TOKEN}
    depends_on:
      - web

Y arranca:

docker compose up -d

En Cloudflare, el túnel debería salir como conectado. Por último, en el panel, Sistema → Módulos: la dirección https://app.example.com en la Biblioteca y https://nube.example.com en Archivos. Las dos llegan al 4890 y KumoYami sirve el módulo de cada una.

Si cloudflared ya está instalado en el equipo

Si usas cloudflared como servicio del sistema (no en Docker), la URL de los hostnames es http://localhost:4890.

A tener en cuenta

  • La IP de cada visitante: CF_CONNECTING_IP_FROM=cloudflared hace que KumoYami crea la cabecera con la IP real solo cuando llega del contenedor cloudflared. De cualquier otro sitio se ignora, porque cualquiera podría escribirla.
  • Desde casa por el túnel: tus dispositivos llegan con la IP pública de casa, así que la Biblioteca los ve «fuera de casa». Añade tu IP pública a las redes de casa (Biblioteca → Reproducción → Fuera de casa y descargas (pestaña «Fuera de casa»)) o usa en casa la dirección local.
  • Subidas grandes: las subidas de la web van en trozos de 8 MB y pasan sin problema. La unidad de red (WebDAV) sube cada archivo de una vez, y Cloudflare corta las peticiones de más de 100 MB en el plan gratuito.
  • Mucho vídeo: las condiciones de Cloudflare limitan servir mucho vídeo por su red. Para un uso intenso, mejor abrir el 443 con Caddy.

Todas las marcas y logotipos pertenecen a sus respectivos propietarios. Su uso solo indica compatibilidad, no patrocinio ni asociación. El logotipo de Synology es una marca de Synology Inc.; Google Drive, Google Cast y Android son marcas de Google LLC, y el robot de Android es obra de Google, compartida con la licencia Creative Commons Reconocimiento 3.0. Microsoft, Windows y OneDrive son marcas de Microsoft; Amazon S3, de Amazon.com, Inc. o sus filiales; Apple, AirPlay, macOS e iPhone, de Apple Inc.; Raspberry Pi, de Raspberry Pi Ltd; Ubuntu, de Canonical Ltd.; Debian, de Software in the Public Interest, Inc.; Linux, de Linus Torvalds. Este producto usa la API de TMDB, pero TMDB no lo respalda ni certifica.