Ubuntuサーバー上でAmpacheサーバーを実行する方法

Ampache を使用すると、Ubuntu サーバーをブラウザや互換性のあるアプリで再生できるセルフホスト型の音楽ライブラリとして利用できます。このチュートリアルでは、Ubuntu Server 26.04 LTS、Apache、MariaDB、および Ampache 8.3.0 を使用します。Ampache 8 は PHP 8.5 以降を必要とするため、古いバージョンの Ubuntu を使用する場合は、公式のインストール要件を確認してください。

サーバーをインターネット経由で公開する場合は、sudoアカウント、音楽を保存するための十分なディスク容量、ドメイン名が必要です。セットアップが完了するまでは、インストーラーを信頼できるネットワークのみに限定してください。

UbuntuサーバーにAmpacheをインストールする

1. Apache、MariaDB、PHP、およびオーディオツールをインストールします。

Ubuntuをアップデートし、AmpacheがチェックするサーバーコンポーネントとPHP拡張機能をインストールしてください。FFmpegとオーディオユーティリティは、メディア処理とトランスコーディングをサポートします。

sudo apt update
sudo apt upgrade -y
sudo apt install apache2 mariadb-server php8.5 php8.5-cli php8.5-curl php8.5-gd php8.5-intl php8.5-mbstring php8.5-mysql php8.5-xml php8.5-zip ffmpeg flac lame vorbis-tools inotify-tools zip unzip curl
sudo systemctl enable --now apache2 mariadb

Ubuntu 26.04 のアーカイブには PHP 8.5 が含まれています。サーバーで別の PHP バージョンが提供されている場合は、そのバージョンと互換性のある Ampache リリースを選択するか、Ampache のバージョン固有のガイドに従ってください。バージョン指定のないphpパッケージが Ampache 8 の要件を満たしていると想定しないでください。

2. データベースと専用ユーザーを作成する

MariaDBのローカル管理シェルを開きます。アプリケーションアカウントはAmpacheのデータベースにのみアクセスでき、UbuntuのローカルMariaDB管理は別個のものとして扱われます。

sudo mariadb

MariaDBのプロンプトが表示されたら、データベースを作成し、サンプルパスワードを長くて固有のパスワードに置き換えてください。SQLで正しくエスケープしない限り、パスワードにシングルクォートを使用しないでください。

CREATE DATABASE ampache CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ampacheuser'@'localhost' IDENTIFIED BY 'REPLACE_WITH_A_LONG_RANDOM_PASSWORD';
GRANT ALL PRIVILEGES ON ampache.* TO 'ampacheuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

3. Ampacheのリリースアーカイブをダウンロードする

公式リリースページには、バージョン管理されたアーカイブが一覧表示されています。以下の例では、Ampache 8.3.0とそのPHP 8.5ビルドを固定しています。インストール時に新しいリリースが利用可能な場合は、バージョンとファイル名の両方を更新してください。

cd /tmp
wget https://github.com/ampache/ampache/releases/download/8.3.0/ampache-8.3.0_php8.5.zip
sudo mkdir -p /var/www/ampache
sudo unzip ampache-8.3.0_php8.5.zip -d /var/www/ampache
sudo chown -R root:www-data /var/www/ampache
sudo chmod -R g+rX /var/www/ampache
sudo chown www-data:www-data /var/www/ampache/config
sudo chmod 775 /var/www/ampache/config

ウェブサーバーは、セットアップ時に設定ディレクトリを書き込む必要があります。その他のアプリケーションファイルは、rootユーザーが所有し、Apacheが読み取り可能な状態にしておくことができます。

4. ApacheをAmpacheの公開ディレクトリに向ける

AmpacheのWebルートはpublicサブディレクトリです。Ampache専用の新規サーバーでは、デフォルトの仮想ホストを編集してください。Apacheが既に他のサイトをホストしている場合は、別の仮想ホストを使用してください。

sudo nano /etc/apache2/sites-available/000-default.conf

