Synology (DSM)
Tu dominio delante de KumoYami en DSM 7.2, con el DDNS, el certificado de Let's Encrypt y el proxy inverso de DSM.
DSM trae todo lo que hace falta: DDNS, certificados de Let's Encrypt y un proxy inverso. No necesitas Caddy ni Nginx. Vale igual para el paquete nativo y para Container Manager.
Los menús van con el nombre que muestra DSM en español y, entre paréntesis, en inglés. En el ejemplo, la Biblioteca va
en app.tudominio.com y Archivos en drive.tudominio.com.
Si tu operador no deja abrir puertos
Con CG-NAT o un router del operador cerrado, este camino no funciona: usa un túnel de Cloudflare o Tailscale.
Un nombre para tu NAS
En el panel de tu proveedor de DNS, crea dos registros tipo A con la IP pública de tu casa: app y drive. La IP
pública sale en ifconfig.me o en tu router.
Si esa IP cambia, apunta los dos registros con un CNAME a un nombre de DDNS (el de Synology, en la otra pestaña), que
se actualiza solo.
Abre el 443 en el router
En el router, en reenvío de puertos (port forwarding, NAT o servidor virtual, según la marca), lleva el puerto 443 TCP a la IP local del NAS, al 443. Con tu propio dominio, lleva también el 80: Let's Encrypt lo usa para comprobar que el dominio es tuyo, al pedir el certificado y cada vez que DSM lo renueva.
- Dale al NAS una IP fija en el router (reserva DHCP), para que la regla no se quede apuntando a otro equipo.
- Si tienes activado el cortafuegos de DSM (Panel de control → Seguridad → Cortafuegos), permite el 443 y el 80.
- No abras el 4890, el 4891 ni el 4892, ni los de DSM (5000 y 5001).
Pide el certificado
Panel de control → Seguridad → Certificado → Añadir (Control Panel → Security → Certificate → Add):
- Añadir un certificado nuevo y Obtener un certificado de Let's Encrypt (Get a certificate from Let's Encrypt).
- Nombre de dominio:
drive.tudominio.com. Correo electrónico: el tuyo. - Nombre alternativo del asunto (Subject Alternative Name):
app.tudominio.com. Así un certificado cubre las dos direcciones.
Con el DDNS de Synology, si DSM ofrece un certificado comodín (*.tunombre.synology.me), cubre todos los subdominios.
Crea la regla de proxy inverso
Panel de control → Portal de inicio de sesión → Avanzado → Proxy inverso → Crear (Control Panel → Login Portal → Advanced → Reverse Proxy → Create).
En Configuración general (General), ponle un nombre que reconozcas, como KumoYami Archivos, y:
- Origen (Source): protocolo
HTTPS, nombre de hostdrive.tudominio.com, puerto443. - Destino (Destination): protocolo
HTTP, nombre de hostlocalhost, puerto4890.
En Encabezado personalizado (Custom Header), pulsa Crear → WebSocket. DSM añade dos cabeceras, Upgrade y
Connection: sin ellas, KumoYami da errores de conexión.
Guarda y crea otra regla igual para app.tudominio.com, también hacia localhost:4890. Una regla por cada
dirección: las dos van al mismo puerto, y KumoYami sabe qué módulo servir por el nombre.
Asigna el certificado a cada regla
Panel de control → Seguridad → Certificado → Configuración (Settings). En la lista salen los servicios de DSM y una
línea por cada regla del proxy inverso: en drive.tudominio.com y en app.tudominio.com, elige el certificado del
paso 3 y pulsa Aceptar.
Guarda las direcciones en KumoYami
Abre el panel, http://IP-DEL-NAS:4890/admin. En Sistema → Módulos, escribe la dirección de cada módulo:
https://app.tudominio.com en la Biblioteca y https://drive.tudominio.com en Archivos. Guarda las dos.
Desde los datos móviles del teléfono, abre https://drive.tudominio.com: debe verse Archivos, con el candado.
En casa, sin dominio
En tu red, cada parte tiene su puerto, sin pasar por el proxy:
http://IP-DEL-NAS:4890: el lanzador y el panel (/admin).http://IP-DEL-NAS:4891: la Biblioteca.http://IP-DEL-NAS:4892: Archivos.
Con el paquete nativo, los tres ya están abiertos. Con Container Manager, publica los tres en el docker-compose.yml
del proyecto: detén el proyecto, cambia la línea ports en su configuración YAML y vuelve a ponerlo en marcha (o, por
SSH, sudo docker compose up -d en su carpeta):
ports:
- "4890-4892:4890-4892"Si tienes el cortafuegos de DSM activado, permite el 4890, el 4891 y el 4892 desde tu red local. El paquete nativo ya declara los tres en DSM: al crear la regla, elige Seleccionar de una lista de aplicaciones integradas y marca KumoYami Server. Con Container Manager, escribe los puertos a mano.
Si algo falla
502 Bad Gateway
DSM no llega a KumoYami. Comprueba que está en marcha (Centro de paquetes → KumoYami Server, o el proyecto en
Container Manager) y que el destino de la regla es HTTP, localhost, 4890. Con Container Manager, el
docker-compose.yml tiene que publicar el 4890.
Errores de WebSocket o «conexión perdida»
Falta el encabezado WebSocket en la regla. Proxy inverso → la regla → Editar → Encabezado personalizado → Crear → WebSocket, en cada una de las dos reglas.
Error de certificado
- El navegador avisa de que la conexión no es privada: el certificado no está asignado a la regla (DSM sirve el de por defecto) o no incluye ese nombre. Revisa Seguridad → Certificado → Configuración.
- Let's Encrypt no emite el certificado: el DNS aún no apunta a tu IP o el puerto 80 no llega al NAS. Comprueba la regla del router y el cortafuegos de DSM, y espera unos minutos a que el DNS se propague.
Sale el lanzador, el otro módulo o «nada publicado»
- Archivos en la dirección de la Biblioteca: una dirección sin guardar muestra Archivos. Guarda la de la
Biblioteca en Sistema → Módulos, exactamente como la del navegador (con
https://, sinwwwde más y sin barra final). - El lanzador: entras por la IP del NAS, por su nombre en tu red o por una dirección con puerto (
:4890) que no está guardada. - «Nada publicado»: ese módulo está apagado en Sistema → Módulos.
Todos los casos, en Cómo elige KumoYami el módulo.
Desde fuera funciona y desde casa no
Muchos routers no dejan entrar en tu dominio desde dentro de tu propia red (NAT loopback). En casa, usa
http://IP-DEL-NAS:4891 y :4892, o crea en tu red un DNS local que dé la IP del NAS para tus dos nombres.
Siguientes pasos
- Dominio propio: los tres puertos y cómo elige KumoYami el módulo.
- El código de servidor: tus cuentas llegan con un código corto.
- Synology: instalar, actualizar y pasar del paquete a Container Manager.
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.