Come installare Pydio Cells su AlmaLinux 9

Pydio Cells è una piattaforma open-source per la condivisione e collaborazione di documenti per la tua organizzazione. Ti consente di condividere documenti e file all’interno della tua organizzazione e ti offre il pieno controllo del tuo ambiente di condivisione documenti.

Le Pydio Cells sono veloci nelle prestazioni, possono gestire dimensioni di trasferimento file enormi e forniscono automazione avanzata dei flussi di lavoro.

In questa guida, ti mostreremo come installare Pydio Cells su un server Alma Linux 9. Installerai Pydio Cells con il server di database MariaDB e il server web Httpd.

Prerequisiti

Per iniziare con questa guida, assicurati di avere i seguenti requisiti:

• Un server Alma Linux 9
• Un utente non root con privilegi di amministratore
• Un nome di dominio puntato all’indirizzo IP del server
• Un SELinux con lo stato abilitato e permissivo

Installazione delle dipendenze

Prima di installare Pydio Cells, devi installare le dipendenze sul tuo server Alma Linux. Questo include il repository EPEL, il server di database MariaDB, il server web Httpd e alcuni strumenti di sistema come wget e nano.

Per prima cosa, esegui il comando ‘ dnf ‘ qui sotto per aggiungere il repository EPEL e installare il server MariDB e il server web Httpd. Inserisci ‘ Y ‘ per confermare l’installazione.

sudo dnf install epel-release mariadb-server httpd wget nano

Dopo che l’installazione è completata, esegui il comando ‘ systemctl ‘ qui sotto per avviare, abilitare e verificare il servizio ‘ httpd ‘. Vedrai che il servizio ‘ httpd ‘ è in esecuzione e abilitato.

sudo systemctl enable --now httpd  
sudo systemctl status httpd

Ora esegui il seguente comando per avviare e abilitare il servizio ‘ mariadb ‘. E poi, verifica per assicurarti che il servizio sia in esecuzione.

sudo systemctl enable --now mariadb  
sudo systemctl status mariadb

Nell’output seguente, puoi vedere che il server MariaDB è in esecuzione e abilitato.

Infine, esegui il comando ‘ firewall-cmd ‘ qui sotto per aprire le porte ‘ http ‘ e ‘ https ‘ sul tuo sistema. Poi, ricarica le regole di firewalld per applicare le modifiche.

sudo firewall-cmd --add-service={http,https} --permanent  
sudo firewall-cmd --reload

Configurazione del server MariaDB

Dopo aver installato le dipendenze, devi mettere in sicurezza l’installazione del server MariaDB e creare un nuovo database e utente per l’installazione del server Pydio Cells. Metterai in sicurezza MariaDB con il comando ‘ mariadb-secure-installation ‘, e poi creerai un nuovo database e utente tramite il client ‘ mariadb ‘.

Per mettere in sicurezza l’installazione del server MariaDB, esegui il comando ‘ mariadb-secure-installation ‘ qui sotto.

sudo mariadb-secure-installation

Durante il processo, ti verrà chiesto di configurare quanto segue:

• Passare l’autenticazione locale a unix_socket? Inserisci n.
• Imposta la nuova password root di MariaDB. Inserisci y per confermare, quindi digita la nuova password per la tua installazione del server MariaDB.
• Rimuovere l’utente anonimo? Inserisci y per confermare.
• Rimuovere il database di test predefinito dall’installazione? Inserisci y per confermare.
• Vietare il login root di MariaDB da connessioni remote? Inserisci y per confermare.
• Ricaricare i privilegi delle tabelle e applicare le modifiche. Inserisci y e premi INVIO.

Ora che il server MariaDB è sicuro, creerai un nuovo database e utente per l’installazione di Pydio Cells.

Accedi al server MariaDB con il comando ‘ mariadb ‘ qui sotto. Inserisci la tua password root di MariaDB quando richiesto.

sudo mariadb -u root -p

Esegui le seguenti query per creare un nuovo database ‘ cells ‘, e un nuovo utente ‘ pydio ‘, con la password ‘p4ssw0rd’. Puoi modificare i dettagli del database secondo necessità.

CREATE DATABASE cells;  
CREATE USER 'pydio'@'localhost' IDENTIFIED BY 'p4ssw0rd';  
GRANT ALL PRIVILEGES ON cells.* to 'pydio'@'localhost';  
FLUSH PRIVILEGES;

Ora controlla i privilegi per l’utente ‘ pydio ‘ per assicurarti che abbia permessi e privilegi sul database ‘ cells ‘.

