Saltar al contenido

Sin abrir puertos

Tu dominio sin tocar el router, con un túnel de Cloudflare, o tus dispositivos dentro de tu red de Tailscale. Cómo se hace y qué pierdes con cada uno.

Si tu operador usa CG-NAT (no tienes IP pública propia), su router no deja abrir puertos o prefieres no abrirlos, hay dos caminos. Los dos funcionan con un conector que sale desde tu equipo hacia fuera, así que no abres nada:

  • Túnel de Cloudflare: tu dominio, con HTTPS, para cualquiera.
  • Tailscale: tus dispositivos llegan como si estuvieran en casa. Con Funnel, también cualquiera, con un nombre .ts.net.

Qué ganas y qué pierdes

Túnel de CloudflareTailscaleTailscale Funnel
Quién llegaCualquieraSolo tus dispositivos con TailscaleCualquiera
Tu dominioSíNo: el nombre del equipo o .ts.netNo: nombre.tu-red.ts.net
HTTPSSí, el de CloudflareCon tailscale serve; si no, HTTP dentro de un túnel cifradoSí
Quién ve el tráficoCloudflare lo descifra y lo vuelve a cifrarNadie: cifrado de punta a puntaNadie: el HTTPS termina en tu equipo
Límites100 MB por petición en el plan gratuito; sus condiciones limitan servir mucho vídeoNinguno propioSolo los puertos 443, 8443 y 10000; ancho de banda limitado

Para mucho vídeo fuera de casa, lo mejor sigue siendo abrir el 443 con un proxy inverso (Synology o Docker y Linux), si tu conexión lo permite.

Túnel de Cloudflare

Un pequeño conector, cloudflared, abre una conexión de salida hacia Cloudflare, y Cloudflare sirve tus dos direcciones con HTTPS a través de ella. Necesitas una cuenta de Cloudflare (el plan gratuito sirve) y tu dominio gestionado por Cloudflare (sus servidores DNS en tu registrador).

Crea el túnel

En Cloudflare, Zero Trust → Networks → Tunnels → Create a tunnel, de tipo Cloudflared. Ponle un nombre, como kumoyami, e instala el conector con el comando que te da (en Docker, Linux, Windows o macOS).

Las dos direcciones, al 4890

En Public hostnames (en el panel nuevo, Published application routes), añade dos, las dos con el servicio HTTP hacia el 4890:

HostnameService
app.example.comhttp://localhost:4890
drive.example.comhttp://localhost:4890

localhost vale si cloudflared está instalado en el mismo equipo. Si va en un contenedor del mismo docker-compose.yml que KumoYami, usa http://web:4890. Cloudflare crea solo los registros DNS.

Guarda las direcciones

En el panel, Sistema → Módulos: https://app.example.com en la Biblioteca y https://drive.example.com en Archivos.

Si gestionas el túnel con un archivo de configuración en lugar del panel, es lo mismo en ingress, con una regla final para lo demás:

~/.cloudflared/config.yml
tunnel: ID-DEL-TÚNEL
credentials-file: /home/tu-usuario/.cloudflared/ID-DEL-TÚNEL.json

ingress:
  - hostname: app.example.com
    service: http://localhost:4890
  - hostname: drive.example.com
    service: http://localhost:4890
  - service: http_status:404

Y los registros DNS, con cloudflared tunnel route dns kumoyami app.example.com (y lo mismo con drive).

El instalador lo prepara todo con --access cloudflare; con Docker a mano, el servicio cloudflared y la variable CF_CONNECTING_IP_FROM están en Túnel de Cloudflare.

Lo que tienes que saber

  • Subidas grandes. Las subidas desde la web van en trozos de 8 MB y pasan bien. La unidad de red (WebDAV) sube cada archivo de una vez, y Cloudflare corta las peticiones de más de 100 MB en los planes Free y Pro.
  • Vídeo. Las condiciones de Cloudflare no permiten usar su red gratuita sobre todo para servir vídeo: para un uso intenso pueden limitarte. Además, cada vídeo da la vuelta por Cloudflare, con algo más de espera al empezar y al saltar. Para ver películas fuera de casa a menudo, abre el 443 si puedes.
  • Cloudflare ve el tráfico. Descifra el HTTPS en su red para pasártelo por el túnel. Es como funciona su proxy.
  • 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». En casa, usa http://IP-DEL-EQUIPO:4891 y :4892.
  • Los WebSockets pasan por el túnel sin hacer nada (en Network → WebSockets de tu dominio, déjalos activados).

Tailscale

Tailscale une tus dispositivos en una red privada, cifrada, que funciona desde cualquier sitio. Instálalo en el equipo de KumoYami y en tus dispositivos, con la misma cuenta. En un Synology está en el Centro de paquetes; en Linux:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

Como en casa: los puertos 4891 y 4892

