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:
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 deufw: lo que publiques sin127.0.0.1:queda abierto a internet aunqueufwdiga 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á enhttp://IP-DEL-EQUIPO:4891y Archivos en:4892. - Si un puerto está ocupado, usa otro a los dos lados, con su variable en el
.env:KUMOYAMI_LIBRARY_PORT=5891y"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):
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=4892Y 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 tcpEl 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:
app.example.com, drive.example.com {
reverse_proxy 127.0.0.1:4890
}Y recarga:
sudo systemctl reload caddySi 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
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 nginxEn 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.comCertbot 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
- Dominio propio: qué hay en cada puerto y qué camino elegir.
- Sin abrir puertos, si el servidor no tiene IP pública.
- Nginx Proxy Manager y Traefik, si ya los usas.
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.