Debian 12にLychee写真管理システムをインストールする方法

Lycheeは、PHPとMySQLに基づいたオープンソースの写真管理ソフトウェアです。これは自己ホスト型の写真管理システムで、サーバー上で安全に写真をアップロード、ブラウズ、共有することができます。

このチュートリアルでは、Debian 12サーバーにLychee写真管理をインストールする方法を学びます。Lycheeを実行するためにLAMPスタックを使用し、CertbotとLetsencryptを通じてHTTPSでLycheeを保護します。

前提条件

始める前に、以下のものを用意してください：

Debian 12サーバー
管理者権限を持つ非ルートユーザー

依存関係のインストール

このセクションでは、DebianサーバーにLAMPスタック（Linux、Apache、MariaDB、PHP）をインストールします。現在、LycheeはPHP 8.2以上をサポートしており、これはDebianリポジトリにデフォルトで用意されています。

まず、以下のコマンドを実行してUbuntuパッケージインデックスを更新します。

sudo apt update

update repo

次に、以下のコマンドを使用して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

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’ファイルを編集してPHPを設定し、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サーバーインストールには’database ‘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スタック（Linux、Apache、MariaDB、PHP）を使用してLychee写真管理のインストールが完了しました。また、CertbotとLetsencryptを通じてLycheeをHTTPSで保護しました。