既存の<VirtualHost *:80>ブロック内に、サーバー名とドキュメントルートを設定し、ディレクトリルールを追加します。

ServerName ampache.example.com
DocumentRoot /var/www/ampache/public

<Directory /var/www/ampache/public>
    AllowOverride All
    Require all granted
</Directory>

Apacheのリライト機能を有効にし、Ampacheに同梱されているリライトファイルを生成し、設定をテストし、Apacheを再起動します。

sudo a2enmod rewrite
cd /var/www/ampache
sudo php bin/installer htaccess -e -p
sudo apache2ctl configtest
sudo systemctl reload apache2

このAllowOverride All設定により、Apache はこれらのファイルを読み取ることができます。Ampache は、リライトが利用できない場合、ストリーミングとその API が 404 エラーを返す可能性があると警告しています。カスタム仮想ホストを使用している場合は、リライトルールガイドを参照してください。

5. Ampacheインストーラーでサーバーを確認する

信頼できるネットワーク上のコンピュータから、を開きますhttp://ampache.example.com/install.php。DNSを設定していない場合は、代わりにサーバーのプライベートIPアドレスを使用してください。言語を選択し、「設定の開始」を選択して、要件ページを確認します。続行する前に、不足しているPHPモジュールをすべて解決し、必要に応じて対応するphp8.5-パッケージをインストールしてApacheを再起動してください。

6. データベースに接続し、設定を書き込む

localhostデータベースホスト、ampacheデータベース名、および以前に作成した認証情報を入力しますampacheuser。MariaDB の root アカウントではなく、この専用アカウントを使用してください。標準インストールタイプを選択します。Ampache でオーディオをトランスコードする場合は、トランスコードオプションで FFmpeg を選択します。そうでない場合は、トランスコードを無効のままにします。[設定の作成]を選択して設定ファイルを保存します。

7. Ampache管理者アカウントを作成する

強力なAmpache管理者ユーザー名とパスワードを作成してください。これはAmpacheで音楽とユーザーを管理するために使用するアカウントで、UbuntuのログインアカウントやMariaDBアカウントとは別です。インストーラーがデータベースの更新を適用したら、サインインしてください。

8. 音楽をカタログとして追加する

音楽フォルダをApacheが読み取れるようにします。ファイルが実際に存在するパスを使用してください。例では、新しいライブラリディレクトリを作成します。

sudo mkdir -p /srv/music
sudo chgrp -R www-data /srv/music
sudo chmod -R g+rX /srv/music

トラックをそこにコピーまたはマウントしてから、Ampache 管理者としてサインインします。管理メニューを開き、「カタログの追加」を選択します。 などの名前を入力しMusic、 のフルパスを設定し/srv/music、ローカルの音楽カタログを選択して追加します。 Ampache がファイルを読み込めるように更新を実行します。カタログのメンテナンスと権限については、カタログガイドを参照してください。

安全なリモートアクセスを確保し、ライブラリを最新の状態に保つ

インターネットからアクセス可能なサーバーの場合、ドメインのDNSレコードをそのサーバーに向け、アドレスを共有する前にHTTPSを設定してください。AmpacheのUbuntuガイドでは、ApacheでCertbotを使用しています。

sudo apt install snapd
sudo snap install certbot --classic
sudo certbot --apache -d ampache.example.com

証明書をインストールしたら、AmpacheがHTTPSリンクを生成するように設定しますforce_ssl = "true"。UFW/var/www/ampache/config/ampache.cfg.phpでは、ファイアウォールを有効にする前にサーバーのSSHポートを許可し、次にポート80と443のWebトラフィックを許可します。MariaDBのポート3306はパブリックインターネットからアクセスできないようにしておきます。Ubuntuのファイアウォールに関するドキュメントには、UFWルールが記載されています。

音楽スキャンで何も見つからない場合は、カタログパスが正しいこと、アカウントがwww-dataファイルを読み取り、各ディレクトリを走査できることを確認してください。定期的なカタログ更新やその他のスケジュールされたタスクについては、Ampache のcron ジョブを設定してください。