Come installare il sistema di gestione foto Lychee su Debian 12

Lychee è un software di gestione foto open-source basato su PHP e MySQL. È un sistema di gestione foto auto-ospitato che ti consente di caricare, sfogliare e condividere foto in modo sicuro sul tuo server.

In questo tutorial, imparerai come installare Lychee Photo Management su un server Debian 12. Utilizzerai il LAMP Stack per eseguire Lychee e proteggere Lychee con HTTPS tramite Certbot e Letsencrypt.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

• Un server Debian 12
• Un utente non root con privilegi di amministratore

Installazione delle dipendenze

In questa sezione, installerai il LAMP Stack (Linux, Apache, MariaDB e PHP) sul server Debian. Per ora, Lychee supporta PHP 8.2 o superiore, che è disponibile per impostazione predefinita nel repository Debian.

Prima di tutto, esegui il comando qui sotto per aggiornare l’indice dei pacchetti di Ubuntu.

sudo apt update

Ora installa i pacchetti del LAMP Stack sul tuo sistema Debian con il seguente comando. Inserisci ‘ Y ‘ per confermare l’installazione.

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

Dopo che l’installazione è completata, esegui il comando qui sotto per controllare lo stato del servizio Apache. Vedrai che il server web Apache è in esecuzione e abilitato.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Ora controlla il server MariaDB con il seguente comando. Il server MariaDB dovrebbe essere in esecuzione e abilitato automaticamente sul tuo sistema.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Infine, controlla la versione di PHP con il seguente - Puoi vedere che PHP 8.3 è installato.

php -v  
php -m

Configurazione di PHP

Dopo aver installato le dipendenze, configurerai PHP modificando il file ‘php.ini’ e riavviando il server web Apache per applicare le modifiche.

Apri il file ‘ /etc/php/8.3/apache2/php.ini ‘ con l’editor ‘ nano ‘.

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

Cambia la configurazione predefinita in questo modo - Assicurati di regolare le opzioni ‘ memory_limit ‘ e ‘ date.timezone ‘ di conseguenza.

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

Quando hai finito, salva il file ed esci dall’editor.

Ora esegui il comando ‘ systemctl ‘ qui sotto per riavviare il server web Apache e applicare le tue modifiche.

sudo systemctl restart apache2

Configurazione del server MariaDB

Con PHP configurato, proteggerai il server MariaDB utilizzando il comando ‘ mariadb-secure-installation ‘. E poi, creerai un nuovo database e un utente che saranno utilizzati per Lychee tramite il client ‘ mariadb ‘.

Esegui il comando ‘ mariadb-secure-installation ‘ qui sotto per configurare il tuo server MariaDB.

sudo mariadb-secure-installation

Ora ti verrà chiesto di configurare il MariaDB come segue:

• Per l’installazione predefinita del server MariaDB senza una password root, premi INVIO quando ti viene chiesto della password.
• L’autenticazione locale per gli utenti root di MariaDB è protetta per impostazione predefinita, inserisci ‘n’ quando ti viene chiesto di cambiare il metodo di autenticazione in ‘unix_socket’.
• Inserisci ‘Y’ per creare una nuova password root di MariaDB. Poi, inserisci la password forte per il tuo utente root di MariaDB e ripetila.
• Quando ti viene chiesto di disabilitare l’autenticazione remota per l’utente root di MariaDB, inserisci ‘Y’ per confermare.
• L’installazione predefinita del server MariaDB viene fornita con il database ‘test’ e consente a un utente anonimo di accedervi.
• Inserisci ‘Y’ per entrambe le impostazioni per rimuovere il database predefinito ‘test’ e rimuovere il privilegio anonimo.
• Infine, inserisci ‘Y’ per confermare il ricaricamento dei privilegi delle tabelle.

Dopo che MariaDB è stato configurato e protetto, creerai un nuovo database e un utente che saranno utilizzati dall’installazione di Lychee.

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

sudo mariadb -u root -p

Ora esegui le seguenti query per creare un nuovo database ‘ lychee ‘ con l’utente ‘ lycheeuser@localhost ‘ e la password ‘ LycheePassword ‘. Puoi cambiare i dettagli del database come necessario.

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

Successivamente, esegui la query qui sotto per assicurarti che l’utente ‘ lycheeuser@localhost ‘ possa accedere al database ‘ lychee ‘.

SHOW GRANTS FOR lycheeuser@localhost;

Se tutto va bene, vedrai il seguente output:

Infine, digita ‘ quit ‘ per uscire dal server MariaDB.

Download di Lychee Photo Management

Ora che hai configurato sia PHP che MariaDB, scaricherai il codice sorgente di Lychee e imposterai la directory di installazione e il file ‘.env’.

Ma prima, installa il pacchetto ‘unzip’ sul tuo sistema Debian con il seguente comando.

sudo apt install unzip -y

Vai alla directory ‘ /var/www ‘ e scarica il codice sorgente di Lychee utilizzando il comando ‘ wget ‘ qui sotto. Assicurati di prendere il link per l’ultima versione dalla pagina di rilascio di Lychee.

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

