Wie man Pydio Cells auf Ubuntu 24.04 Server installiert

Pydio Cells ist eine selbstgehostete Plattform für Dokumentenaustausch und Zusammenarbeit. Sie gibt Ihnen auch die volle Kontrolle über Ihre Dokumentenaustauschumgebung. Die Pydio Cells bieten eine schnelle Leistung, bewältigen große Dateigrößen und bieten fortschrittliche Workflow-Automatisierung.

In diesem Leitfaden führen wir Sie durch die Installation von Pydio Cells auf dem Ubuntu 24.04 Server mit der MariaDB-Datenbank und Apache als Reverse-Proxy.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Einen Ubuntu 24.04 Server.
• Einen Nicht-Root-Benutzer mit Administratorrechten.
• Einen Domainnamen, der auf eine Server-IP-Adresse zeigt.

Abhängigkeiten installieren

Bevor Sie Pydio Cells installieren, müssen Sie Abhängigkeiten auf Ihrem Ubuntu-System installieren. Dazu gehören der MariaDB-Datenbankserver und der Apache-Webserver.

Zuerst führen Sie den folgenden apt-Befehl aus, um Ihr Ubuntu-Paketindex zu aktualisieren und die Abhängigkeiten für Pydio Cells zu installieren. Mit diesem Befehl installieren Sie den Apache-Webserver, den MariaDB-Datenbankserver und Certbot zur Erstellung von SSL/TLS-Zertifikaten.

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

Geben Sie Y ein, um die Installation zu bestätigen.

Nachdem die Installation abgeschlossen ist, überprüfen Sie den Status des Apache-Dienstes mit folgendem Befehl:

sudo systemctl is-enabled apache2 
sudo systemctl status apache2

Sie können unten sehen, dass der Apache-Webserver aktiviert und läuft.

Überprüfen Sie nun den Status des MariaDB-Servers mit dem folgenden Befehl.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Unten sehen Sie, dass der MariaDB-Server läuft und aktiviert ist.

MariaDB-Server einrichten

Nach der Installation des MariaDB-Servers sichern Sie MariaDB mit dem Dienstprogramm mariadb-secure-installation. Dann erstellen Sie eine neue Datenbank und einen Benutzer für Pydio Cells.

Um die Installation des MariaDB-Servers zu sichern, führen Sie den folgenden Befehl mariadb-secure-installation aus.

sudo mariadb-secure-installation

Sie werden nach der Konfiguration des MariaDB-Servers gefragt:

• Lokale Authentifizierung auf unix_socket umschalten? Geben Sie n ein.
• Richten Sie das neue MariaDB-Root-Passwort ein. Geben Sie y ein, um zu bestätigen, und geben Sie dann das neue Passwort für Ihre MariaDB-Serverbereitstellung ein.
• Anonymen Benutzer entfernen? Geben Sie y ein, um zu bestätigen.
• Die Standarddatenbank-Test von der Bereitstellung entfernen? Geben Sie y ein, um zu bestätigen.
• MariaDB-Root-Login von Remote-Verbindungen verbieten? Geben Sie y ein, um zu bestätigen.
• Tabellenberechtigungen neu laden und die Änderungen anwenden? Geben Sie y ein und drücken Sie ENTER.

Führen Sie nun den mariadb-Clientbefehl unten aus, um sich beim MariaDB-Server anzumelden. Geben Sie Ihr Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie als Nächstes die folgenden Abfragen aus, um eine neue Datenbank cellsdb, einen Benutzer cells und das Passwort p4ssword zu erstellen. Stellen Sie sicher, dass Sie die Details unten mit Ihren Informationen ändern.

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

Führen Sie nun die Abfrage unten aus, um sicherzustellen, dass der Benutzer cells@localhost auf die Datenbank cellsdb zugreifen kann.

SHOW GRANTS FOR cells@localhost;

Sie sollten eine ähnliche Ausgabe unten sehen:

Geben Sie quit ein, um den MariaDB-Server zu verlassen.

Pydio Cells installieren

