Seafile, eine selbst gehostete Cloud-Speicherlösung¶

Meldet Euch auf dem Server an und legt einen Systembenutzer an, der Seafile ausführen soll. Für die Zwecke dieses Tutorials nennen wir diesen Systembenutzer seafileadmin. Natürlich könnt Ihr jeden beliebigen Namen wählen, stellt nur sicher, dass Ihr die Befehle entsprechend anpasst:

sudo adduser --disabled-login seafileadmin

Meldet Euch mit dem folgenden Befehl bei MySQL als Root-Benutzer an:

sudo mysql -u root -p

Führt den folgenden Befehl aus, um den MySQL-Benutzer seafileadmin zu erstellen (passt den Benutzernamen entsprechend an). Stellt sicher, dass Ihr die Zeichenfolge StrongPassword durch ein sicheres, individuelles Passwort ersetzt:

CREATE USER 'seafileadmin'@'localhost' IDENTIFIED WITH mysql_native_password BY 'StrongPassword';

Erzeugt als Nächstes die von Seafile benötigten Datenbanken und gewährt die richtigen Zugriffsrechte:

CREATE DATABASE ccnet;
CREATE DATABASE seafile;
CREATE DATABASE seahub;
GRANT ALL ON ccnet.* TO 'seafileadmin'@'localhost';
GRANT ALL ON seafile.* TO 'seafileadmin'@'localhost';
GRANT ALL ON seahub.* TO 'seafileadmin'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Meldet Euch wieder als Benutzer seafileadmin bei MySQL an (passt den Benutzernamen entsprechend an):

sudo mysql -u seafileadmin -p

Stellt sicher, dass alle Datenbanken korrekt angelegt wurden:

SHOW DATABASES;

Die Ausgabe sollte in etwa folgendermaßen aussehen:

+--------------------+
| Database           |
+--------------------+
| information_schema |
| ccnet              |
| seafile            |
| seahub             |
+--------------------+
4 rows in set (0.02 sec)

Verlasst MySQL:

EXIT;

Voraussetzungen¶

Python ist zur Ausführung von Seafile erforderlich, installiert folgende Pakete auf dem Server:

sudo apt install python3 python3-{setuptools,pip} libmysqlclient-dev memcached libmemcached-dev libffi-dev

Installiert anschließend weitere Pakete als Benutzer seafileadmin (passt den Benutzernamen entsprechend an):

sudo -H -u seafileadmin pip3 install --user django==3.2.* Pillow pylibmc captcha jinja2 sqlalchemy==1.4.3 django-pylibmc django-simple-captcha python3-ldap mysqlclient pycryptodome==3.12.0

Installationsskript¶

Ermittelt die neueste Version von Seafile Server für Linux. Zum Zeitpunkt der Abfassung dieses Textes handelt es sich um die Version 9.0.5. Ladet das Paket herunter und entpackt es mit den folgenden Befehlen (passt die Versionsnummer entsprechend an):

sudo wget -4 https://download.seadrive.org/seafile-server_9.0.5_x86-64.tar.gz
sudo tar -xvf seafile-server_*
sudo mkdir /var/www/seafile
sudo mkdir /var/www/seafile/installed
sudo mv seafile-server-* /var/www/seafile
sudo mv seafile-server_* /var/www/seafile/installed

sudo chown -R seafileadmin:seafileadmin /var/www/seafile
sudo chmod -R 755 /var/www/seafile
sudo -H -u seafileadmin pip3 install --force-reinstall --upgrade --target /var/www/seafile/seafile-server-9.0.5/seahub/thirdpart cffi==1.14.6

Führt das Installationsskript aus:

sudo bash /var/www/seafile/seafile-server-9.0.5/setup-seafile-mysql.sh

Folgt den Anweisungen auf dem Bildschirm:

Nach erfolgreicher Installation sollte das Terminal in etwa folgende Ausgabe anzeigen:

-----------------------------------------------------------------
Your seafile server configuration has been finished successfully.
-----------------------------------------------------------------

run seafile server:     ./seafile.sh { start | stop | restart }
run seahub  server:     ./seahub.sh  { start <port> | stop | restart <port> }

-----------------------------------------------------------------
If you are behind a firewall, remember to allow input/output of these tcp ports:
-----------------------------------------------------------------

port of seafile fileserver:   8082
port of seahub:               8000

