Wie man einen Ampache-Server auf einem Ubuntu-Server ausführt

Ampache verwandelt einen Ubuntu-Server in eine selbstgehostete Musikbibliothek, die Sie im Browser oder in einer kompatiblen Anwendung abspielen können. Diese Anleitung verwendet Ubuntu Server 26.04 LTS, Apache, MariaDB und Ampache 8.3.0. Ampache 8 benötigt PHP 8.5 oder neuer. Prüfen Sie daher die offiziellen Installationsvoraussetzungen , bevor Sie eine ältere Ubuntu-Version verwenden.

Sie benötigen einen sudo-Account, ausreichend Speicherplatz für Ihre Musik und einen Domainnamen, falls der Server über das öffentliche Internet erreichbar sein soll. Beschränken Sie die Installation auf ein vertrauenswürdiges Netzwerk, bis die Einrichtung abgeschlossen ist.

Ampache auf einem Ubuntu-Server installieren

1. Installieren Sie Apache, MariaDB, PHP und Audio-Tools.

Aktualisieren Sie Ubuntu und installieren Sie die Serverkomponenten und PHP-Erweiterungen. Ampache prüft, ob FFmpeg und die Audio-Dienstprogramme Medienverarbeitung und Transkodierung unterstützen.

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 enthält PHP 8.5 in seinem Archiv. Falls Ihr Server eine andere PHP-Version anbietet, wählen Sie eine mit dieser Version kompatible Ampache-Version oder folgen Sie der versionsspezifischen Anleitung von Ampache. Gehen Sie nicht davon aus, dass ein phpPaket ohne Versionsangabe die Anforderungen von Ampache 8 erfüllt.

2. Erstellen Sie eine Datenbank und einen dedizierten Benutzer.

Öffnen Sie die lokale administrative Shell von MariaDB. Das Anwendungskonto hat nur Zugriff auf die Ampache-Datenbank, während die lokale MariaDB-Administration von Ubuntu separat bleibt.

sudo mariadb

Erstellen Sie an der MariaDB-Eingabeaufforderung die Datenbank und ersetzen Sie das Beispielpasswort durch ein langes, eindeutiges Passwort. Vermeiden Sie einfache Anführungszeichen im Passwort, es sei denn, Sie maskieren diese korrekt in 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. Laden Sie das Ampache-Release-Archiv herunter.

Auf der offiziellen Release-Seite sind versionierte Archive aufgelistet. Das folgende Beispiel verwendet Ampache 8.3.0 und dessen PHP 8.5-Build; falls zum Zeitpunkt der Installation eine neuere Version verfügbar ist, aktualisieren Sie bitte sowohl die Versionsnummer als auch den Dateinamen.

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

Der Webserver muss das Konfigurationsverzeichnis während der Einrichtung beschreiben. Die übrigen Anwendungsdateien können im Besitz von root bleiben und für Apache lesbar sein.

4. Apache auf das öffentliche Verzeichnis von Ampache verweisen.

Das Web-Root-Verzeichnis von Ampache ist das publicUnterverzeichnis. Bearbeiten Sie auf einem neu eingerichteten Server, der ausschließlich für Ampache vorgesehen ist, den Standard-Virtual-Host; verwenden Sie einen separaten Virtual-Host, falls Apache bereits andere Websites bedient.

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

Innerhalb des bestehenden <VirtualHost *:80>Blocks legen Sie Ihren Servernamen und Ihr Dokumentenverzeichnis fest und fügen dann die Verzeichnisregeln hinzu:

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

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

Apache-Rewrite aktivieren, die mit Ampache mitgelieferten Rewrite-Dateien generieren, die Konfiguration testen und Apache neu laden:

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

Diese AllowOverride AllEinstellung ermöglicht es Apache, diese Dateien zu lesen. Ampache weist darauf hin, dass Streaming und seine APIs 404-Fehler zurückgeben können, wenn das Umschreiben von URLs nicht verfügbar ist; Informationen zu den Umschreibungsregeln finden Sie in der Ampache-Dokumentation, falls Sie einen benutzerdefinierten virtuellen Host verwenden.

