Dominio propio
Tu dominio delante de KumoYami, con HTTPS. Qué necesitas, los puertos 4890, 4891 y 4892, qué camino elegir y dónde guardar las direcciones.
Con un dominio propio, la Biblioteca y Archivos tienen cada uno su dirección con HTTPS, por ejemplo
https://app.tudominio.com y https://drive.tudominio.com, y se llega a ellos desde cualquier sitio. Esta página
explica qué necesitas, cómo reparte KumoYami sus puertos, qué camino elegir y cómo decirle qué dirección es de cada
módulo.
Qué necesitas
- Un dominio o un nombre de DDNS. Un dominio tuyo (
tudominio.com) o, si la IP de tu casa cambia, un nombre gratuito de DDNS, como el de Synology (tunombre.synology.me). - Una dirección por módulo. Un registro DNS para cada una:
apppara la Biblioteca ydrivepara Archivos (tipoAcon la IP pública del equipo, oCNAMEa tu dominio). Con un túnel de Cloudflare, los crea Cloudflare. - Una forma de entrar desde fuera: el puerto 443 abierto en el router hacia el equipo (y el 80, para pedir y renovar el certificado de Let's Encrypt), o un túnel, que no abre ninguno.
Algunas cosas dependen del dominio: la URI de redirección de OneDrive en Azure, las passkeys (solo funcionan en el dominio donde se crean) y los enlaces que compartes. Ponlo antes de configurarlas.
Los tres puertos: 4890, 4891 y 4892
KumoYami escucha en tres puertos:
| Puerto | Qué hay | Para qué |
|---|---|---|
| 4890 | El lanzador (una tarjeta para la Biblioteca y otra para Archivos) y el panel, en /admin. | La dirección del servidor. Es el puerto al que apunta el proxy inverso. |
| 4891 | La Biblioteca. | Entrar sin dominio, en casa o por Tailscale: http://IP-DEL-EQUIPO:4891. |
| 4892 | Archivos. | Igual: http://IP-DEL-EQUIPO:4892. |
- Sin dominio, en tu red o por Tailscale, cada módulo está en su puerto.
- Con dominio, el proxy inverso (o el túnel) apunta siempre al 4890, para los dos módulos. KumoYami mira con qué
nombre llega cada petición (la cabecera
Host) y sirve el módulo de esa dirección, en cuanto la guardas en Sistema → Módulos. - En Docker, publica los tres, con el mismo número a los dos lados. El
docker-compose.ymlde KumoYami ya los publica, solo en127.0.0.1; en un NAS de casa,"4890-4892:4890-4892". Mira Docker y Linux. - Los WebSockets tienen que pasar. El proxy debe reenviar las cabeceras
UpgradeyConnection. Caddy, Traefik, el túnel de Cloudflare y Tailscale lo hacen solos; en Nginx, en el proxy inverso de DSM y en Nginx Proxy Manager hay que activarlo.
Los puertos de los módulos se cambian con KUMOYAMI_LIBRARY_PORT (Biblioteca) y KUMOYAMI_FILES_PORT (Archivos); con
0, ese módulo se queda sin puerto propio, y si un puerto está ocupado, KumoYami no lo abre y sigue con los demás. En
Docker, pon la variable en el .env y publica el mismo número a los dos lados ("5891:5891"): el lanzador enlaza a
cada módulo por su puerto.
Cómo elige KumoYami el módulo
Con cada petición, KumoYami decide qué enseñar, en este orden:
- Por el puerto. Lo que llega al 4891 es la Biblioteca y lo que llega al 4892 es Archivos, con cualquier nombre en el navegador.
- Por la dirección guardada. Si el nombre con el que llega (con su puerto, si lo lleva) es uno de los guardados en Sistema → Módulos, sale ese módulo.
- El lanzador, en el 4890, si se entra por la IP, por
localhost, por el nombre del equipo en tu red o por cualquier nombre con un puerto escrito (:4890,:8443…) que no esté guardado. - Un dominio sin guardar y sin puerto, el caso de un proxy en el 443: Archivos si está encendido; si no, la Biblioteca; si no, el lanzador.
Si el módulo que toca está apagado, sale la página «nada publicado». Por la regla 4, un proxy que solo manda
drive.tudominio.com al 4890 ya muestra Archivos antes de guardar nada; la Biblioteca, en su propio dominio, necesita
su dirección guardada (o un proxy que apunte al 4891).
Elige un camino
Synology
El DDNS, el certificado y el proxy inverso de DSM, sin instalar nada más.
Docker y Linux
Caddy o Nginx delante del 4890, con un certificado de Let's Encrypt.
Sin abrir puertos
Un túnel de Cloudflare o Tailscale, con CG-NAT o un router que no deja abrir puertos.
| Camino | Abre puertos | Para quién | Cuándo |
|---|---|---|---|
| Proxy inverso: DSM, Caddy o Nginx | 443 (y 80) | Cualquiera | Lo mejor para el vídeo. Necesita IP pública. |
| Túnel de Cloudflare | Ninguno | Cualquiera | En casa, con CG-NAT o un router que no deja abrir puertos. |
| Tailscale | Ninguno | Tus dispositivos | Solo para ti y tu familia. Con Funnel, para cualquiera. |
Si instalaste con install.sh, el instalador configura Caddy, el
túnel de Cloudflare o Tailscale por ti. Si ya tienes un
proxy para otras webs, ponlo delante: Nginx,
Nginx Proxy Manager o Traefik.
Guarda las direcciones en Módulos
El último paso, sea cual sea el camino:
- Abre el panel:
http://IP-DEL-EQUIPO:4890/admin. - En Sistema → Módulos, escribe la dirección de cada módulo, con
https://y sin nada detrás: en la Biblioteca,https://app.tudominio.com; en Archivos,https://drive.tudominio.com. Guarda las dos. - Abre las dos direcciones: cada una muestra su módulo.
Cada módulo tiene una sola dirección. Si usas solo uno de los dos, guarda solo la suya.
Cuando tu servidor ya se alcanza desde fuera, enciende el código de servidor: tus
cuentas escriben un código corto en kumoyami.com/link y llegan sin saber la dirección.
Por qué 80 y 443 y no el 4890
Podría parecer más fácil abrir el puerto 4890 (o el 4891 y el 4892) en el router y entrar por http://tu-ip:4891. No lo
hagas:
- Sin HTTPS, todo viaja en claro. Contraseñas, códigos de acceso, enlaces y vídeos. Cualquiera en la misma red wifi, o tu operador, puede leerlos.
- Los navegadores lo tratan como inseguro. Las passkeys, la instalación como app, las notificaciones push y la
copia al portapapeles solo funcionan con HTTPS. El código de servidor solo publica direcciones
https://. - El certificado necesita el 80 y el 443. Let's Encrypt comprueba que el dominio es tuyo por el puerto 80 y la web se sirve por el 443, el puerto que todas las redes dejan pasar (hoteles, oficinas, datos móviles). Un puerto raro como el 4891 suele estar bloqueado fuera de casa.
- Un solo puerto, varias direcciones. Detrás del 443, el proxy reparte por nombre: la Biblioteca en
app.tudominio.com, Archivos endrive.tudominio.com, y otras webs que tengas. El 4890, el 4891 y el 4892 siguen cerrados al exterior.
Abre en el router solo el 443 (y el 80). En un servidor con IP pública, publica los puertos de KumoYami solo en
127.0.0.1: desde fuera solo se llega pasando por el HTTPS.
Cloudflare Tunnel y Tailscale no abren nada
Con un túnel no abres ningún puerto, ni el 80 ni el 443: el conector sale hacia Cloudflare o Tailscale, y ellos ponen el certificado. Es la opción si tu operador usa CG-NAT (no tienes IP pública propia).
La IP real de cada visitante
KumoYami usa la IP de quien visita para saber si está en casa o fuera (la calidad de la Biblioteca), los límites de intentos y los avisos de cuentas compartidas. Detrás de un proxy la toma de sus cabeceras, solo si vienen de uno de confianza:
- Caddy o Nginx en el mismo equipo o en la red de Docker: no hay que hacer nada.
- Túnel de Cloudflare:
CF_CONNECTING_IP_FROM=cloudflareden el.env(el instalador lo pone). - Varios proxies en cadena, por ejemplo cloudflared → Caddy → KumoYami:
TRUSTED_PROXIES=caddy,cloudflared(nombres de servicio, IP o redes CIDR).
Si algo falla
502 Bad Gateway
El proxy no llega a KumoYami. O KumoYami no está en marcha (docker compose ps, o el paquete detenido en el Centro de
paquetes), o el proxy apunta a otro puerto. El destino es el 4890: 127.0.0.1:4890 desde el propio equipo, o
web:4890 desde otro contenedor en la misma red de Docker.
Errores de WebSocket o «conexión perdida»
El proxy no deja pasar los WebSockets. Añade las cabeceras Upgrade y Connection: en Nginx, como en
Docker y Linux; en DSM, el encabezado personalizado WebSocket
(Synology); en Nginx Proxy Manager, Websockets Support.
Error de certificado
El navegador avisa de que la conexión no es privada. El certificado no cubre esa dirección (pídelo con los dos nombres) o no está asignado a ella. Si Let's Encrypt no lo emite, el DNS aún no apunta a tu IP o el puerto 80 no llega al equipo.
Sale el lanzador, el otro módulo o «nada publicado»
Es el orden en que KumoYami elige el módulo:
- Sale el lanzador. Entras por la IP, por el nombre del equipo en tu red o por una dirección con un puerto escrito
(
https://app.tu-red.ts.net:8443) que no está guardada. Guárdala en Sistema → Módulos tal cual, con su puerto, o lleva esa dirección al puerto del módulo (4891 o 4892). - Sale Archivos en la dirección de la Biblioteca. Un dominio sin guardar muestra Archivos. Guarda la dirección de
la Biblioteca, exactamente como la escribes en el navegador (con
https://, sinwwwde más y sin barra final). Si ya la guardaste, el proxy no pasa el nombre original en la cabeceraHost(en Nginx,proxy_set_header Host $host). - Sale «nada publicado». El módulo de esa dirección o de ese puerto está apagado: enciéndelo en Sistema → Módulos.
¿Tu instalación usa el puerto 3000?
Las instalaciones hechas antes de pasar al 4890 escuchan en 127.0.0.1:3000. En los ejemplos, usa el puerto de la
tuya: el primer número de la línea ports del docker-compose.yml (o KUMOYAMI_PORT en el .env).
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.