When problems occur, refer to https://download.seafile.com/published/seafile-manual/home.md for information.

Sprache¶

Ändert die Spracheinstellungen. In diesem Beispiel werden wir Deutsch verwenden:

echo "export LC_ALL=de_DE.UTF-8" >>~/.bashrc
echo "export LANG=de_DE.UTF-8" >>~/.bashrc
echo "export LANGUAGE=de_DE.UTF-8" >>~/.bashrc
source ~/.bashrc

Stellt mit dem folgenden Befehl sicher, dass die Einstellungen korrekt übernommen wurden:

locale

Die Terminal-Ausgabe sollte in etwa folgendermaßen aussehen:

LANG=de_DE.UTF-8
LANGUAGE=de_DE.UTF-8
LC_CTYPE="de_DE.UTF-8"
LC_NUMERIC="de_DE.UTF-8"
LC_TIME="de_DE.UTF-8"
LC_COLLATE="de_DE.UTF-8"
LC_MONETARY="de_DE.UTF-8"
LC_MESSAGES="de_DE.UTF-8"
LC_PAPER="de_DE.UTF-8"
LC_NAME="de_DE.UTF-8"
LC_ADDRESS="de_DE.UTF-8"
LC_TELEPHONE="de_DE.UTF-8"
LC_MEASUREMENT="de_DE.UTF-8"
LC_IDENTIFICATION="de_DE.UTF-8"
LC_ALL=de_DE.UTF-8

Ihr könnt natürlich jegliche andere Sprache wählen. Prüft, welche Sprachen (auf Englisch Locales) der Server derzeit unterstützt:

locale -a

Solltet Ihr weitere Sprachen hinzufügen wollen, kommentiert einfach die erforderlichen Zeilen in der folgenden Konfigurationsdatei aus (z. B. es_ES.UTF-8 für Spanisch, fr_FR.UTF-8 für Französisch, nl_NL.UTF-8 für Niederländisch, usw.):

sudo vi /etc/locale.gen

Übernehmt die Änderungen:

sudo locale-gen

Führt nun die im obigen Abschnitt beschriebenen Befehle aus und wendet dabei Eure bevorzugten Spracheinstellungen an.

Administratorkonto¶

Legt die richtigen Zugrifssrechte fest und wechselt in das Verzeichnis /var/www/seafile:

sudo chown -R seafileadmin:seafileadmin /var/www/seafile
sudo chmod -R 755 /var/www/seafile
sudo chmod 750 /home/seafileadmin
cd /var/www/seafile

Startet Seafile:

sudo -H -u seafileadmin bash -C '/var/www/seafile/seafile-server-latest/seafile.sh' start

Startet Seahub:

sudo -H -u seafileadmin bash -C '/var/www/seafile/seafile-server-latest/seahub.sh' start

Beim ersten Start von Seahub wird die Einrichtung eines Administratorkontos verlangt. Für den Zweck dieses Tutorials geben wir die Administrator-E-Mail-Adresse seafileadmin@gofoss.net an. Natürlich kann jegliche geeignete E-Mail-Adresse verwendet werden. Wenn Ihr dazu aufgefordert werdet, gebt ebenfalls ein sicheres, individuelles Kennwort ein.

Autostart¶

Stellt sicher, dass Seafile bei jedem Hochfahren des Servers automatisch gestartet wird. Erstellt eine erste Konfigurationsdatei:

sudo vi /etc/systemd/system/seafile.service

Gebt den folgenden Inhalt ein:

[Unit]
Description=Seafile
After= mysql.service network.target

[Service]
Type=forking
ExecStart=/var/www/seafile/seafile-server-latest/seafile.sh start
ExecStop=/var/www/seafile/seafile-server-latest/seafile.sh stop
User=seafileadmin

[Install]
WantedBy=multi-user.target

Speichert und schließt die Datei (:wq!). Erstellt nun eine zweite Konfigurationsdatei:

sudo vi /etc/systemd/system/seahub.service

Gebt den folgenden Inhalt ein:

[Unit]
Description=Seahub
After= mysql.service network.target seafile.service

[Service]
Type=forking
Environment="LC_ALL=en_US.UTF-8"
ExecStart=/var/www/seafile/seafile-server-latest/seahub.sh start
ExecStop=/var/www/seafile/seafile-server-latest/seahub.sh stop
User=seafileadmin

