如何在 Ubuntu 伺服器上執行 Ampache 伺服器

Ampache 可以將 Ubuntu 伺服器變成一個自架的音樂庫，您可以在瀏覽器或相容的應用程式中播放音樂。本教學使用 Ubuntu Server 26.04 LTS、Apache、MariaDB 和 Ampache 8.3.0。 Ampache 8 需要 PHP 8.5 或更高版本，因此在使用較舊的 Ubuntu 版本之前，請務必查看官方安裝要求。

你需要一個 sudo 帳戶、足夠的磁碟空間來存放你的音樂文件，如果你打算讓伺服器可以透過公共互聯網訪問，還需要一個網域。在安裝完成之前，請將安裝程式限制在受信任的網路中。

在 Ubuntu 伺服器上安裝 Amappache

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 的本機管理 shell。應用程式帳戶將僅有權存取 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

Web 伺服器需要在安裝過程中寫入設定目錄。其餘應用程式檔案可以保留 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 重寫功能，產生 Apache 自帶的重寫文件，測試配置，然後重新載入 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 位址。選擇一種語言，點選「開始設定」php8.5- ，然後查看要求頁面。在繼續之前，請確保已解決所有缺少的 PHP 模組；如有需要，請安裝相應的軟體包並重新啟動 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 指南使用 Certbot 和 Apache：

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

憑證安裝完成後，請force_ssl = "true"進行設置，/var/www/ampache/config/ampache.cfg.php使 Ampache 產生 HTTPS 連結。在 UFW 防火牆中，先允許伺服器的 SSH 端口，然後再啟用防火牆，之後再允許 80 和 443 端口的 Web 流量。保持 MariaDB 的 3306 連接埠對公網關閉。 Ubuntu 的防火牆文件中包含了 UFW 規則的相關說明。

如果音樂掃描未發現任何內容，請確認目錄路徑是否正確，以及帳戶www-data是否具有讀取檔案和遍歷每個目錄的權限。對於定期刷新目錄和其他排程任務，請設定 Ampache 的cron 作業。