Debian 12에 Lychee 사진 관리 시스템 설치하는 방법

Lychee는 PHP와 MySQL 기반의 오픈 소스 사진 관리 소프트웨어입니다. 이는 서버에서 사진을 안전하게 업로드, 탐색 및 공유할 수 있는 자체 호스팅 사진 관리 시스템입니다.

이 튜토리얼에서는 Debian 12 서버에 Lychee 사진 관리를 설치하는 방법을 배웁니다. Lychee를 실행하기 위해 LAMP 스택을 사용하고 Certbot과 Letsencrypt를 통해 Lychee를 HTTPS로 보호합니다.

전제 조건

시작하기 전에 다음 사항을 확인하세요:

Debian 12 서버
관리자 권한이 있는 비루트 사용자

의존성 설치

이 섹션에서는 Debian 서버에 LAMP 스택(리눅스, 아파치, 마리아DB 및 PHP)을 설치합니다. 현재 Lychee는 기본적으로 Debian 저장소에서 제공되는 PHP 8.2 이상을 지원합니다.

먼저, 아래 명령어를 실행하여 Ubuntu 패키지 인덱스를 업데이트하세요.

sudo apt update

update repo

이제 아래 명령어를 사용하여 Debian 시스템에 LAMP 스택 패키지를 설치합니다. 설치를 확인하려면 ‘ 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

install deps

설치가 완료되면 아래 명령어를 실행하여 Apache 서비스 상태를 확인하세요. Apache 웹 서버가 실행 중이고 활성화되어 있는 것을 확인할 수 있습니다.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

check apache2

이제 아래 명령어로 MariaDB 서버를 확인하세요. MariaDB 서버는 시스템에서 자동으로 실행되고 활성화되어 있어야 합니다.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

마지막으로 아래 명령어로 PHP 버전을 확인하세요. PHP 8.3이 설치되어 있는 것을 볼 수 있습니다.

php -v  
php -m

check php version

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-secure-installation ‘ 명령어를 사용하여 MariaDB 서버를 보호합니다. 그런 다음, Lychee에 사용할 새 데이터베이스와 사용자를 ‘ mariadb ‘ 클라이언트를 통해 생성합니다.

아래 ‘ mariadb-secure-installation ‘ 명령어를 실행하여 MariaDB 서버를 설정하세요.

sudo mariadb-secure-installation

이제 다음 MariaDB 구성에 대한 질문을 받게 됩니다:

루트 비밀번호가 없는 기본 MariaDB 서버 설치의 경우 비밀번호에 대한 질문이 있을 때 ENTER를 누릅니다.
MariaDB 루트 사용자에 대한 로컬 인증은 기본적으로 보호되므로, 인증 방법을 ‘unix_socket’으로 변경하라는 질문에 ‘n’을 입력합니다.
새 MariaDB 루트 비밀번호를 생성하라는 질문에 ‘Y’를 입력합니다. 그런 다음, MariaDB 루트 사용자에 대한 강력한 비밀번호를 입력하고 반복합니다.
MariaDB 루트 사용자에 대한 원격 인증을 비활성화하라는 질문에 ‘Y’를 입력하여 동의합니다.
기본 MariaDB 서버 설치에는 ‘test’ 데이터베이스가 있으며 익명 사용자가 이를 접근할 수 있습니다.
기본 데이터베이스 ‘test’를 제거하고 익명 권한을 제거하기 위해 두 설정 모두에 대해 ‘Y’를 입력합니다.
마지막으로, 테이블 권한을 다시 로드하라는 질문에 ‘Y’를 입력하여 확인합니다.

MariaDB가 구성되고 보호된 후, Lychee 설치에 사용할 새 데이터베이스와 사용자를 생성합니다.

아래 ‘ mariadb ‘ 명령어로 MariaDB 서버에 로그인합니다. 프롬프트가 나타나면 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;

모든 것이 잘 진행되면 다음과 같은 출력이 표시됩니다:

check database and user

마지막으로 ‘ quit ‘를 입력하여 MariaDB 서버에서 로그아웃합니다.

Lychee 사진 관리 다운로드

이제 PHP와 MariaDB를 구성했으므로, Lychee 소스 코드를 다운로드하고 설치 디렉토리 및 ‘.env’ 파일을 설정합니다.