[Install]
WantedBy=multi-user.target

Speichert schließt die Datei (:wq!).

Stellt sicher, dass Seafile bei jedem Boot-Vorgang automatisch gestartet wird:

sudo systemctl daemon-reload
sudo systemctl enable seafile
sudo systemctl enable seahub

Startet den Server neu:

sudo reboot

Vergewissert Euch, dass Seafile betriebsbereit ist (der Status sollte Active sein):

sudo systemctl status seafile
sudo systemctl status seahub

Nachbereitung¶

Der Cloud-Speicher ist von einer Domain Eurer Wahl aus zugänglich. Im Rahmen dieses Tutorials wählen wir https://myfiles.gofoss.duckdns.org. Natürlich ist jegliche andere Adresse möglich. Achtet nur darauf, dass Ihr die Befehle entsprechend anpasst. Öffnet die erste Konfigurationsdatei:

sudo vi /var/www/seafile/conf/seahub_settings.py

Vergewissert Euch, dass die SERVICE__URL auf die richtige Adresse verweist:

SERVICE_URL = "https://myfiles.gofoss.duckdns.org/"

Fügt anschließend die folgenden Zeilen am Ende der Datei hinzu (passt die Zeitzone sowie die FILE_SERVER_ROOT URL entsprechend Eurer eigenen Konfiguration an):

TIME_ZONE = 'Europe/Budapest'
SESSION_EXPIRE_AT_BROWSER_CLOSE = True
LOGIN_ATTEMPT_LIMIT = 2
FILE_SERVER_ROOT = 'https://myfiles.gofoss.duckdns.org/seafhttp'

Speichert schließt die Datei (:wq!).

Erstellt eine Apache-Konfigurationsdatei:

sudo vi /etc/apache2/sites-available/myfiles.gofoss.duckdns.org.conf

Fügt den folgenden Inhalt hinzu und passt die Einstellungen an Eure eigene Konfiguration an, z. B. den Domain-Namen (myfiles.gofoss.duckdns.org), den Pfad zu den SSL-Schlüsseln, die IP-Adressen und so weiter:

<VirtualHost *:80>

    ServerName              myfiles.gofoss.duckdns.org
    ServerAlias             www.myfiles.gofoss.duckdns.org
    Redirect permanent /    https://myfiles.gofoss.duckdns.org/

</VirtualHost>

<VirtualHost *:443>

    ServerName              myfiles.gofoss.duckdns.org
    ServerAlias             www.myfiles.gofoss.duckdns.org
    ServerSignature         Off

    SecRuleEngine           Off
    SSLEngine               On
    SSLProxyEngine          On
    SSLProxyCheckPeerCN     Off
    SSLCertificateFile      /etc/dehydrated/certs/gofoss.duckdns.org/fullchain.pem
    SSLCertificateKeyFile   /etc/dehydrated/certs/gofoss.duckdns.org/privkey.pem
    DocumentRoot            /var/www/seafile

    <Location />
        Order deny,allow
        Deny from all
        Allow from 127.0.0.1
        Allow from 192.168.1.0/24
        Allow from 10.8.0.1/24
    </Location>

    Alias /media  /var/www/seafile/seafile-server-latest/seahub/media

    RewriteEngine On

    <Location /media>
    Require all granted
    </Location>

    # seafile fileserver
    ProxyPass /seafhttp http://127.0.0.1:8082
    ProxyPassReverse /seafhttp http://127.0.0.1:8082

    # seahub
    SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
    ProxyPreserveHost On
    ProxyPass / http://127.0.0.1:8000/
    ProxyPassReverse / http://127.0.0.1:8000/

    ErrorLog ${APACHE_LOG_DIR}/myfiles.gofoss.duckdns.org-error.log
    CustomLog ${APACHE_LOG_DIR}/myfiles.gofoss.duckdns.org-access.log combined

</VirtualHost>

Speichert und schließt die Datei (:wq!).

Beachtet, dass die SSL-Verschlüsselung für Seafile mit der Anweisung SSLEngine On aktiviert und das zuvor erstellte SSL-Zertifikat /etc/dehydrated/certs/gofoss.duckdns.org/fullchain.pem sowie der private SSL-Schlüssel /etc/dehydrated/certs/gofoss.duckdns.org/privkey.pem verwendet wurden.

