Saltar al contenido

Docker y Linux

Caddy o Nginx delante de KumoYami en un servidor Linux o con Docker, con las dos direcciones y un certificado de Let's Encrypt.

En un servidor Linux, un VPS o cualquier equipo con Docker, pon un proxy inverso delante del puerto 4890. Aquí están los dos más comunes, Caddy y Nginx, con las dos direcciones del ejemplo: la Biblioteca en app.example.com y Archivos en drive.example.com.

Antes, crea los dos registros DNS (tipo A con la IP pública del servidor) y abre el 80 y el 443 hacia él.

Si instalaste con install.sh

El instalador configura Caddy por ti con --domain y --library-domain: mira Caddy. Esta página es para hacerlo a mano o con tu propio proxy.

Publica los tres puertos

En el docker-compose.yml, el servicio web publica el lanzador y el panel (4890), la Biblioteca (4891) y Archivos (4892). El de kumoyami.com/install ya trae los tres, solo en el propio equipo:

docker-compose.yml
services:
  web:
    # … (imagen, volúmenes y el resto, como estaban)
    ports:
      - "127.0.0.1:${KUMOYAMI_PORT:-4890}:4890"
      - "127.0.0.1:4891:4891"
      - "127.0.0.1:4892:4892"

Si tu archivo es anterior y solo tiene la línea del 4890, añade las otras dos y aplica el cambio:

sudo docker compose up -d
  • En un servidor con IP pública, déjalos así, con 127.0.0.1: delante, y entra por el proxy. Docker publica los puertos saltándose las reglas de ufw: lo que publiques sin 127.0.0.1: queda abierto a internet aunque ufw diga lo contrario.
  • En casa, quita 127.0.0.1: de las tres líneas (o pon "4890-4892:4890-4892"): en tu red, la Biblioteca está en http://IP-DEL-EQUIPO:4891 y Archivos en :4892.
  • Si un puerto está ocupado, usa otro a los dos lados, con su variable en el .env: KUMOYAMI_LIBRARY_PORT=5891 y "127.0.0.1:5891:5891". El lanzador enlaza a cada módulo por su puerto, así que el de fuera y el de dentro tienen que coincidir.

Sin Docker: el paquete .deb

Con el paquete .deb, los tres puertos se abren solos, en todas las direcciones del equipo. /etc/default/kumoyami solo trae PORT=4890 (y HOSTNAME), pero el servicio lee el archivo entero: añade ahí los de los módulos si quieres cambiarlos (0 deja el módulo sin puerto propio):

/etc/default/kumoyami
PORT=4890
# HOSTNAME=127.0.0.1 deja los tres puertos solo en el propio equipo, detrás del proxy
HOSTNAME=0.0.0.0
KUMOYAMI_LIBRARY_PORT=4891
KUMOYAMI_FILES_PORT=4892

Y reinicia con sudo systemctl restart kumoyami. El paquete no toca el cortafuegos: con ufw activado, abre los tres puertos solo a tu red local (cambia la red por la tuya), o no los abras si entras por el proxy:

sudo ufw allow from 192.168.1.0/24 to any port 4890:4892 proto tcp

El proxy apunta siempre al 4890, también para la Biblioteca y Archivos: KumoYami elige el módulo por el nombre con el que llega la petición (cómo lo elige).

Caddy

Caddy pide y renueva solo los certificados, pasa el nombre original, los WebSockets y las cabeceras X-Forwarded-* sin que se lo digas. Con Caddy instalado en el servidor, añade a tu Caddyfile:

/etc/caddy/Caddyfile
app.example.com, drive.example.com {
	reverse_proxy 127.0.0.1:4890
}

Y recarga:

sudo systemctl reload caddy

Si Caddy va en un contenedor del mismo docker-compose.yml, el destino es web:4890. No hace falta nada más, tampoco para subir archivos grandes ni para la unidad de red (WebDAV).

Nginx

Con Nginx hay que decirle todo: el nombre original (Host), los WebSockets (Upgrade y Connection), la IP y el protocolo de quien visita (X-Forwarded-*) y que acepte subidas grandes.

Crea el sitio

/etc/nginx/sites-available/kumoyami
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 80;
    server_name app.example.com drive.example.com;

    # Subidas de cualquier tamaño, también para la unidad de red (WebDAV)
    client_max_body_size 0;
    proxy_request_buffering off;

    location / {
        proxy_pass http://127.0.0.1:4890;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host $host;
        proxy_read_timeout 1h;
    }
}

Actívalo y comprueba la configuración:

sudo ln -s /etc/nginx/sites-available/kumoyami /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

En distribuciones sin sites-available (Rocky, Alma, Fedora), guarda el archivo en /etc/nginx/conf.d/kumoyami.conf. Si nginx -t dice que $connection_upgrade está duplicada, otro sitio ya tiene ese map: quítalo de este archivo.

Pide el certificado

sudo certbot --nginx -d app.example.com -d drive.example.com

Certbot añade el listen 443 ssl, el certificado de los dos nombres y la redirección de HTTP a HTTPS, y deja programada la renovación. Necesita que el puerto 80 llegue al servidor.

Más detalles, como un location aparte para /webdav/, en Nginx.

Guarda las direcciones

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

Si algo falla

502 Bad Gateway

El proxy no llega a KumoYami. Mira si el contenedor está en marcha (sudo docker compose ps) y si el 4890 está publicado: curl -I http://127.0.0.1:4890 debe responder. Desde otro contenedor, el destino es web:4890, no 127.0.0.1.

Errores de WebSocket o «conexión perdida»

En Nginx faltan proxy_http_version 1.1 y las cabeceras Upgrade y Connection del ejemplo. Caddy no necesita nada.

Error de certificado

Si certbot o Caddy no consiguen el certificado, el DNS aún no apunta al servidor (dig +short app.example.com) o el puerto 80 está cerrado en el cortafuegos o en el del proveedor. Con Caddy, sudo journalctl -u caddy dice el motivo.

«413 Request Entity Too Large»

Nginx corta las peticiones de más de 1 MB por defecto: falta client_max_body_size 0;.

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

  • Archivos en la dirección de la Biblioteca: un dominio sin guardar muestra Archivos. Guarda la dirección de la Biblioteca en Sistema → Módulos, o el proxy no pasa el nombre original: en Nginx, proxy_set_header Host $host.
  • El lanzador: entras por la IP o por una dirección con puerto (:4890, :8443) 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.

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.