먼저, 아래 명령어를 사용하여 Debian 시스템에 ‘unzip’ 패키지를 설치합니다.

sudo apt install unzip -y

‘ /var/www ‘ 디렉토리로 이동하여 아래 ‘ wget ‘ 명령어를 사용하여 Lychee 소스 코드 릴리스를 다운로드합니다. Lychee 릴리스 페이지에서 최신 버전의 링크를 가져오는 것을 잊지 마세요.

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

다운로드가 완료되면 아래 ‘ unzip ‘ 명령어를 사용하여 Lychee 소스 코드를 추출합니다. 소스 코드는 ‘ /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}

이제 아래 명령어를 실행하여 Lychee의 ‘ .env ‘ 파일을 복사하고 ‘ 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 가상 호스트 생성

이 섹션에서는 Lychee 사진 관리를 실행하기 위한 새로운 Apache 가상 호스트 파일을 생성합니다.

먼저, 아래 명령어를 실행하여 ‘rewrite’ 모듈을 활성화합니다.

sudo a2enmod rewrite

이제 ‘ nano ‘를 사용하여 Apache 구성 ‘ /etc/apache2/apache.conf ‘를 편집합니다.

sudo nano /etc/apache2/apache.conf

파일에 다음 구성을 추가합니다. 이는 ‘ .htaccess ‘를 설정하여 재작성 규칙을 설정할 수 있게 합니다.

  
 Options Indexes FollowSymLinks  
 AllowOverride All  
 Require all granted

파일을 저장하고 편집기를 종료하세요.

이제 ‘ nano ‘ 편집기를 사용하여 새로운 Apache 가상 호스트 구성 ‘ /etc/apache2/sites-available/lychee.conf ‘를 생성합니다.

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

다음 구성을 붙여넣고 ‘ ServerName ‘ 옵션을 대상 도메인 이름으로 변경합니다. ‘ .env ‘ 파일 내의 APP_URL과 동일하게 설정하세요.

  
  
  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

setup apache

HTTPS로 Lychee 보호하기

공개 도메인 이름에서 Lychee를 실행하는 경우, HTTPS로 보호해야 합니다. 이 섹션에서는 Certbot을 설치하고 Letsencrypt에서 SSL/TLS 인증서로 Lychee를 보호합니다.

아래 명령어를 실행하여 Certbot과 Apache 플러그인을 설치합니다.

sudo apt install certbot python3-certbot-apache -y

설치가 완료되면 아래 ‘ certbot ‘ 명령어를 실행하여 Lychee 설치를 위한 새로운 SSL/TLS 인증서를 생성합니다. 이 명령어에서 도메인 이름과 이메일 주소를 변경하는 것을 잊지 마세요.

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 사진 관리 설치

선호하는 웹 브라우저를 사용하여 https://photo.howtoforge.local/와 같은 Lychee 설치 도메인 이름을 방문하면 Lychee 설치 마법사를 볼 수 있습니다.

설치를 진행하려면 다음을 클릭하세요.

install lychee

모든 PHP 확장이 설치되어 있고 Apache ‘rewrite’ 모듈이 시스템에서 활성화되어 있는지 확인하세요.

dependencies chek

PHP가 일부 디렉토리 내에서 읽고, 쓰고, 실행할 수 있는지 확인하세요.

writable directories

화면에서 ‘.env’ 파일을 확인하고 도메인 이름과 MariaDB 세부정보가 올바른지 확인하세요.

.env file

이제 설치 프로그램이 Lychee의 애플리케이션 키를 생성합니다.

app key generated

관리 사용자, 이메일 주소 및 비밀번호를 입력하세요. 그러면 Lychee 설치가 완료됩니다.

create admin login

Lychee 홈페이지에서 로그인 프롬프트를 클릭한 후 관리 사용자와 비밀번호를 입력하세요.

Lychee 서버에 이미지를 업로드한 후 아래에서 Lychee 사용자 대시보드를 볼 수 있습니다.

lychee dashboard

결론

축하합니다! Debian 12 서버에 LAMP 스택(리눅스, 아파치, 마리아DB 및 PHP)으로 Lychee 사진 관리 설치를 완료했습니다. 또한 Certbot과 Letsencrypt를 통해 Lychee를 HTTPS로 보호했습니다.