SHOW GRANTS FOR 'pydio'@'localhost';

Puoi vedere qui sotto che il database ‘ cells ‘ è accessibile tramite l’utente ‘ pydio ‘.

Digita ‘quit’ per uscire dal server MariaDB.

Download di Pydio Cells

Con il database MariaDB configurato, sei pronto per scaricare Pydio Cells. In questa sezione, configurerai l’utente ‘pydio’, scaricherai Pydio Cells, imposterai la directory di installazione e le variabili d’ambiente, e permetterai a Pydio Cells di funzionare sulle porte privilegiate.

Crea un nuovo utente e gruppo ‘ pydio ‘ con il seguente comando.

sudo useradd -m -s /bin/bash pydio

Crea nuove directory ‘ /opt/pydio/bin ‘ e ‘ /var/cells ‘ con il comando qui sotto. E poi cambia la proprietà di entrambe le directory all’utente ‘ pydio ‘.

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

Ora crea un nuovo file env ‘ /etc/profile.d/cells-env.sh ‘ con l’editor ‘ nano ‘.

sudo nano /etc/profile.d/cells-env.sh

Inserisci il seguente script per impostare le variabili d’ambiente per Pydio Cells. Assicurati di cambiare l’indirizzo ‘ CELLS_EXTRERNAL ‘ per corrispondere al nome di dominio della tua installazione di Pydio.

export CELLS_WORKING_DIR=/var/cells  
export CELLS_BIND=127.0.0.1:8080  
export CELLS_EXTERNAL=https://cells.howtoforge.local

Quando hai finito, salva e esci dal file.

Ora esegui il comando qui sotto per rendere il file env ‘ /etc/profile.d/cells-env.sh ‘ eseguibile.

sudo chmod +x /etc/profile.d/cells-env.sh

Successivamente, esegui il comando qui sotto per scaricare il file binario di Pydio Cells per Linux in ‘ /opt/pydio/bin/cells ‘.

export distribId=cells  
wget -O /opt/pydio/bin/cells https://download.pydio.com/latest/${distribId}/release/{latest}/linux-amd64/${distribId}

Una volta scaricato, esegui il seguente comando per rendere il file binario ‘ cells ‘ eseguibile e permettergli di legarsi alle porte privilegiate.

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

Ora accedi come utente ‘ pydio ‘ con il seguente:

su - pydio

Controlla le variabili d’ambiente per Pydio Cells con il seguente - Assicurati che l’output corrisponda a quanto presente nel file env ‘ /etc/profile.d/cells-env.sh ‘.

echo $CELLS_WORKING_DIR  
echo $CELLS_BIND  
echo $CELLS_EXTERNAL

Infine, controlla la versione di ‘cells’ con il comando qui sotto.

cells version

Nell’output seguente, puoi vedere la versione di Pydio Cells.

Installazione di Pydio Cells tramite la riga di comando

Ora inizierai a installare Pydio Cells dalla riga di comando. Con il comando ‘ cells ‘, configurerai l’installazione di Pydio Cells con il database MariaDB, imposterai l’utente amministrativo e la password, e imposterai la posizione di archiviazione per memorizzare i dati degli utenti.

Per iniziare, esegui il comando qui sotto per configurare l’installazione di Pydio Cells dal terminale.

cells configure --cli

Ora ti verrà chiesto di configurare quanto segue:

• Connessione al database: seleziona tramite TCP, quindi inserisci i dettagli dell’host del tuo database MariaDB, porta, utente e password.
• Configurazione di MongoDB: inserisci n per no.
• Configurazione dell’utente amministrativo: inserisci il tuo utente amministrativo e la password per Pydio Cells.
• Posizione di archiviazione predefinita: premi INVIO per utilizzare il predefinito e continuare.

Dopo che il processo è completato, vedrai il seguente output:

Impostazione del file di servizio systemd per Pydio Cells

Dal passo precedente, puoi avviare Pydio Cells con il comando ‘cells start’. Per semplificare, utilizzerai invece ‘systemctl’ di systemd per gestire il servizio Pydio Cells. Quindi ora creerai un nuovo file di servizio systemd.

Crea un nuovo file ‘/etc/systemd/system/cells.service’ con l’editor ‘nano’.

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

Inserisci la configurazione qui sotto per eseguire Pydio Cells come servizio systemd. Assicurati di cambiare ‘CELLS_EXTERNAL’ con il tuo nome di dominio.

