Cómo instalar Pydio Cells en el servidor Ubuntu 24.04

Pydio Cells es una plataforma de Compartición y Colaboración de Documentos autoalojada. También te da control total sobre tu entorno de compartición de documentos. Pydio Cells tiene un rendimiento rápido, maneja tamaños de transferencia de archivos enormes y proporciona automatización avanzada de flujos de trabajo.

En esta guía, te guiaremos a través de la instalación de Pydio Cells en el servidor Ubuntu 24.04 con la base de datos MariaDB y Apache como proxy inverso.

Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor Ubuntu 24.04.
• Un usuario no root con privilegios de administrador.
• Un nombre de dominio apuntando a una dirección IP del servidor.

Instalando dependencias

Antes de instalar Pydio Cells, debes instalar las dependencias en tu sistema Ubuntu. Esto incluye el servidor de base de datos MariaDB y el servidor web Apache.

Primero, ejecuta el siguiente comando apt para actualizar el índice de paquetes de Ubuntu e instalar las dependencias para Pydio Cells. Con este comando, instalarás el servidor web Apache, el servidor de base de datos MariaDB y Certbot para generar certificados SSL/TLS.

sudo apt update
sudo apt install apache2 mariadb-server certbot python3-certbot-apache wget

Ingresa Y para confirmar la instalación.

Después de que la instalación esté completa, verifica el estado del servicio Apache con el siguiente comando:

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Puedes ver a continuación que el servidor web Apache está habilitado y en ejecución.

Ahora verifica el estado del servidor MariaDB con el siguiente comando.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

A continuación, el servidor MariaDB está en ejecución y habilitado.

Configurando el servidor MariaDB

Después de instalar el servidor MariaDB, asegurarás MariaDB con la utilidad mariadb-secure-installation. Luego, crearás una nueva base de datos y un usuario para Pydio Cells.

Para asegurar la instalación del servidor MariaDB, ejecuta el comando mariadb-secure-installation a continuación.

sudo mariadb-secure-installation

Se te preguntará sobre la configuración del servidor MariaDB a continuación:

• ¿Cambiar la autenticación local a unix_socket? Ingresa n.
• Configura la nueva contraseña de root de MariaDB. Ingresa y para confirmar, luego escribe la nueva contraseña para tu implementación del servidor MariaDB.
• ¿Eliminar el usuario anónimo? Ingresa y para confirmar.
• ¿Eliminar la base de datos de prueba por defecto de la implementación? Ingresa y para confirmar.
• ¿Deshabilitar el inicio de sesión de root de MariaDB desde conexiones remotas? Ingresa y para confirmar.
• ¿Recargar privilegios de tabla y aplicar los cambios? Ingresa y y presiona ENTER.

Ahora ejecuta el comando del cliente mariadb a continuación para iniciar sesión en el servidor MariaDB. Ingresa tu contraseña de root cuando se te pida.

sudo mariadb -u root -p

A continuación, ejecuta las siguientes consultas para crear una nueva base de datos cellsdb, un usuario cells, y la contraseña p4ssword. Asegúrate de cambiar los detalles a continuación con tu información.

CREATE DATABASE cellsdb;
CREATE USER cells@localhost IDENTIFIED BY 'cellsp4ssword';
GRANT ALL PRIVILEGES ON cellsdb.* TO cells@localhost;
FLUSH PRIVILEGES;

Ahora ejecuta la consulta a continuación para asegurarte de que el usuario cells@localhost pueda acceder a la base de datos cellsdb.

SHOW GRANTS FOR cells@localhost;

Deberías ver una salida similar a continuación:

Escribe quit para salir del servidor MariaDB.

Instalando Pydio Cells

En esta sección, crearás un nuevo usuario pydio, configurarás variables de entorno, y luego descargarás e instalarás Pydio Cells.

Agrega un nuevo usuario pydio con el siguiente comando:

sudo useradd -m -s /bin/bash pydio

Luego, ejecuta el comando a continuación para crear un nuevo directorio /opt/pydio/bin y /var/cells, y cambiar la propiedad al usuario pydio.

