Как установить систему управления фотографиями Lychee на Debian 12

Lychee — это программное обеспечение для управления фотографиями с открытым исходным кодом, основанное на PHP и MySQL. Это саморазмещаемая система управления фотографиями, которая позволяет вам безопасно загружать, просматривать и делиться фотографиями на вашем сервере.

В этом руководстве вы узнаете, как установить систему управления фотографиями Lychee на сервер Debian 12. Вы будете использовать стек LAMP для запуска Lychee и защищать Lychee с помощью HTTPS через Certbot и Letsencrypt.

Предварительные требования

Перед тем как начать, убедитесь, что у вас есть следующее:

Сервер Debian 12
Непривилегированный пользователь с правами администратора

Установка зависимостей

В этом разделе вы установите стек LAMP (Linux, Apache, MariaDB и PHP) на сервер Debian. На данный момент Lychee поддерживает PHP 8.2 или выше, который доступен по умолчанию в репозитории Debian.

Сначала выполните команду ниже, чтобы обновить индекс пакетов Ubuntu.

sudo apt update

обновить репозиторий

Теперь установите пакеты стека LAMP на вашу систему Debian с помощью следующей команды. Введите ‘ Y ‘, чтобы подтвердить установку.

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

установить зависимости

После завершения установки выполните команду ниже, чтобы проверить статус службы Apache. Вы увидите, что веб-сервер Apache работает и включен.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

проверить apache2

Теперь проверьте сервер MariaDB с помощью следующей команды. Сервер MariaDB должен работать и автоматически включаться на вашей системе.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

проверить mariadb

Наконец, проверьте версию PHP с помощью следующей команды - вы можете увидеть, что PHP 8.3 установлен.

php -v  
php -m

проверить версию php

Настройка PHP

После установки зависимостей вы настроите PHP, отредактировав файл ‘php.ini’ и перезапустив веб-сервер Apache, чтобы изменения вступили в силу.

Откройте файл ‘ /etc/php/8.3/apache2/php.ini ‘ с помощью редактора ‘ nano ‘.

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

Измените конфигурацию по умолчанию следующим образом - убедитесь, что вы настроили параметры ‘ memory_limit ‘ и ‘ date.timezone ‘ соответственно.

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

Когда закончите, сохраните файл и выйдите из редактора.

Теперь выполните команду ‘ systemctl ‘ ниже, чтобы перезапустить веб-сервер Apache и применить ваши изменения.

sudo systemctl restart apache2

Настройка сервера MariaDB

С настроенным PHP вы будете защищать сервер MariaDB с помощью команды ‘ mariadb-secure-installation ‘. Затем создадите новую базу данных и пользователя, которые будут использоваться для Lychee через клиент ‘ mariadb ‘.

Выполните команду ‘ mariadb-secure-installation ‘ ниже, чтобы настроить ваш сервер MariaDB.

sudo mariadb-secure-installation

Теперь вам будут заданы следующие настройки MariaDB:

Для установки сервера MariaDB по умолчанию без пароля root нажмите ENTER, когда вас спросят о пароле.
Локальная аутентификация для пользователей root MariaDB по умолчанию защищена, введите ‘n’, когда вас спросят о смене метода аутентификации на ‘unix_socket’.
Введите ‘Y’, чтобы создать новый пароль root для MariaDB. Затем введите надежный пароль для вашего пользователя root MariaDB и повторите его.
Когда вас спросят о том, чтобы отключить удаленную аутентификацию для пользователя root MariaDB, введите ‘Y’, чтобы согласиться.
Установка сервера MariaDB по умолчанию включает базу данных ‘test’ и позволяет анонимному пользователю получить к ней доступ.
Введите ‘Y’ для обоих параметров, чтобы удалить базу данных по умолчанию ‘test’ и удалить анонимные привилегии.
Наконец, введите ‘Y’, чтобы подтвердить перезагрузку привилегий таблиц.

После настройки и защиты MariaDB вы создадите новую базу данных и пользователя, которые будут использоваться при установке Lychee.

Войдите на сервер MariaDB с помощью команды ‘ mariadb ‘ ниже. Введите ваш пароль root MariaDB, когда вас попросят.

sudo mariadb -u root -p

Теперь выполните следующие запросы, чтобы создать новую базу данных ‘ lychee ‘ с пользователем ‘ lycheeuser@localhost ‘ и паролем ‘ LycheePassword ‘. Вы можете изменить данные базы данных по мере необходимости.

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

Затем выполните запрос ниже, чтобы убедиться, что пользователь ‘ lycheeuser@localhost ‘ может получить доступ к базе данных ‘ lychee ‘.

SHOW GRANTS FOR lycheeuser@localhost;

Если все прошло хорошо, вы увидите следующий вывод:

проверить базу данных и пользователя

Наконец, введите ‘ quit ‘, чтобы выйти из сервера MariaDB.

Загрузка системы управления фотографиями Lychee

Теперь, когда вы настроили и PHP, и MariaDB, вы загрузите исходный код Lychee и настроите каталог установки и файл ‘.env’.

Но сначала установите пакет ‘unzip’ на вашу систему Debian с помощью следующей команды.

sudo apt install unzip -y

