Saltar al contenido

Nginx

KumoYami detrás de Nginx, con el certificado de Let's Encrypt de certbot.

Si ya usas Nginx en el servidor, añade un server para KumoYami y pide el certificado con certbot.

Sin Caddy del instalador

Si instalaste con install.sh y le diste un dominio, Caddy ya ocupa los puertos 80 y 443. Vuelve a ejecutar el instalador con --no-caddy antes de pasar a Nginx.

Crea el sitio

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

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

    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_read_timeout 1h;
    }
}

Las dos direcciones, la de la Biblioteca (app.) y la de Archivos, van al 4890: KumoYami elige el módulo por la cabecera Host, cuando las guardas en Sistema → Módulos. Upgrade y Connection dejan pasar los WebSockets, que KumoYami necesita. Si nginx -t dice que $connection_upgrade está duplicada, otro sitio ya tiene ese map: quítalo de este archivo.

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 bloque en /etc/nginx/conf.d/kumoyami.conf.

Pide el certificado

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

Certbot añade el listen 443 ssl, los certificados y la redirección de HTTP a HTTPS, y deja programada la renovación.

Unidad de red (WebDAV) y archivos grandes

Si activas la unidad de red WebDAV en el panel (se sirve en /webdav/), añade dentro del mismo server un bloque que acepte archivos de cualquier tamaño y los pase a KumoYami según llegan:

    location /webdav/ {
        proxy_pass http://127.0.0.1:4890;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        client_max_body_size 0;
        proxy_request_buffering off;
    }

Nginx limita por defecto el tamaño de cada petición a 1 MB. Si al subir archivos desde la web ves un error 413 Request Entity Too Large, sube también client_max_body_size en el location /.

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.