Wie man das Lychee Fotoverwaltungs-System auf Debian 12 installiert

Lychee ist eine Open-Source-Fotoverwaltungssoftware, die auf PHP und MySQL basiert. Es ist eine selbstgehostete Fotoverwaltung, die es Ihnen ermöglicht, Fotos sicher auf Ihrem Server hochzuladen, zu durchsuchen und zu teilen.

In diesem Tutorial lernen Sie, wie Sie Lychee Fotoverwaltung auf einem Debian 12-Server installieren. Sie verwenden den LAMP-Stack, um Lychee auszuführen und Lychee über Certbot und Letsencrypt mit HTTPS abzusichern.

Voraussetzungen

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

Einen Debian 12-Server
Einen Nicht-Root-Benutzer mit Administratorrechten

Abhängigkeiten installieren

In diesem Abschnitt installieren Sie den LAMP-Stack (Linux, Apache, MariaDB und PHP) auf dem Debian-Server. Derzeit unterstützt Lychee PHP 8.2 oder höher, das standardmäßig im Debian-Repository verfügbar ist.

Zuerst führen Sie den folgenden Befehl aus, um Ihr Ubuntu-Paket-Index zu aktualisieren.

sudo apt update

update repo

Jetzt installieren Sie die LAMP-Stack-Pakete auf Ihrem Debian-System mit dem folgenden Befehl. Geben Sie ‘ Y ‘ ein, um die Installation zu bestätigen.

sudo apt install apache2 mariadb-server php-cli php-intl php-xmlrpc php-soap php-mysql php-zip php-gd php-tidy php-mbstring php-curl php-xml php-pear php-bcmath php-imagick php-tokenizer libapache2-mod-php

install deps

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden Befehl aus, um den Status des Apache-Dienstes zu überprüfen. Sie werden sehen, dass der Apache-Webserver läuft und aktiviert ist.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

check apache2

Überprüfen Sie jetzt den MariaDB-Server mit dem folgenden Befehl. Der MariaDB-Server sollte automatisch auf Ihrem System laufen und aktiviert sein.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

Überprüfen Sie zuletzt die PHP-Version mit dem folgenden - Sie können sehen, dass PHP 8.3 installiert ist.

php -v  
php -m

check php version

PHP konfigurieren

Nachdem die Abhängigkeiten installiert sind, konfigurieren Sie PHP, indem Sie die Datei ‘php.ini’ bearbeiten und den Apache-Webserver neu starten, um die Änderungen wirksam zu machen.

Öffnen Sie die Datei ‘ /etc/php/8.3/apache2/php.ini ‘ mit dem ‘ nano ‘ Editor.

sudo nano /etc/php/8.3/apache2/php.ini

Ändern Sie die Standardkonfiguration wie folgt - Stellen Sie sicher, dass Sie die Optionen ‘ memory_limit ‘ und ‘ date.timezone ‘ entsprechend anpassen.

date.timezone = Europe/Amsterdam  
memory_limit = 256M  
  
upload_max_filesize = 64MB  
post_max_size = 64MB

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie jetzt den ‘ systemctl ‘ Befehl unten aus, um den Apache-Webserver neu zu starten und Ihre Änderungen anzuwenden.

sudo systemctl restart apache2

MariaDB-Server konfigurieren

Nachdem PHP konfiguriert ist, sichern Sie den MariaDB-Server mit dem Befehl ‘ mariadb-secure-installation ‘. Und dann erstellen Sie eine neue Datenbank und einen Benutzer, die für Lychee verwendet werden.

Führen Sie den Befehl ‘ mariadb-secure-installation ‘ unten aus, um Ihren MariaDB-Server einzurichten.

sudo mariadb-secure-installation

Jetzt werden Sie mit den folgenden MariaDB-Konfigurationen gefragt:

Für die Standardinstallation des MariaDB-Servers ohne Root-Passwort drücken Sie ENTER, wenn Sie nach dem Passwort gefragt werden.
Die lokale Authentifizierung für MariaDB-Root-Benutzer ist standardmäßig gesichert, geben Sie ‘n’ ein, wenn Sie gefragt werden, ob Sie die Authentifizierungsmethode auf ‘unix_socket’ ändern möchten.
Geben Sie ‘Y’ ein, um ein neues MariaDB-Root-Passwort zu erstellen. Geben Sie dann das starke Passwort für Ihren MariaDB-Root-Benutzer ein und wiederholen Sie es.
Wenn Sie gefragt werden, ob Sie die Remote-Authentifizierung für den MariaDB-Root-Benutzer deaktivieren möchten, geben Sie ‘Y’ ein, um zuzustimmen.
Die Standardinstallation des MariaDB-Servers kommt mit der Datenbank ‘test’ und erlaubt einem anonymen Benutzer den Zugriff darauf.
Geben Sie für beide Einstellungen ‘Y’ ein, um die Standarddatenbank ‘test’ zu entfernen und das anonyme Privileg zu entfernen.
Geben Sie schließlich ‘Y’ ein, um das Neuladen der Tabellenprivilegien zu bestätigen.