sudo mkdir -p /opt/pydio/bin /var/cells
sudo chown -R pydio: /opt/pydio/bin /var/cells

Ahora ejecuta el siguiente comando para crear el archivo de entorno /etc/profile.d/cells-env.sh y hacerlo ejecutable. Este archivo se ejecutará cuando el usuario inicie sesión.

sudo tee -a /etc/profile.d/cells-env.sh << EOF
export CELLS_WORKING_DIR=/var/cells
export CELLS_BIND=127.0.0.1:8080
export CELLS_EXTERNAL=https://cells.howtoforge.local
EOF
sudo chmod 0755 /etc/profile.d/cells-env.sh

A continuación, inicia sesión como usuario pydio y verifica las variables de entorno $CELLS_WORKING_DIR, $CELLS_BIND, y $CELLS_EXTERNAL. Asegúrate de que cada una apunte al valor correcto como en el archivo /etc/profile.d/cells-env.sh.

su - pydio

echo $CELLS_WORKING_DIR
echo $CELLS_BIND
echo $CELLS_EXTERNAL

Ahora ejecuta el comando a continuación para descargar el archivo binario de Pydio en /opt/pydio/bin/cells.

export distribId=cells
wget -O /opt/pydio/bin/cells https://download.pydio.com/latest/

Haz que el archivo /opt/pydio/bin/cells sea ejecutable y sal del usuario pydio actual.

chmod a+x /opt/pydio/bin/cells
exit

Después de eso, ejecuta el comando setcap a continuación para permitir que Pydio use puertos privilegiados (0-1024) y crear un enlace simbólico a /usr/local/bin/cells.

sudo setcap 'cap_net_bind_service=+ep' /opt/pydio/bin/cells
sudo ln -s /opt/pydio/bin/cells /usr/local/bin/cells

Inicia sesión como usuario pydio nuevamente y ejecuta el comando cells a continuación para verificar la versión de Pydio Cells.

su - pydio
cells version

Como puedes ver a continuación, Pydio Cells 4.4.3 está instalado.

Configurando Pydio Cells

Ahora que has descargado Pydio Cells, lo configurarás e integrarás con el servidor de base de datos MariaDB y crearás un usuario administrador para la instalación de Pydio Cells. Esto se puede hacer a través de la línea de comandos cells.

Ejecuta el comando cells a continuación para instalar y configurar la instalación de Pydio Cells.

cells configure --cli

• Selecciona TCP para la conexión de base de datos y escribe tu base de datos MariaDB, usuario y contraseña.
• Ingresa N para el soporte de MongoDB. En este caso, construirás e instalarás Pydio Cells único.
• Presiona ENTER para usar la configuración de almacenamiento predeterminada.
• Ingresa un nuevo usuario administrador, dirección de correo electrónico y contraseña para tu instalación de Pydio Cells.

Después de que la instalación esté completa, verás el mensaje Instalación finalizada.

Ejecutando Pydio Cells como un servicio systemd

En esta sección, crearás y configurarás un archivo de servicio systemd para Pydio Cells. Con esto, puedes gestionar fácilmente Pydio Cells con el comando systemctl.

Crea un nuevo archivo de servicio /etc/systemd/system/cells.service con el editor nano.

sudo nano /etc/systemd/system/cells.service

Agrega la siguiente configuración al archivo y asegúrate de cambiar la variable de entorno CELLS_EXTERNAL con tu nombre de dominio objetivo.

[Unit]
Description=Pydio Cells
Documentation=https://pydio.com
Wants=network-online.target
After=network-online.target
AssertFileIsExecutable=/opt/pydio/bin/cells

[Service]
User=pydio
Group=pydio
PermissionsStartOnly=true
AmbientCapabilities=CAP_NET_BIND_SERVICE
ExecStart=/opt/pydio/bin/cells start
Restart=on-failure
StandardOutput=journal
StandardError=inherit
LimitNOFILE=65536
TimeoutStopSec=5
KillSignal=INT
SendSIGKILL=yes
SuccessExitStatus=0
WorkingDirectory=/home/pydio

