Saltar al contenido

Tailscale

Acceso privado a KumoYami desde tus dispositivos, sin abrir puertos, con HTTPS de Tailscale.

Con Tailscale, KumoYami se une a tu red privada de Tailscale: tus dispositivos con Tailscale llegan a él desde cualquier sitio, con HTTPS y sin abrir puertos. Nadie más lo ve. Con Funnel puedes abrirlo también a internet.

Es la opción para usarlo tú y tu familia. Para compartir con gente que no tiene Tailscale, mejor Caddy o el túnel de Cloudflare.

Con el instalador

Prepara Tailscale

En login.tailscale.com:

  1. DNS: activa MagicDNS y HTTPS Certificates.
  2. Settings → Keys: crea una clave de autenticación reutilizable (KumoYami usa dos nodos: Archivos y la Biblioteca).

Ejecuta el instalador

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

En Acceso desde fuera de casa, elige Tailscale y pega la clave. Sin preguntas:

curl -fsSL https://kumoyami.com/install.sh | sudo KUMOYAMI_TS_AUTHKEY='tskey-auth-…' bash -s -- --yes --access tailscale

Pon las direcciones en el panel

Aparecen en tu red como kumoyami (Archivos) y kumoyami-app (la Biblioteca). En Sistema → Módulos, escribe https://kumoyami-app.<tu-red>.ts.net en la Biblioteca y https://kumoyami.<tu-red>.ts.net en Archivos. El nombre de tu red está en el panel de Tailscale, en DNS.

Los dos nodos mandan su tráfico al 4890, así que hasta que guardes las direcciones, los dos nombres muestran Archivos (un dominio sin guardar muestra Archivos): la Biblioteca aparece en kumoyami-app en cuanto guardas la suya.

Si instalas Tailscale en el propio equipo, en lugar de en estos contenedores, tus dispositivos llegan también, sin HTTPS, al puerto de cada módulo: mira Sin abrir puertos.

A mano

En el .env, la clave:

.env
TS_AUTHKEY=tskey-auth-…

Junto al docker-compose.yml, el archivo tailscale/serve.json:

tailscale/serve.json
{
  "TCP": { "443": { "HTTPS": true } },
  "Web": { "${TS_CERT_DOMAIN}:443": { "Handlers": { "/": { "Proxy": "http://web:4890" } } } },
  "AllowFunnel": { "${TS_CERT_DOMAIN}:443": false }
}

Descomenta los servicios tailscale (Archivos) y tailscale-app (la Biblioteca; quítalo si no la usas) en el docker-compose.yml y arranca:

docker compose up -d

Sin el instalador: Tailscale en el propio equipo

Si Tailscale ya está instalado en el equipo (en un Synology, desde el Centro de paquetes), no hacen falta los contenedores ni dos nodos. Con MagicDNS y HTTPS Certificates activados, un nombre basta para los dos módulos:

sudo tailscale serve --bg --https=443 http://localhost:4892    # Archivos
sudo tailscale serve --bg --https=8443 http://localhost:4891   # la Biblioteca

Archivos queda en https://nombre-del-equipo.<tu-red>.ts.net y la Biblioteca en el mismo nombre con :8443. KumoYami reconoce cada módulo por su puerto, sin guardar nada; guarda las dos direcciones en Sistema → Módulos solo para que el lanzador y los correos enlacen a ellas. Más en Sin abrir puertos.

En casa y fuera de casa

Las direcciones de Tailscale (100.64.0.0/10) cuentan como en casa para la Biblioteca: se ven a la calidad de casa aunque estés de viaje. Si prefieres que cuenten como fuera, quítalas de las redes de casa en Biblioteca → Reproducción → Fuera de casa y descargas (pestaña «Fuera de casa»).

En el código de servidor, estas direcciones salen como «no se llega desde internet». Es lo normal: solo llegan tus dispositivos.

Abrirlo a internet con Funnel

  1. Pon "AllowFunnel" a true en tailscale/serve.json (con el instalador: --funnel). Con Tailscale en el propio equipo, cambia serve por funnel en las dos órdenes de arriba.
  2. En la política de acceso de Tailscale, permite Funnel a esos nodos (nodeAttrs con funnel).
  3. docker compose up -d --force-recreate tailscale tailscale-app.

Funnel tiene su límite de ancho de banda: para mucho vídeo fuera de casa, 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.