Saltar al contenido

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):

  1. Añadir un certificado nuevo y Obtener un certificado de Let's Encrypt (Get a certificate from Let's Encrypt).
  2. Nombre de dominio: drive.tudominio.com. Correo electrónico: el tuyo.
  3. 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 host drive.tudominio.com, puerto 443.
  • Destino (Destination): protocolo HTTP, nombre de host localhost, puerto 4890.

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):

docker-compose.yml
    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://, sin www de 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

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.