5. Überprüfen Sie den Server im Ampache-Installationsprogramm.

Öffnen Sie von einem Computer in Ihrem vertrauenswürdigen Netzwerk aus die entsprechende URL http://ampache.example.com/install.php. Falls Sie DNS nicht konfiguriert haben, verwenden Sie stattdessen die private IP-Adresse des Servers. Wählen Sie eine Sprache aus, klicken Sie auf „Konfiguration starten“ und lesen Sie die Seite mit den Systemvoraussetzungen. Schließen Sie alle fehlenden PHP-Module, bevor Sie fortfahren; installieren Sie php8.5-gegebenenfalls das passende Paket und starten Sie Apache neu.

6. Datenbankverbindung herstellen und Konfiguration schreiben

Geben Sie localhostals Datenbankhost, ampacheals Datenbanknamen und die ampacheuserzuvor erstellten Anmeldeinformationen ein. Verwenden Sie dieses dedizierte Konto anstelle des MariaDB-Root-Kontos. Wählen Sie den Standardinstallationstyp. Wenn Ampache Audio transkodieren soll, wählen Sie unter den Transkodierungsoptionen FFmpeg aus; andernfalls lassen Sie die Transkodierung deaktiviert. Wählen Sie „Konfiguration erstellen“ , um die Konfigurationsdatei zu speichern.

7. Erstellen Sie das Ampache-Administratorkonto.

Erstellen Sie einen sicheren Ampache-Administratorbenutzernamen und ein sicheres Passwort. Mit diesem Konto verwalten Sie Musik und Benutzer in Ampache; es ist getrennt von Ihrem Ubuntu-Login und dem MariaDB-Konto. Lassen Sie den Installer alle Datenbankaktualisierungen durchführen und melden Sie sich anschließend an.

8. Füge deine Musik als Katalog hinzu

Machen Sie den Musikordner für Apache lesbar. Verwenden Sie den Pfad, unter dem sich Ihre Dateien tatsächlich befinden; das Beispiel erstellt ein neues Bibliotheksverzeichnis:

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

Kopieren oder binden Sie Ihre Titel dorthin ein und melden Sie sich anschließend als Ampache-Administrator an. Öffnen Sie das Admin-Menü und wählen Sie „Katalog hinzufügen“ . Geben Sie einen Namen ein Music, legen Sie den vollständigen Pfad fest /srv/music, wählen Sie einen lokalen Musikkatalog aus und fügen Sie ihn hinzu. Führen Sie ein Update durch, damit Ampache die Dateien erkennt. Die Kataloganleitung erklärt die Katalogverwaltung und die Berechtigungen.

Sichern Sie den Fernzugriff und halten Sie die Bibliothek auf dem neuesten Stand

Für einen Server, der über das Internet erreichbar ist, müssen Sie den DNS-Eintrag Ihrer Domain auf den Server verweisen und HTTPS konfigurieren, bevor Sie die Adresse weitergeben. Die Ubuntu-Anleitung von Ampache verwendet Certbot mit Apache.

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

Nach der Installation des Zertifikats konfigurieren Sie Ampache so, dass HTTPS-Links generiert werden. Aktivieren Sie force_ssl = "true"in /var/www/ampache/config/ampache.cfg.phpUFW den SSH-Port des Servers, bevor Sie die Firewall aktivieren, und erlauben Sie anschließend Webverkehr auf den Ports 80 und 443. Halten Sie den MariaDB-Port 3306 für den öffentlichen Internetverkehr gesperrt. Die Firewall-Dokumentation von Ubuntu beschreibt die UFW-Regeln.

Falls ein Musikscan keine Ergebnisse liefert, überprüfen Sie, ob der Katalogpfad korrekt ist und ob das www-dataBenutzerkonto die Dateien lesen und alle Verzeichnisse durchsuchen kann. Für wiederkehrende Katalogaktualisierungen und andere geplante Aufgaben konfigurieren Sie die Cronjobs von Ampache .