Come installare Pydio Cells sul server Ubuntu 24.04
Questo tutorial esiste per queste versioni del sistema operativo
- Ubuntu 24.04 (Noble Numbat)
- Ubuntu 22.04 (Jammy Jellyfish)
- Ubuntu 18.04 (Castoro bionico)
In questa pagina
- Prerequisiti
- Installazione delle dipendenze
- Configurazione del server MariaDB
- Installazione delle celle Pydio
- Configurazione delle celle Pydio
- Esecuzione di Pydio Cells come servizio systemd
- Configurazione di Apache come proxy inverso
- Protezione delle celle Pydio con HTTPS
- Conclusione
Pydio Cells è una piattaforma di condivisione e collaborazione di documenti self-hosted. Ti dà anche il pieno controllo del tuo ambiente di condivisione dei documenti. Le celle Pydio hanno prestazioni veloci, gestiscono enormi dimensioni di trasferimento file e forniscono un'automazione avanzata del flusso di lavoro.
In questa guida ti guideremo attraverso l'installazione di Pydio Cells sul server Ubuntu 24.04 con il database MariaDB e Apache come proxy inverso.
Prerequisiti
Prima di iniziare, assicurati di avere quanto segue:
- Un server Ubuntu 24.04.
- Un utente non root con privilegi di amministratore.
- Un nome di dominio puntava all'indirizzo IP di un server.
Installazione delle dipendenze
Prima di installare Pydio Cells, devi installare le dipendenze sul tuo sistema Ubuntu. Ciò include il server database MariaDB e il server web Apache.
Innanzitutto, esegui il seguente comando apt
per aggiornare l'indice del tuo pacchetto Ubuntu e installare le dipendenze per Pydio Cells. Con questo comando installerai il server web Apache, il server database MariaDB e Certbot per generare certificati SSL/TLS.
sudo apt update sudo apt install apache2 mariadb-server certbot python3-certbot-apache wget
Inserisci Y
per confermare l'installazione.
Al termine dell'installazione, controlla lo stato del servizio Apache con quanto segue:
sudo systemctl è abilitato apache2 sudo
systemctl status apache2
Di seguito puoi vedere che il server web Apache è abilitato e in esecuzione.
Ora controlla lo stato del server MariaDB con il comando seguente.
sudo systemctl è abilitato mariadb
sudo systemctl status mariadb
Di seguito il server MariaDB è in esecuzione e abilitato.
Configurazione del server MariaDB
Dopo aver installato il server MariaDB, proteggerai MariaDB con l'utilità mariadb-secure-installation
. Quindi creerai un nuovo database e un nuovo utente per Pydio Cells.
Per proteggere l'installazione del server MariaDB, esegui il comando mariadb-secure-installation
di seguito.
sudo mariadb-secure-installation
Ti verrà chiesto informazioni sulla configurazione del server MariaDB di seguito:
- Passare l'autenticazione locale a unix_socket? Ingresso n.
- Imposta la nuova password root di MariaDB. Inserisci y per confermare, quindi digita la nuova password per la distribuzione del server MariaDB.
- Rimuovere l'utente anonimo? Immettere y per confermare.
- Rimuovere il test del database predefinito dalla distribuzione?. Immettere y per confermare.
- Non consentire l'accesso root a MariaDB da connessioni remote? Immettere y per confermare.
- Ricaricare i privilegi della tabella e applicare le modifiche? Immettere y e premere ENTER.
Ora esegui il comando client mariadb
riportato di seguito per accedere al server MariaDB. Inserisci la tua password di root quando richiesto.
sudo mariadb -u root -p
Successivamente, esegui le seguenti query per creare un nuovo database cellsdb
, un utente cells
e la password p4ssword
. Assicurati di modificare i dettagli di seguito con le tue informazioni.
CREA DATABASE celluledb;
CREA UTENTE cellule@localhost IDENTIFICATO DA 'cellsp4ssword';
CONCEDI TUTTI I PRIVILEGI SU celluledb.* A cellule@localhost;
PRIVILEGI FLUSH;
Ora esegui la query seguente per assicurarti che l'utente cells@localhost
possa accedere al database cellsdb
.
MOSTRA GRANTS PER cellule@localhost;
Dovresti vedere un output simile di seguito:
Digita quit
per uscire dal server MariaDB.
Installazione delle celle Pydio
In questa sezione creerai un nuovo utente pydio
, imposterai le variabili di ambiente, quindi scaricherai e installerai Pydio Cells.
Aggiungi un nuovo utente pydio
con il seguente comando:
sudo useradd -m -s /bin/bash pydio
Quindi, esegui il comando seguente per creare una nuova directory /opt/pydio/bin
e /var/cells
e modifica la proprietà in pydio
utente.
sudo mkdir -p /opt/pydio/bin /var/cells
sudo chown -R pydio: /opt/pydio/bin /var/cells
Ora esegui il comando seguente per creare il file env /etc/profile.d/cells-env.sh
e renderlo eseguibile. Questo file verrà eseguito quando l'utente accede.
sudo tee -a /etc/profile.d/cells-env.sh << EOF
esporta CELLS_WORKING_DIR=/var/cells
esporta CELLS_BIND=127.0.0.1:8080
esporta CELLS_EXTERNAL=https:// cellule.howtoforge.local
EOF
sudo chmod 0755 /etc/profile.d/cells-env.sh
Successivamente, accedi come utente pydio
e controlla le variabili di ambiente $CELLS_WORKING_DIR
, $CELLS_BIND
e $CELLS_EXTERNAL
. Assicurati che ciascuno punti al valore corretto come nel file /etc/profile.d/cells-env.sh
.
su - pydio
echo $CELLS_WORKING_DIR
echo $CELLS_BIND
echo $CELLS_EXTERNAL
Ora esegui il comando seguente per scaricare il file binario Pydio su /opt/pydio/bin/cells
.
esporta distribId=cells
wget -O /opt/pydio/bin/cells https://download.pydio.com/latest/
Rende eseguibile il file /opt/pydio/bin/cells
ed esce dall'utente pydio
corrente.
chmod a+x /opt/pydio/bin/cells esci
Successivamente, esegui il comando setcap
di seguito per consentire a Pydio di utilizzare le porte dei privilegi (0-1024) e creare un collegamento simbolico 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
Accedi nuovamente come utente pydio
ed esegui il comando cells
di seguito per verificare la versione di Pydio Cells.
su - versione pydio
cellule
Come puoi vedere di seguito, è installato Pydio Cells 4.4.3.
Configurazione delle celle Pydio
Ora che hai scaricato Pydio Cells, lo configurerai e lo integrerai con il server database MariaDB e creerai un utente amministratore per l'installazione di Pydio Cells. Ciò può essere fatto tramite la riga di comando cells
.
Esegui il comando cells
di seguito per installare e configurare l'installazione di Pydio Cells.
le celle configurano --cli
- Seleziona TCP per la connessione al database e digita il database, l'utente e la password MariaDB.
- Inserisci
N
per il supporto MongoDB. In questo caso, costruirai e installerai singole celle Pydio. - Premi INVIO per utilizzare la configurazione di archiviazione predefinita.
- Inserisci un nuovo utente amministratore, indirizzo email e password per l'installazione di Pydio Cells.
Una volta completata l'installazione, vedrai il messaggio Installazione terminata
.
Esecuzione di Pydio Cells come servizio systemd
In questa sezione creerai e configurerai un file di servizio systemd per Pydio Cells. Con questo, puoi gestire facilmente Pydio Cells con il comando systemctl
.
Crea un nuovo file di servizio /etc/systemd/system/cells.service
con l'editor nano
.
sudo nano /etc/systemd/system/cells.service
Aggiungi la seguente configurazione al file e assicurati di modificare la variabile di ambiente CELLS_EXTERNAL
con il nome del dominio di destinazione.
[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
# Add environment variables
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
Salvare il file ed uscire dall'editor.
Ora esegui il comando systemctl
di seguito per ricaricare il gestore systemd e applicare le modifiche.
sudo systemctl daemon-reload
Avvia e abilita il servizio cells
con il comando seguente. Quindi, controlla lo stato delle celle
per assicurarti che il servizio sia in esecuzione.
sudo systemctl abilita --now celle
celle di stato sudo systemctl
Configurazione di Apache come proxy inverso
Dopo che Pydio Cells viene eseguito come servizio systemd, creerai un nuovo file host virtuale Apache come proxy inverso per Pydio Cells. Dovrai anche abilitare i moduli Apache con il comando a2enmod
.
Innanzitutto, esegui il comando a2enmod
di seguito per abilitare i moduli Apache. In questo caso, abiliterai i moduli per SSL e proxy inverso.
sudo a2enmod riscrivi proxy ssl proxy_http proxy_wstunnel http2 proxy_http2
Ora crea un nuovo file host virtuale /etc/apache2/sites-available/cells.conf
con il seguente comando nano
.
sudo nano /etc/apache2/sites-available/cells.conf
Inserisci la configurazione seguente per impostare Apache come proxy inverso per Pydio Cells. Assicurati di modificare l'opzione ServerName
con il nome del dominio di destinazione.
<VirtualHost *:80>
ServerName cells.howtoforge.local
AllowEncodedSlashes On
RewriteEngine On
# be aware of this
# Allow reverse proxy via self-signed certificates
SSLProxyEngine On
SSLProxyVerify none
SSLProxyCheckPeerCN off
SSLProxyCheckPeerName off
SSLProxyCheckPeerExpire off
## The order of the directives matters.
# If Cells is not running with https, consider using ws instead of wss
ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon
## This rewrite condition is required if using 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
</VirtualHost>
Salvare e uscire dal file una volta terminato.
Successivamente, esegui il comando a2ensite
di seguito per attivare l'host virtuale cells.conf
e verificare la configurazione di Apache. Se hai una configurazione Apache corretta, vedrai un output Syntax is OK
.
sudo a2ensite cellule.conf
sudo apachectl configtest
Infine, esegui il comando systemctl
di seguito per riavviare il server web Apache e applicare le modifiche.
sudo systemctl riavviare apache2
Protezione delle celle Pydio con HTTPS
Pydio Cells è accessibile tramite HTTPS. Quindi devi abilitare HTTPS sul tuo file host virtuale Apache. In questa sezione genererai certificati SSL/TLS con certbot
per proteggere l'installazione di Pydio Cells.
Per proteggere Pydio Cells con HTTPS, esegui il comando certbot
di seguito. assicurati di modificare il nome di dominio e l'indirizzo email di seguito con le tue informazioni.
sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protetta] -d cellule.howtoforge.local
Una volta completato il processo, i tuoi certificati SSL/TLS saranno disponibili nella directory /etc/letsencrypt/live/domain.com
.
Ora apri il tuo browser web e visita il tuo nome di dominio https://cells.howtoforge.local/. Se l'installazione ha esito positivo, ti verrà richiesta la pagina di accesso di Pydio Cells.
Inserisci l'utente e la password dell'amministratore e fai clic su INVIO.
Vedrai la dashboard di Pydio Cells come la seguente:
Conclusione
Congratulazioni! Hai completato l'installazione di Pydio Cells sul server Ubuntu 24.04. Hai Pydio Cells attivo e funzionante con il server database MariaDB e Apache come proxy inverso. Infine, hai anche protetto Pydio Cells con HTTPS tramite Certbot e Letsencrypt.