Servidor o VPS Linux
La forma recomendada de alojar KumoYami, con el instalador, a mano o con el paquete .deb.
Un servidor o VPS con Linux es donde KumoYami funciona mejor: siempre encendido, con una IP pública para el dominio y
sin capas intermedias. Sirve cualquier distribución con Docker: Debian, Ubuntu, Rocky Linux, AlmaLinux, Fedora… Y en Debian y Ubuntu, también
un paquete .deb que no necesita Docker.
Compatible con ARM
Desde la versión 0.1.3, la imagen de KumoYami es multiplataforma (amd64 y arm64): Docker descarga sola la variante de tu equipo, sin cambiar nada en el docker-compose.yml. Hace falta un sistema de 64 bits; los ARM de 32 bits no sirven.
Elegir el servidor
- Memoria: 1 GB de RAM como mínimo, 2 GB recomendados. Si vas a activar el antivirus de las subidas (ClamAV), cuenta con 4 GB: ClamAV usa por sí solo alrededor de 1,5 GB.
- Disco: 5 GB libres para Docker y la imagen, más lo que ocupen las carpetas locales que publiques. Lo que está en OneDrive u otras nubes no ocupa espacio en el servidor.
- Red: salida a internet por HTTPS (para el registro y la licencia) y, si vas a usar un dominio, los puertos 80 y 443 abiertos hacia el servidor.
Con el instalador
Es lo más rápido: un comando que instala Docker, prepara los archivos y pone HTTPS con Caddy. Sigue la instalación rápida.
curl -fsSL https://kumoyami.com/install.sh | sudo bashA mano
Si prefieres ver cada paso, o ya tienes Docker y un proxy inverso funcionando, sigue Docker Compose a mano. El resultado es el mismo que con el instalador.
Sin Docker: el paquete .deb o el .tar.gz
En Debian 12, Ubuntu 22.04 o posterior, con un procesador Intel o AMD de 64 bits (x86_64), un paquete instala KumoYami directamente en el sistema, sin Docker, con su propio Node.js, ffmpeg y los controladores de la GPU. Descárgalo en Descargas e instálalo desde su carpeta:
sudo apt install ./kumoyami_X.Y.Z_amd64.debEl paquete crea el usuario de sistema kumoyami y el servicio kumoyami de systemd, que arranca enseguida y en cada
inicio. KumoYami queda en http://IP-DEL-SERVIDOR:4890 (el lanzador y el panel), con la Biblioteca en :4891 y
Archivos en :4892, y el código que pide el asistente
está en el registro del servicio:
sudo journalctl -u kumoyami | grep -i código- Ajustes: en
/etc/default/kumoyami(el puerto, la dirección en la que escucha, la zona horaria). Trae soloPORT=4890, pero el servicio lee el archivo entero: los puertos de los módulos se cambian añadiendoKUMOYAMI_LIBRARY_PORT=4891yKUMOYAMI_FILES_PORT=4892(0deja el módulo sin puerto propio). Después de cambiarlos,sudo systemctl restart kumoyami. - Cortafuegos: el paquete no lo toca. Con
ufwactivado, abre los tres puertos solo a tu red local (cambia la red por la tuya):sudo ufw allow from 192.168.1.0/24 to any port 4890:4892 proto tcp. - Datos: en
/var/lib/kumoyami. El usuariokumoyaminecesita permiso de lectura en las carpetas que publiques. - Actualizar: instala el
.debnuevo de la misma forma.sudo apt remove kumoyamilo desinstala y conserva los datos;sudo apt purge kumoyamilos borra también.
En otras distribuciones (con glibc 2.28 o posterior), el .tar.gz trae lo mismo. Descomprímelo en /opt y arráncalo
en primer plano, con los datos en ~/.local/share/kumoyami; para dejarlo como servicio de systemd, sigue el
README.md que trae, junto a kumoyami.service:
sudo tar -xzf kumoyami-X.Y.Z-linux-x64.tar.gz -C /opt
/opt/kumoyami/kumoyami-serverSin Docker no hay Caddy: KumoYami escucha en los puertos 4890, 4891 y 4892 de todas las direcciones del equipo. Para
tu dominio con HTTPS, ponle delante un proxy inverso y pon HOSTNAME=127.0.0.1 en
/etc/default/kumoyami, para que ninguno de los tres quede abierto hacia fuera.
Cortafuegos
Con Docker, KumoYami escucha solo en 127.0.0.1 (4890, 4891 y 4892), así que esos puertos nunca deben abrirse hacia
fuera: el tráfico entra por el proxy inverso. Abre únicamente los puertos del proxy. Por ejemplo, con ufw:
sudo ufw allow 22/tcp # SSH, para no quedarte fuera
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enableSi tu proveedor tiene un cortafuegos en su panel (grupos de seguridad, firewall de red…), abre ahí también el 80 y el 443. Con un túnel de Cloudflare no hace falta abrir ninguno.
Docker y ufw
Docker publica los puertos de los contenedores saltándose las reglas de ufw. Por eso el docker-compose.yml de
KumoYami publica el 4890, el 4891 y el 4892 solo en 127.0.0.1: no quites el 127.0.0.1: en un servidor con IP
pública.
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.