Nachdem MariaDB konfiguriert und gesichert ist, erstellen Sie eine neue Datenbank und einen Benutzer, die von der Lychee-Installation verwendet werden.

Melden Sie sich mit dem Befehl ‘ mariadb ‘ unten am MariaDB-Server an. Geben Sie Ihr MariaDB-Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie jetzt die folgenden Abfragen aus, um eine neue Datenbank ‘ lychee ‘ mit dem Benutzer ‘ lycheeuser@localhost ‘ und dem Passwort ‘ LycheePassword ‘ zu erstellen. Sie können die Details der Datenbank nach Bedarf ändern.

CREATE DATABASE lychee;  
GRANT ALL PRIVILEGES ON lychee. * TO lycheeuser@'localhost' IDENTIFIED BY 'LycheePassword' WITH GRANT OPTION;  
FLUSH PRIVILEGES;

Führen Sie als Nächstes die folgende Abfrage aus, um sicherzustellen, dass der Benutzer ‘ lycheeuser@localhost ‘ auf die Datenbank ‘ lychee ‘ zugreifen kann.

SHOW GRANTS FOR lycheeuser@localhost;

Wenn alles gut geht, sehen Sie die folgende Ausgabe:

check database and user

Geben Sie schließlich ‘ quit ‘ ein, um den MariaDB-Server zu verlassen.

Lychee Fotoverwaltung herunterladen

Jetzt, da Sie sowohl PHP als auch MariaDB konfiguriert haben, werden Sie den Lychee-Quellcode herunterladen und das Installationsverzeichnis sowie die ‘.env’-Datei einrichten.

Aber zuerst installieren Sie das Paket ‘unzip’ auf Ihrem Debian-System mit dem folgenden Befehl.

sudo apt install unzip -y

Gehen Sie zum Verzeichnis ‘ /var/www ‘ und laden Sie den Lychee-Quellcode mit dem Befehl ‘ wget ‘ unten herunter. Stellen Sie sicher, dass Sie den Link zur neuesten Version von der Lychee-Release-Seite abrufen.

cd /var/www/  
wget https://github.com/LycheeOrg/Lychee/releases/download/v5.5.1/Lychee.zip

Sobald der Download abgeschlossen ist, extrahieren Sie den Lychee-Quellcode mit dem Befehl ‘ unzip ‘ unten. Der Quellcode wird im Verzeichnis ‘ /var/www/Lychee ‘ extrahiert.

unzip Lychee.zip

Führen Sie als Nächstes den folgenden Befehl aus, um den Besitz des Verzeichnisses ‘ /var/www/Lychee ‘ auf den Benutzer ‘ www-data ‘ zu ändern und einige Verzeichnisse für den Benutzer ‘ www-data ‘ beschreibbar zu machen.

sudo chown -R www-data:www-data /var/www/Lychee  
sudo chmod u+rw /var/www/Lychee/{storage,bootstrap/cache/,public/dist,public/uploads,public/sym}

Führen Sie jetzt den folgenden Befehl aus, um die ‘ .env ‘ Datei für Lychee zu kopieren und sie mit dem ‘ nano ‘ Editor zu bearbeiten.

sudo -u www-data cp /var/www/Lychee/.env-example /var/www/Lychee/.env  
sudo -u www-data nano /var/www/Lychee/.env

Ändern Sie die Standard-APP_URL mit Ihrem Domainnamen und die Datenbankkonfiguration mit dem ‘ mysql ‘ und Ihren Datenbankdetails wie folgt:

# domain name  
APP_URL=https://photo.howtoforge.local  
  
# database to MariaDB/MySQL  
DB_CONNECTION=mysql  
DB_HOST=localhost  
DB_PORT=3306  
DB_DATABASE=lychee  
DB_USERNAME=lycheeuser  
DB_PASSWORD=LycheePassword

Speichern Sie die Datei und beenden Sie den Editor.

Apache-Virtualhost erstellen

In diesem Abschnitt erstellen Sie eine neue Apache-Virtualhost-Datei für die Ausführung von Lychee Fotoverwaltung.