[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  
  
# Aggiungi variabili d'ambiente  
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

Salva il file ed esci dall’editor.

Ora esegui il comando qui sotto per ricaricare il gestore systemd.

sudo systemctl daemon-reload

Infine, esegui il comando ‘ systemctl ‘ qui sotto per avviare, abilitare e verificare il servizio ‘ cells ‘.

sudo systemctl enable --now cells  
sudo systemctl status cells

In questo output, puoi vedere che il servizio ‘ cells ‘ è in esecuzione in background come servizio systemd.

Configurazione di Httpd come reverse proxy

A questo punto, le Pydio Cells sono in esecuzione sul tuo server Alma Linux sulla porta ‘8080’. Per renderlo accessibile dal client, creerai un file di host virtuale Httpd come reverse proxy per il server Pydio Cells. Genererai anche certificati SSL/TLS da Letsencrypt per garantire il trasferimento dei dati tra il client e il server Pydio Cells.

Per prima cosa, esegui il comando ‘ dnf ‘ qui sotto per installare ‘certbot’ sul tuo sistema.

sudo dnf install certbot -y

Ora crea una nuova directory web root fittizia e cambia la proprietà all’utente ‘ apache ‘.

sudo mkdir -p /var/www/html/cells/public_html  
sudo chown -R apache:apache /var/www/html/cells/public_html

Esegui il comando ‘ certbot ‘ qui sotto per generare certificati SSL/TLS per Pydio Cells. Assicurati di cambiare l’indirizzo email e il nome di dominio con le tue informazioni.

sudo certbot certonly --agree-tos --email [email protected] --no-eff-email --webroot -w /var/www/html/cells/public_html -d cells.howtoforge.local

Successivamente, crea una nuova configurazione di host virtuale Httpd ‘ /etc/httpd/conf.d/pydio.conf ‘ con l’editor ‘ nano ‘.

sudo nano /etc/httpd/conf.d/pydio.conf

Inserisci la configurazione qui sotto e assicurati di cambiare l’opzione ‘ ServerName ‘ con il tuo nome di dominio.

  
ServerName cells.howtoforge.local  
  
RewriteEngine On  
RewriteCond %{HTTPS} off  
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI}  
  
RewriteCond %{SERVER_NAME} =cells.howtoforge.local  
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]  
  
  
  
ServerName cells.howtoforge.local  
AllowEncodedSlashes On  
RewriteEngine On  
  
# fai attenzione a questo  
# Consenti reverse proxy tramite certificati autofirmati  
SSLProxyEngine On  
SSLProxyVerify none  
SSLProxyCheckPeerCN off  
SSLProxyCheckPeerName off  
SSLProxyCheckPeerExpire off  
  
## L'ordine delle direttive è importante.  
# Se Cells non è in esecuzione con https, considera di usare ws invece di wss  
ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon  
  
## Questa condizione di riscrittura è necessaria se si utilizza 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 /var/log/httpd/error.log  
CustomLog /var/log/httpd/access.log combined  
  
SSLCertificateFile /etc/letsencrypt/live/cells.howtoforge.local/fullchain.pem  
SSLCertificateKeyFile /etc/letsencrypt/live/cells.howtoforge.local/privkey.pem  
#Include /etc/letsencrypt/options-ssl-apache.conf  

Salva il file ed esci dall’editor quando hai finito.

Ora esegui il comando ‘ apachectl ‘ qui sotto per verificare la sintassi di Apache. Se hai una configurazione Apache corretta, vedrai un output ‘ Syntax is OK ‘.

sudo apachectl configtest

Infine, esegui il comando ‘systemctl’ qui sotto per riavviare il server web ‘ httpd ‘ e applicare le modifiche. Con questo, la tua installazione di Pydio Cells dovrebbe essere completata e accessibile.

sudo systemctl restart httpd

Accesso a Pydio Cells

Apri il tuo browser web e visita il nome di dominio della tua installazione di Pydio Cells come https://cells.howtoforge.local. Se l’installazione è avvenuta con successo, vedrai la pagina di accesso di Pydio Cells.

Inserisci il tuo utente amministrativo e la password per accedere.

Se hai le credenziali corrette, vedrai il dashboard utente di Pydio Cells come il seguente.

Da qui, puoi ora provare a caricare file dal tuo computer locale al server Pydio Cells. Nello screenshot seguente, ho caricato file su Pydio Cells ed è andato a buon fine.

Conclusione

Congratulazioni! Hai completato l’installazione di Pydio Cells sul server Alma Linux 9. Hai Pydio Cells in esecuzione con il server di database MariaDB e il server web Httpd. Inoltre, hai anche messo in sicurezza l’installazione di Pydio Cells con HTTPS tramite Certbot e Letsencrypt.