In diesem Abschnitt erstellen Sie einen neuen Benutzer pydio, richten Umgebungsvariablen ein und laden dann Pydio Cells herunter und installieren es.

Fügen Sie einen neuen Benutzer pydio mit dem folgenden Befehl hinzu:

sudo useradd -m -s /bin/bash pydio

Führen Sie dann den Befehl unten aus, um ein neues Verzeichnis /opt/pydio/bin und /var/cells zu erstellen und den Besitz auf den Benutzer pydio zu ändern.

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

Führen Sie nun den folgenden Befehl aus, um die Umgebungsdatei /etc/profile.d/cells-env.sh zu erstellen und sie ausführbar zu machen. Diese Datei wird ausgeführt, wenn der Benutzer sich anmeldet.

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

Melden Sie sich als Benutzer pydio an und überprüfen Sie die Umgebungsvariablen $CELLS_WORKING_DIR, $CELLS_BIND und $CELLS_EXTERNAL. Stellen Sie sicher, dass jede auf den richtigen Wert wie in der Datei /etc/profile.d/cells-env.sh zeigt.

su - pydio

echo $CELLS_WORKING_DIR  
echo $CELLS_BIND  
echo $CELLS_EXTERNAL

Führen Sie nun den folgenden Befehl aus, um die Pydio-Binärdatei nach /opt/pydio/bin/cells herunterzuladen.

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

Machen Sie die Datei /opt/pydio/bin/cells ausführbar und verlassen Sie den aktuellen Benutzer pydio.

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

Führen Sie danach den folgenden setcap-Befehl aus, um Pydio zu erlauben, privilegierte Ports (0-1024) zu verwenden, und erstellen Sie einen Symlink zu /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

Melden Sie sich erneut als Benutzer pydio an und führen Sie den Befehl cells unten aus, um die Pydio Cells-Version zu überprüfen.

su - pydio  
cells version

Wie Sie unten sehen können, ist Pydio Cells 4.4.3 installiert.

Pydio Cells konfigurieren

Jetzt, da Sie Pydio Cells heruntergeladen haben, konfigurieren Sie es und integrieren es mit dem MariaDB-Datenbankserver und erstellen einen Administrationsbenutzer für die Installation von Pydio Cells. Dies kann über die cells-Befehlszeile erfolgen.

Führen Sie den folgenden cells-Befehl aus, um die Installation und Konfiguration von Pydio Cells durchzuführen.

cells configure --cli

• Wählen Sie TCP für die Datenbankverbindung und geben Sie Ihre MariaDB-Datenbank, Benutzer und Passwort ein.
• Geben Sie N für die MongoDB-Unterstützung ein. In diesem Fall werden Sie eine einzelne Pydio Cells erstellen und installieren.
• Drücken Sie ENTER, um die Standard-Speicherkonfiguration zu verwenden.
• Geben Sie einen neuen Administrationsbenutzer, eine E-Mail-Adresse und ein Passwort für Ihre Pydio Cells-Installation ein.

Nachdem die Installation abgeschlossen ist, sehen Sie die Nachricht Installation abgeschlossen.

Pydio Cells als systemd-Dienst ausführen

In diesem Abschnitt erstellen und richten Sie eine systemd-Dienstdatei für Pydio Cells ein. Damit können Sie Pydio Cells einfach mit dem systemctl-Befehl verwalten.

Erstellen Sie eine neue Dienstdatei /etc/systemd/system/cells.service mit dem nano-Editor.

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

Fügen Sie die folgende Konfiguration in die Datei ein und stellen Sie sicher, dass Sie die Umgebungsvariable CELLS_EXTERNAL mit Ihrem Ziel-Domainnamen ändern.