Zuerst führen Sie den folgenden Befehl aus, um das ‘rewrite’-Modul zu aktivieren.

sudo a2enmod rewrite

Bearbeiten Sie jetzt die Apache-Konfiguration ‘ /etc/apache2/apache.conf ‘ mit ‘ nano ‘.

sudo nano /etc/apache2/apache.conf

Fügen Sie die folgende Konfiguration in die Datei ein. Dies ermöglicht es Ihnen, die ‘ .htaccess ‘ für Umschreiberegeln einzurichten.

  
 Options Indexes FollowSymLinks  
 AllowOverride All  
 Require all granted

Speichern Sie die Datei und beenden Sie den Editor.

Erstellen Sie jetzt eine neue Apache-Virtualhost-Konfiguration ‘ /etc/apache2/sites-available/lychee.conf ‘ mit dem ‘ nano ‘ Editor-Befehl unten.

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

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie die Option ‘ ServerName ‘ mit Ihrem Ziel-Domainnamen ändern. Stellen Sie sicher, dass es mit der APP_URL in der ‘ .env ‘ Datei übereinstimmt.

  
  
  ServerAdmin [email protected]  
  ServerName photo.howtoforge.local  
  
  DocumentRoot /var/www/Lychee/  
  
  ErrorLog /var/log/apache2/photo-howtoforge-local-error_log  
  CustomLog /var/log/apache2/photo-howtoforge-local-access_log common

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie sie.

Führen Sie jetzt den folgenden Befehl aus, um die Virtualhost-Datei ‘ lychee.conf ‘ zu aktivieren und Ihre Apache-Syntax zu überprüfen. Wenn Sie eine korrekte Apache-Syntax haben, sehen Sie die Ausgabe ‘ Syntax is OK ‘.

sudo a2ensite lychee.conf  
sudo apachectl configtest

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

sudo systemctl restart apache2

setup apache

Lychee mit HTTPS absichern

Wenn Sie Lychee unter einem öffentlichen Domainnamen ausführen, stellen Sie sicher, dass Sie es mit HTTPS absichern. In diesem Abschnitt installieren Sie Certbot und sichern Lychee mit SSL/TLS-Zertifikaten von Letsencrypt.

Führen Sie den folgenden Befehl aus, um Certbot und das Apache-Plugin zu installieren.

sudo apt install certbot python3-certbot-apache -y

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden ‘ certbot ‘ Befehl aus, um neue SSL/TLS-Zertifikate für die Lychee-Installation zu generieren. Stellen Sie sicher, dass Sie den Domainnamen und die E-Mail-Adresse in diesem Befehl ändern.

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

Wenn der Prozess abgeschlossen ist, sollte Ihre Lychee-Installation mit HTTPS gesichert sein und Ihre SSL/TLS-Zertifikate sind im Verzeichnis ‘/etc/letsencrypt/live/domain.com’ verfügbar.

Lychee Fotoverwaltung installieren

Besuchen Sie den Lychee-Installations-Domainnamen wie https://photo.howtoforge.local/ mit Ihrem bevorzugten Webbrowser und Sie sehen den Lychee-Installationsassistenten.

Klicken Sie auf Weiter, um mit der Installation fortzufahren.

install lychee

Stellen Sie sicher, dass jede PHP-Erweiterung installiert ist und das Apache ‘rewrite’-Modul auf Ihrem System aktiviert ist.

dependencies chek

Stellen Sie sicher, dass PHP in einigen dieser Verzeichnisse lesen, schreiben und ausführen kann.

writable directories

Überprüfen Sie die ‘.env’-Datei auf Ihrem Bildschirm und stellen Sie sicher, dass Ihr Domainname und die MariaDB-Details korrekt sind.

.env file

Jetzt wird der Installer den Anwendungsschlüssel für Lychee generieren.

app key generated

Geben Sie Ihren Admin-Benutzer, Ihre E-Mail-Adresse und Ihr Passwort ein. Und die Lychee-Installation sollte abgeschlossen sein.

create admin login

Auf der Lychee-Startseite klicken Sie auf die Anmeldeaufforderung und geben dann Ihren Admin-Benutzer und Ihr Passwort ein.

Sie können unten das Lychee-Benü-Dashboard sehen, nachdem Sie einige Bilder auf den Lychee-Server hochgeladen haben.

lychee dashboard

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von Lychee Fotoverwaltung auf dem Debian 12-Server mit dem LAMP-Stack (Linux, Apache, MariaDB und PHP) abgeschlossen. Sie haben Lychee auch mit HTTPS über Certbot und Letsencrypt gesichert.