Una volta scaricato, estrai il codice sorgente di Lychee con il comando ‘ unzip ‘ qui sotto. Il codice sorgente sarà estratto nella directory ‘ /var/www/Lychee ‘.

unzip Lychee.zip

Successivamente, esegui il seguente comando per cambiare la proprietà della directory ‘ /var/www/Lychee ‘ all’utente ‘ www-data ‘, e rendere alcune directory scrivibili per l’utente ‘ www-data ‘.

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}

Ora esegui il seguente comando per copiare il file ‘ .env ‘ per Lychee e modificarlo utilizzando l’editor ‘ nano ‘.

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

Cambia il APP_URL predefinito con il tuo nome di dominio e la configurazione del database con il ‘ mysql ‘ e i dettagli del tuo database come segue:

# nome di dominio  
APP_URL=https://photo.howtoforge.local  
  
# database per MariaDB/MySQL  
DB_CONNECTION=mysql  
DB_HOST=localhost  
DB_PORT=3306  
DB_DATABASE=lychee  
DB_USERNAME=lycheeuser  
DB_PASSWORD=LycheePassword

Salva il file ed esci dall’editor.

Creazione dell’host virtuale Apache

In questa sezione, creerai un nuovo file di host virtuale Apache per eseguire Lychee Photo Management.

Prima di tutto, esegui il comando qui sotto per attivare il modulo ‘rewrite’.

sudo a2enmod rewrite

Ora modifica la configurazione di Apache ‘ /etc/apache2/apache.conf ‘ utilizzando ‘ nano ‘.

sudo nano /etc/apache2/apache.conf

Aggiungi la seguente configurazione al file. Questo ti consente di impostare il ‘ .htaccess ‘ per le regole di riscrittura.

  
 Options Indexes FollowSymLinks  
 AllowOverride All  
 Require all granted  

Salva il file ed esci dall’editor.

Ora crea una nuova configurazione di host virtuale Apache ‘ /etc/apache2/sites-available/lychee.conf ‘ con il comando dell’editor ‘ nano ‘ qui sotto.

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

Incolla la seguente configurazione e assicurati di cambiare l’opzione ‘ ServerName ‘ con il tuo nome di dominio target. Assicurati che sia lo stesso di APP_URL all’interno del file ‘ .env ‘.

  
  
  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  
  

Quando hai finito, salva ed esci dal file.

Ora esegui il comando qui sotto per attivare il file di host virtuale ‘ lychee.conf ‘ e verificare la sintassi di Apache. Se hai una sintassi Apache corretta, vedrai un output ‘ Syntax is OK ‘.

sudo a2ensite lychee.conf  
sudo apachectl configtest

Infine, esegui il seguente comando per riavviare Apache e applicare le tue modifiche.

sudo systemctl restart apache2

Proteggere Lychee con HTTPS

Se stai eseguendo Lychee su un nome di dominio pubblico, assicurati di proteggerlo con HTTPS. In questa sezione, installerai Certbot e proteggerai Lychee con certificati SSL/TLS da Letsencrypt.

Esegui il comando qui sotto per installare Certbot e il plugin Apache.

sudo apt install certbot python3-certbot-apache -y

Dopo che l’installazione è completata, esegui il seguente comando ‘ certbot ‘ per generare nuovi certificati SSL/TLS per l’installazione di Lychee. Assicurati di cambiare il nome di dominio e l’indirizzo email in questo comando.

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

Quando il processo è completato, la tua installazione di Lychee dovrebbe essere protetta con HTTPS e i tuoi certificati SSL/TLS saranno disponibili nella directory ‘/etc/letsencrypt/live/domain.com’.

Installazione di Lychee Photo Management

Visita il nome di dominio di installazione di Lychee come https://photo.howtoforge.local/ utilizzando il tuo browser web preferito e vedrai la procedura guidata di installazione di Lychee.

Clicca su Avanti per procedere con l’installazione.

Assicurati che ogni estensione PHP sia installata e che il modulo ‘rewrite’ di Apache sia abilitato sul tuo sistema.

Assicurati che PHP possa leggere, scrivere ed eseguire all’interno di alcune di quelle directory.

Controlla il file ‘.env’ sul tuo schermo e assicurati che il tuo nome di dominio e i dettagli di MariaDB siano corretti.

Ora l’installatore genererà la chiave dell’applicazione per Lychee.

Inserisci il tuo utente admin, indirizzo email e password. E l’installazione di Lychee dovrebbe essere completata.

Nella home page di Lychee, clicca sul prompt di accesso e poi inserisci il tuo utente admin e la password.

Puoi vedere qui sotto il dashboard utente di Lychee dopo aver caricato alcune immagini sul server di Lychee.

Conclusione

Congratulazioni! Hai completato l’installazione di Lychee Photo Management sul server Debian 12 con il LAMP Stack (Linux, Apache, MariaDB e PHP). Hai anche protetto Lychee con HTTPS tramite Certbot e Letsencrypt.