# Agregar variables de entorno
Environment=CELLS_WORKING_DIR=/var/cells
Environment=CELLS_BIND=127.0.0.1:8080
Environment=CELLS_EXTERNAL=https://cells.howtoforge.local

[Install]
WantedBy=multi-user.target

Guarda el archivo y sal del editor.

Ahora ejecuta el comando systemctl a continuación para recargar el administrador de systemd y aplicar tus cambios.

sudo systemctl daemon-reload

Inicia y habilita el servicio cells con el comando a continuación. Luego, verifica el estado de cells para asegurarte de que el servicio esté en ejecución.

sudo systemctl enable --now cells
sudo systemctl status cells

Configurando Apache como un proxy inverso

Después de que Pydio Cells se ejecute como un servicio systemd, crearás un nuevo archivo de host virtual de Apache como un proxy inverso para Pydio Cells. También necesitarás habilitar los módulos de Apache con el comando a2enmod.

Primero, ejecuta el comando a2enmod a continuación para habilitar los módulos de Apache. En este caso, habilitarás módulos para SSL y proxy inverso.

sudo a2enmod rewrite ssl proxy proxy_http proxy_wstunnel http2 proxy_http2

Ahora crea un nuevo archivo de host virtual /etc/apache2/sites-available/cells.conf con el siguiente comando nano.

sudo nano /etc/apache2/sites-available/cells.conf

Inserta la configuración a continuación para configurar Apache como un proxy inverso para Pydio Cells. Asegúrate de cambiar la opción ServerName con tu nombre de dominio objetivo.

    ServerName cells.howtoforge.local

    AllowEncodedSlashes On
    RewriteEngine On

    # ten en cuenta esto
    # Permitir proxy inverso a través de certificados autofirmados
    SSLProxyEngine On
    SSLProxyVerify none 
    SSLProxyCheckPeerCN off
    SSLProxyCheckPeerName off
    SSLProxyCheckPeerExpire off

    ## El orden de las directivas importa.
    # Si Cells no se está ejecutando con https, considera usar ws en lugar de wss
    ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon

    ## Esta condición de reescritura es necesaria si se usa Cells-Sync
    # RewriteCond %{HTTP:Content-Type} =application/grpc [NC]
    # RewriteRule /(.*) h2://localhost:8080/$1 [P,L]

    ProxyPass "/" "https://127.0.0.1:8080/"
    ProxyPassReverse "/" "https://127.0.0.1:8080/"

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

Guarda y sal del archivo cuando termines.

A continuación, ejecuta el comando a2ensite a continuación para activar el host virtual cells.conf y verificar tu configuración de Apache. Si tienes una configuración de Apache adecuada, verás una salida Syntax is OK.

sudo a2ensite cells.conf
sudo apachectl configtest

Por último, ejecuta el comando systemctl a continuación para reiniciar el servidor web Apache y aplicar tus cambios.

sudo systemctl restart apache2

Asegurando Pydio Cells con HTTPS

Pydio Cells es accesible a través de HTTPS. Así que debes habilitar HTTPS en tu archivo de host virtual de Apache. En esta sección, generarás certificados SSL/TLS con certbot para asegurar la instalación de Pydio Cells.

Para asegurar Pydio Cells con HTTPS, ejecuta el comando certbot a continuación. asegúrate de cambiar el nombre de dominio y la dirección de correo electrónico a continuación con tu información.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d cells.howtoforge.local

Después de que el proceso esté completo, tus certificados SSL/TLS estarán disponibles en el directorio /etc/letsencrypt/live/domain.com.

Ahora abre tu navegador web y visita tu nombre de dominio https://cells.howtoforge.local/. Si tu instalación es exitosa, se te mostrará la página de inicio de sesión de Pydio Cells.

Ingresa tu usuario administrador y contraseña, y haz clic en ENTER.

Verás el panel de control de Pydio Cells como el siguiente:

Conclusión

¡Felicidades! Has completado la instalación de Pydio Cells en el servidor Ubuntu 24.04. Tienes Pydio Cells en funcionamiento con el servidor de base de datos MariaDB y Apache como proxy inverso. Por último, también has asegurado Pydio Cells con HTTPS a través de Certbot y Letsencrypt.