Перейдите в каталог ‘ /var/www ‘ и загрузите релиз исходного кода Lychee, используя команду ‘ wget ‘ ниже. Убедитесь, что вы получили ссылку на последнюю версию со страницы релизов Lychee.

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

После загрузки извлеките исходный код Lychee с помощью команды ‘ unzip ‘ ниже. Исходный код будет извлечен в каталог ‘ /var/www/Lychee ‘.

unzip Lychee.zip

Затем выполните следующую команду, чтобы изменить владельца каталога ‘ /var/www/Lychee ‘ на пользователя ‘ www-data ‘, и сделать некоторые каталоги доступными для записи для пользователя ‘ 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}

Теперь выполните следующую команду, чтобы скопировать файл ‘ .env ‘ для Lychee и изменить его с помощью редактора ‘ nano ‘.

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

Измените значение по умолчанию APP_URL на ваше доменное имя и конфигурацию базы данных на ‘ mysql ‘ и ваши данные базы данных следующим образом:

# доменное имя  
APP_URL=https://photo.howtoforge.local  
  
# база данных для MariaDB/MySQL  
DB_CONNECTION=mysql  
DB_HOST=localhost  
DB_PORT=3306  
DB_DATABASE=lychee  
DB_USERNAME=lycheeuser  
DB_PASSWORD=LycheePassword

Сохраните файл и выйдите из редактора.

Создание виртуального хоста Apache

В этом разделе вы создадите новый файл виртуального хоста Apache для работы системы управления фотографиями Lychee.

Сначала выполните команду ниже, чтобы активировать модуль ‘rewrite’.

sudo a2enmod rewrite

Теперь отредактируйте конфигурацию Apache ‘ /etc/apache2/apache.conf ‘ с помощью ‘ nano ‘.

sudo nano /etc/apache2/apache.conf

Добавьте следующую конфигурацию в файл. Это позволит вам настроить ‘ .htaccess ‘ для правил переписывания.

  
 Options Indexes FollowSymLinks  
 AllowOverride All  
 Require all granted

Сохраните файл и выйдите из редактора.

Теперь создайте новую конфигурацию виртуального хоста Apache ‘ /etc/apache2/sites-available/lychee.conf ‘ с помощью команды редактора ‘ nano ‘ ниже.

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

Вставьте следующую конфигурацию и убедитесь, что вы изменили параметр ‘ ServerName ‘ на ваше целевое доменное имя. Убедитесь, что оно совпадает с APP_URL в файле ‘ .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

Когда закончите, сохраните и выйдите из файла.

Теперь выполните команду ниже, чтобы активировать файл виртуального хоста ‘ lychee.conf ‘ и проверить синтаксис Apache. Если у вас правильный синтаксис Apache, вы увидите вывод ‘ Syntax is OK ‘.

sudo a2ensite lychee.conf  
sudo apachectl configtest

Наконец, выполните следующую команду, чтобы перезапустить Apache и применить ваши изменения.

sudo systemctl restart apache2

настройка apache

Защита Lychee с помощью HTTPS

Если вы запускаете Lychee на публичном доменном имени, убедитесь, что вы защитили его с помощью HTTPS. В этом разделе вы установите Certbot и защитите Lychee с помощью SSL/TLS сертификатов от Letsencrypt.

Выполните команду ниже, чтобы установить Certbot и плагин Apache.

sudo apt install certbot python3-certbot-apache -y

После завершения установки выполните следующую команду ‘ certbot ‘, чтобы сгенерировать новые SSL/TLS сертификаты для установки Lychee. Убедитесь, что вы изменили доменное имя и адрес электронной почты в этой команде.

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

Когда процесс завершится, ваша установка Lychee должна быть защищена с помощью HTTPS, а ваши SSL/TLS сертификаты будут доступны в каталоге ‘/etc/letsencrypt/live/domain.com’.

Установка системы управления фотографиями Lychee

Посетите доменное имя установки Lychee, например https://photo.howtoforge.local/, используя ваш предпочтительный веб-браузер, и вы увидите мастер установки Lychee.

Нажмите Далее, чтобы продолжить установку.

установить lychee

Убедитесь, что все расширения PHP установлены, а модуль ‘rewrite’ Apache включен на вашей системе.

проверка зависимостей

Убедитесь, что PHP может читать, записывать и выполнять в некоторых из этих каталогов.

каталоги с доступом на запись

Проверьте файл ‘.env’ на экране и убедитесь, что ваше доменное имя и данные MariaDB правильные.

файл .env

Теперь установщик сгенерирует ключ приложения для Lychee.

ключ приложения сгенерирован

Введите вашего администратора, адрес электронной почты и пароль. Установка Lychee должна быть завершена.

создать вход администратора

На главной странице Lychee нажмите на запрос входа, а затем введите вашего администратора и пароль.

вход в lychee

Вы можете увидеть ниже панель управления Lychee после загрузки некоторых изображений на сервер Lychee.

панель управления lychee

Заключение

Поздравляем! Вы завершили установку системы управления фотографиями Lychee на сервер Debian 12 с использованием стека LAMP (Linux, Apache, MariaDB и PHP). Вы также защитили Lychee с помощью HTTPS через Certbot и Letsencrypt.