[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

# Fügen Sie Umgebungsvariablen hinzu
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

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie nun den folgenden systemctl-Befehl aus, um den systemd-Manager neu zu laden und Ihre Änderungen anzuwenden.

sudo systemctl daemon-reload

Starten und aktivieren Sie den cells-Dienst mit dem folgenden Befehl. Überprüfen Sie dann den Status von cells, um sicherzustellen, dass der Dienst läuft.

sudo systemctl enable --now cells  
sudo systemctl status cells

Apache als Reverse-Proxy einrichten

Nachdem Pydio Cells als systemd-Dienst läuft, erstellen Sie eine neue Apache-virtuelle Hostdatei als Reverse-Proxy für Pydio Cells. Sie müssen auch Apache-Module mit dem Befehl a2enmod aktivieren.

Führen Sie zuerst den folgenden a2enmod-Befehl aus, um Apache-Module zu aktivieren. In diesem Fall aktivieren Sie Module für SSL und Reverse-Proxy.

sudo a2enmod rewrite ssl proxy proxy_http proxy_wstunnel http2 proxy_http2

Erstellen Sie nun eine neue virtuelle Hostdatei /etc/apache2/sites-available/cells.conf mit dem folgenden nano-Befehl.

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

Fügen Sie die folgende Konfiguration ein, um Apache als Reverse-Proxy für Pydio Cells einzurichten. Stellen Sie sicher, dass Sie die Option ServerName mit Ihrem Ziel-Domainnamen ändern.

    ServerName cells.howtoforge.local

    AllowEncodedSlashes On
    RewriteEngine On

    # Seien Sie sich dessen bewusst
    # Erlauben Sie den Reverse-Proxy über selbstsignierte Zertifikate
    SSLProxyEngine On
    SSLProxyVerify none 
    SSLProxyCheckPeerCN off
    SSLProxyCheckPeerName off
    SSLProxyCheckPeerExpire off

    ## Die Reihenfolge der Direktiven ist wichtig.
    # Wenn Cells nicht mit https läuft, ziehen Sie in Betracht, ws anstelle von wss zu verwenden
    ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon

    ## Diese Rewrite-Bedingung ist erforderlich, wenn Sie Cells-Sync verwenden
    # 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

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Führen Sie als Nächstes den Befehl a2ensite unten aus, um den virtuellen Host cells.conf zu aktivieren und Ihre Apache-Konfiguration zu überprüfen. Wenn Sie eine ordnungsgemäße Apache-Konfiguration haben, sehen Sie die Ausgabe Syntax ist OK.

sudo a2ensite cells.conf  
sudo apachectl configtest

Führen Sie schließlich den folgenden systemctl-Befehl aus, um den Apache-Webserver neu zu starten und Ihre Änderungen anzuwenden.

sudo systemctl restart apache2

Pydio Cells mit HTTPS sichern

Pydio Cells ist über HTTPS zugänglich. Daher müssen Sie HTTPS in Ihrer Apache-virtuellen Hostdatei aktivieren. In diesem Abschnitt generieren Sie SSL/TLS-Zertifikate mit certbot, um die Installation von Pydio Cells zu sichern.

Um Pydio Cells mit HTTPS zu sichern, führen Sie den folgenden certbot-Befehl aus. Stellen Sie sicher, dass Sie den Domainnamen und die E-Mail-Adresse unten mit Ihren Informationen ändern.

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

Nachdem der Vorgang abgeschlossen ist, sind Ihre SSL/TLS-Zertifikate im Verzeichnis /etc/letsencrypt/live/domain.com verfügbar.

Öffnen Sie nun Ihren Webbrowser und besuchen Sie Ihren Domainnamen https://cells.howtoforge.local/. Wenn Ihre Installation erfolgreich ist, werden Sie mit der Anmeldeseite von Pydio Cells aufgefordert.

Geben Sie Ihren Administrationsbenutzer und Ihr Passwort ein und klicken Sie auf ENTER.

Sie sehen das Pydio Cells-Dashboard wie folgt:

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von Pydio Cells auf dem Ubuntu 24.04 Server abgeschlossen. Sie haben Pydio Cells mit dem MariaDB-Datenbankserver und Apache als Reverse-Proxy in Betrieb genommen. Schließlich haben Sie Pydio Cells auch mit HTTPS über Certbot und Letsencrypt gesichert.