Sin configurar nada más, desde cualquier dispositivo de tu red de Tailscale:

  • http://nombre-del-equipo:4891: la Biblioteca.
  • http://nombre-del-equipo:4892: Archivos.
  • http://nombre-del-equipo:4890/admin: el panel.

El nombre del equipo funciona con MagicDNS activado (en DNS, en el panel de Tailscale); si no, usa su IP 100.x.y.z. En Docker, los puertos tienen que estar publicados en todas las interfaces ("4890-4892:4890-4892"): con 127.0.0.1: delante no se llega por Tailscale.

Es lo más sencillo, y el tráfico va cifrado por Tailscale, pero el navegador ve http://: sin HTTPS no hay passkeys, ni instalación como app, ni notificaciones push. Las direcciones de Tailscale cuentan como en casa para la Biblioteca.

Con HTTPS, dentro de tu red: tailscale serve

En el panel de Tailscale, en DNS, activa MagicDNS y HTTPS Certificates. Después, en el equipo, lleva cada puerto HTTPS de Tailscale al puerto de un módulo: el 443 a Archivos (4892) y el 8443 a la Biblioteca (4891):

sudo tailscale serve --bg --https=443 http://localhost:4892
sudo tailscale serve --bg --https=8443 http://localhost:4891

Con un solo nombre, los dos módulos, solo para tus dispositivos:

  • https://nombre-del-equipo.tu-red.ts.net: Archivos.
  • https://nombre-del-equipo.tu-red.ts.net:8443: la Biblioteca.

No hace falta guardar nada: KumoYami reconoce el módulo por el puerto al que llega cada petición. Guarda estas dos direcciones en Sistema → Módulos (la de la Biblioteca con su :8443) solo si quieres que las tarjetas del lanzador y los correos enlacen a los nombres .ts.net. sudo tailscale serve status muestra lo que hay publicado, y sudo tailscale serve reset lo quita todo.

Funciona también si KumoYami va en Docker con los puertos publicados solo en 127.0.0.1, como en su docker-compose.yml: tailscale serve llega a ellos desde el propio equipo. El panel sigue en http://nombre-del-equipo:4890/admin (o en el propio equipo); para tener también el panel con HTTPS, usa el tercer puerto, --https=10000 http://localhost:4890.

El instalador lo hace de otra forma, con dos nodos en contenedores, kumoyami (Archivos) y kumoyami-app (la Biblioteca): mira Tailscale.

Para cualquiera: Funnel

Funnel publica en internet lo mismo que serve, en los mismos puertos:

sudo tailscale funnel --bg --https=443 http://localhost:4892
sudo tailscale funnel --bg --https=8443 http://localhost:4891

En la política de acceso de Tailscale, permite Funnel a ese equipo (nodeAttrs con funnel). Antes de elegirlo:

  • Solo con el nombre .ts.net, nunca con tu dominio.
  • Solo en los puertos 443, 8443 y 10000.
  • Con un ancho de banda limitado, que Tailscale no publica: vale para compartir algo, no para ver películas a menudo.

Si algo falla

502 Bad Gateway o error 1033 de Cloudflare

  • Error 1033: el túnel no está conectado. Mira si cloudflared está en marcha (en Cloudflare, el túnel sale como Healthy).
  • 502: el túnel llega, pero cloudflared no encuentra KumoYami. localhost:4890 solo vale si cloudflared está en el mismo equipo; desde un contenedor, web:4890. Comprueba también que KumoYami está en marcha.

Errores de WebSocket o «conexión perdida»

En Cloudflare, comprueba que Network → WebSockets está activado en tu dominio. Con Tailscale no hace falta nada.

Error de certificado

  • Cloudflare: el certificado lo pone Cloudflare. Si el navegador avisa, el nombre no está en el túnel o su registro DNS no está en modo Proxied (la nube naranja).
  • Tailscale: activa HTTPS Certificates en DNS. La primera visita a un nombre .ts.net puede tardar unos segundos mientras se emite el certificado.

«413» al subir por la unidad de red

Es el límite de 100 MB por petición de Cloudflare. Sube esos archivos desde la web, que va en trozos, o en casa.

Sale el lanzador, el otro módulo o «nada publicado»

  • Con el túnel de Cloudflare, sale Archivos en la dirección de la Biblioteca: un dominio sin guardar muestra Archivos. Guarda la de la Biblioteca en Sistema → Módulos, exactamente como la del navegador.
  • Con tailscale serve, sale el lanzador: ese puerto de Tailscale va al 4890. Llévalo al 4891 o al 4892, como en Con HTTPS, dentro de tu red, o guarda la dirección con su puerto (https://nombre-del-equipo.tu-red.ts.net:8443).
  • «Nada publicado»: ese módulo está apagado en Sistema → Módulos.

Todos los casos, en Cómo elige KumoYami el módulo.

Por Tailscale no carga :4891

En Docker, los puertos están publicados solo en 127.0.0.1: publícalos como "4890-4892:4890-4892". Comprueba también que los dos dispositivos salen conectados en el panel de Tailscale.

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.