Beachtet ebenfalls, dass ModSecurity in der Apache-Konfigurationsdatei mit der Anweisung SecRuleEngine Off deaktiviert wurde, da Seafile und ModSecurity nicht gut miteinander harmonieren.

Aktiviert als nächstes den Apache Virtual Host und ladet Apache neu:

sudo a2ensite myfiles.gofoss.duckdns.org.conf
sudo systemctl reload apache2

Konfiguriert Pi-Hole, um die lokale Adresse von Seafile nutzen zu können. Ruft dazu https://mypihole.gofoss.duckdns.org auf und meldet Euch über die Pi-Hole-Weboberfläche an (passt die URL entsprechend an). Öffnet den Menüeintrag Locale DNS Records und fügt die folgende Domain/IP-Kombination hinzu (passt wiederum die URL sowie IP entsprechend an):

DOMAIN:      myfiles.gofoss.duckdns.org
IP ADDRESS:  192.168.1.100

Ruft https://myfiles.gofoss.duckdns.org auf und meldet Euch als seafileadmin@gofoss.net an (passt den Benutzernamen entsprechend an). Nehmt anschließend folgende Einstellungen vor:

Der Systemadministrator meldet sich über die Seahub-Weboberfläche an, um die Benutzer Georg, Tom und Lenina anzulegen.

Zunächst muss der Seafile-Administrator 2FA aktivieren:

Als nächstes muss jeder Benutzer individuell die 2FA konfigurieren. Beginnt mit dem Seafile-Administrator und wiederholt die Einstellung für jedes später eingerichtete Benutzerkonto:

Freigabe-Links: Tom möchte Orwells Essay mit einer Freundin aus dem Buchklub teilen. Diese Freundin kann sich über VPN mit dem Server verbinden, hat aber kein eigenes Seafile-Konto. Tom meldet sich daher in der Seahub-Weboberfläche an, um ihr einen Freigabelink zu schicken, der nach einer Woche abläuft.

Freigabe für Seafile-BenutzerInnen: Georg möchte die Bilder seiner Wandertour mit Lenina teilen. Lenina kann sich über VPN mit dem Server verbinden und besitzt ein Seafile-Konto. Georg meldet sich also in der Seahub-Weboberfläche an und gibt den Ordner holidays für Lenina frei, im "Nur-Lesen"-Modus.

Hochlade-Links: Georg möchte einige Arbeitsdokumente von einem Kollegen einsammeln. Dieser Kollege kann sich per VPN mit dem Server verbinden, hat aber keinen eigenen Seahub-Account. Georg meldet sich daher in der Seahub-Weboberfläche an, erstellt eine neue Bibliothek mit dem Namen work und sendet einen Hochlade-Link an seinen Kollegen.

Aufbewahrungsfrist: Um Speicherplatz zu sparen, weist Georg Seafile an, ältere Versionen seiner Bilder nur für 2 Monate aufzubewahren.

Bibliothek-Schnappschüsse: Georg möchte ebenfalls die Ordnerstruktur wiederherstellen, die vor dem Anlegen des Ordners holiday vorhanden war. Er stellt daher einen älteren Schnappschuss der Bibliothek wieder her.

Papierkorb: Tom stellt mit Hilfe des Papierkorbs Orwells Aufsatz wieder her, nachdem er ihn versehentlich gelöscht hat.

Tom arbeitet an einem vertraulichen Projekt. Er erstellt eine verschlüsselte Bibliothek, um seine Projektdokumente sicher aufzubewahren.

Für die Zwecke dieses Tutorials nehmen wir an, dass Ihr ein Upgrade von Version 7.0.1 auf Version 8.0.1 durchführen möchtet. Dies wird als "Hauptversion-Upgrade" bezeichnet. "Kleinere Version-Upgrades", zum Beispiel von 7.0.1 auf 7.1.1, funktionieren ähnlich.

Lest zunächst die Upgrade-Hinweise. Diese beschreiben bestimmte Einstellungen oder Änderungen, die vor oder während des Upgrades vorgenommen werden müssen.

Ladet dann die neueste Version von Seafiles Server für Linux herunter und entpackt diese. In unserem Beispiel wäre das die Version 8.0.1. Stellt sicher, dass Ihr in den nachfolgenden Befehlen die Versionsnummer entsprechend anpasst:

sudo wget -4 https://download.seadrive.org/seafile-server_8.0.1_x86-64.tar.gz
sudo tar -xvf seafile-server_*
sudo mv seafile-server-* /var/www/seafile
sudo mv seafile-server_* /var/www/seafile/installed

Legt die richtigen Zugriffsrechte fest:

sudo chown -R seafileadmin:seafileadmin /var/www/seafile
sudo chmod -R 755 /var/www/seafile

Überprüft, ob alle Dateien vorhanden sind:

sudo ls -al /var/www/seafile

Die Verzeichnisstruktur sollte in etwa folgendermaßen aussehen:

/var/www/seafile/
-- ccnet
-- conf
-- installed
-- logs
-- pids
-- seafile-data
-- seafile-server-7.0.1
-- seafile-server-8.0.1
-- seafile-server-latest
-- seahub-data

Fahrt den Seafile-Server herunter:

sudo systemctl stop seafile
sudo systemctl stop seahub

Ruft eine Liste der verfügbaren Upgrade-Skripte ab:

sudo ls -al /var/www/seafile/seafile-server-8.0.1/upgrade/upgrade_*

Die Terminal-Ausgabe sollte in etwa folgendermaßen aussehen:

...
/var/www/seafile/seafile-server-8.0.1/upgrade/upgrade_6.0_6.1.sh
/var/www/seafile/seafile-server-8.0.1/upgrade/upgrade_6.1_6.2.sh
/var/www/seafile/seafile-server-8.0.1/upgrade/upgrade_6.2_6.3.sh
/var/www/seafile/seafile-server-8.0.1/upgrade/upgrade_6.3_7.0.sh
/var/www/seafile/seafile-server-8.0.1/upgrade/upgrade_7.0_7.1.sh
/var/www/seafile/seafile-server-8.0.1/upgrade/upgrade_7.1_8.0.sh
...

Führt nun das oder die erforderliche(n) Upgrade-Skript(e) aus. Beginnt mit der aktuellen Seafile-Version und arbeitet Euch sich bis zur neuesten Version durch. In unserem Beispiel:

• müsst Ihr zuerst das Skript upgrade_7.0_7.1.sh ausführen, um von Version 7.0.1 auf Version 7.1.x zu aktualisieren
• Ihr müsst dann das Skript upgrade_7.1_8.0.sh ausführen, um von Version 7.1.x auf Version 8.0.1 zu aktualisieren

Beginnt mit dem ersten Upgrade-Skript:

sudo bash /var/www/seafile/seafile-server-8.0.1/upgrade/upgrade_7.0_7.1.sh

Die Terminal-Ausgabe sollte in etwa folgendermaßen aussehen:

-------------------------------------------------------------
This script would upgrade your seafile server from 7.0 to 7.1
Press [ENTER] to contiune
-------------------------------------------------------------

Updating seafile/seahub database ...

[INFO] You are using MySQL
[INFO] updating seahub database...
Done

migrating avatars ...

Done

updating /var/www/seafile/seafile-server-latest symbolic link to /var/www/seafile/seafile-server-7.1.0 ...

Nun das nächste Upgrade-Skript:

sudo bash /var/www/seafile/seafile-server-8.0.1/upgrade/upgrade_7.1_8.0.sh

Die Terminal-Ausgabe sollte in etwa folgendermaßen aussehen:

-------------------------------------------------------------
This script would upgrade your seafile server from 7.1 to 8.0
Press [ENTER] to contiune
-------------------------------------------------------------

Updating seafile/seahub database ...

[INFO] You are using MySQL
[INFO] updating seahub database...
Done

migrating avatars ...

Done

updating /var/www/seafile/seafile-server-latest symbolic link to /var/www/seafile/seafile-server-8.0.1 ...

Fahrt abschließend den Seafile-Server wieder hoch:

sudo systemctl start seafile
sudo systemctl start seahub

Wenn alles gut gelaufen ist, sollte Seafile betriebsbereit sein und den Status "Aktiv" anzeigen:

sudo systemctl status seafile
sudo systemctl status seahub

Wenn Ihr wollt und soweit alles richtig funktioniert, könnt Ihr die vorherige Version nun entfernen:

sudo rm -rf /var/www/seafile/seafile-server-7.0.1