Jak uruchomić serwer Ampache na serwerze Ubuntu

Ampache przekształca serwer Ubuntu w samodzielnie hostowaną bibliotekę muzyczną, którą można odtwarzać w przeglądarce lub kompatybilnej aplikacji. W tym poradniku wykorzystano Ubuntu Server 26.04 LTS, Apache, MariaDB i Ampache 8.3.0. Ampache 8 wymaga PHP 8.5 lub nowszego, dlatego przed użyciem starszej wersji Ubuntu należy sprawdzić oficjalne wymagania instalacyjne .

Potrzebujesz konta sudo, wystarczającej ilości miejsca na dysku na muzykę oraz nazwy domeny, jeśli planujesz udostępnić serwer przez publiczny internet. Do czasu zakończenia instalacji ogranicz instalator do zaufanej sieci.

Instalacja Ampache na serwerze Ubuntu

1. Zainstaluj Apache, MariaDB, PHP i narzędzia audio

Zaktualizuj Ubuntu i zainstaluj komponenty serwera oraz rozszerzenia PHP. Ampache sprawdza. FFmpeg i narzędzia audio obsługują przetwarzanie i transkodowanie multimediów.

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 zawiera PHP 8.5 w swoim archiwum. Jeśli Twój serwer oferuje inną wersję PHP, wybierz wersję Ampache zgodną z tą wersją lub postępuj zgodnie z instrukcją Ampache dotyczącą konkretnej wersji; nie zakładaj, że phppakiet bez wersji spełnia wymagania Ampache 8.

2. Utwórz bazę danych i dedykowanego użytkownika

Otwórz lokalną powłokę administracyjną MariaDB. Konto aplikacji będzie miało dostęp tylko do bazy danych Ampache, podczas gdy lokalna powłoka administracyjna MariaDB w Ubuntu pozostanie oddzielona.

sudo mariadb

W wierszu poleceń MariaDB utwórz bazę danych i zastąp przykładowe hasło długim, unikalnym hasłem. Unikaj stosowania pojedynczych cudzysłowów w haśle, chyba że poprawnie je ukryjesz w kodzie 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. Pobierz archiwum wydania Ampache

Oficjalna strona wydania zawiera listę wersjonowanych archiwów. Poniższy przykład przedstawia Ampache 8.3.0 i jego kompilację PHP 8.5; jeśli podczas instalacji dostępna jest nowsza wersja, zaktualizuj zarówno wersję, jak i nazwę pliku.

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

Serwer WWW musi zapisać katalog konfiguracyjny podczas instalacji. Pozostałe pliki aplikacji mogą pozostać własnością roota i być odczytywane przez Apache.

4. Skieruj Apache'a do publicznego katalogu Ampache'a

Katalog główny Ampache'a to publicpodkatalog. Na nowym serwerze dedykowanym Ampache'owi należy edytować domyślny host wirtualny; jeśli Apache obsługuje już inne witryny, należy użyć osobnego hosta wirtualnego.

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

Wewnątrz istniejącego <VirtualHost *:80>bloku ustaw nazwę serwera i katalog główny dokumentu, a następnie dodaj reguły katalogu:

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

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

Włącz przepisywanie Apache'a, wygeneruj dostarczone pliki przepisywania Ampache'a, przetestuj konfigurację i przeładuj Apache'a:

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

To AllowOverride Allustawienie pozwala Apache'owi odczytywać te pliki. Ampache ostrzega, że ​​strumieniowanie i jego API mogą zwracać błędy 404, gdy przepisywanie jest niedostępne; zapoznaj się z przewodnikiem po regułach przepisywania, jeśli używasz niestandardowego hosta wirtualnego.

5. Sprawdź serwer w instalatorze Ampache

Z komputera w zaufanej sieci otwórz http://ampache.example.com/install.php. Jeśli nie skonfigurowano DNS, użyj prywatnego adresu IP serwera. Wybierz język, kliknij przycisk Rozpocznij konfigurację i zapoznaj się ze stroną wymagań. Przed kontynuowaniem uzupełnij wszystkie brakujące moduły PHP; zainstaluj odpowiedni php8.5-pakiet i uruchom ponownie Apache'a w razie potrzeby.

6. Podłącz bazę danych i zapisz konfigurację

Wprowadź localhosthost bazy danych, ampachenazwę bazy danych i ampacheuserwcześniej utworzone dane uwierzytelniające. Użyj tego dedykowanego konta zamiast konta głównego MariaDB. Wybierz standardowy typ instalacji. Jeśli chcesz, aby Ampache transkodował dźwięk, wybierz FFmpeg w opcjach transkodowania; w przeciwnym razie pozostaw transkodowanie wyłączone. Wybierz „Utwórz konfigurację” , aby zapisać plik konfiguracyjny.

7. Utwórz konto administratora Ampache

Utwórz silną nazwę użytkownika i hasło administratora Ampache. To konto będzie używane do zarządzania muzyką i użytkownikami w Ampache; jest ono niezależne od Twojego loginu do Ubuntu i konta MariaDB. Pozwól instalatorowi zastosować aktualizacje bazy danych, a następnie się zaloguj.

8. Dodaj swoją muzykę jako katalog

Uczyń folder z muzyką czytelnym dla Apache'a. Użyj ścieżki, w której faktycznie znajdują się Twoje pliki; przykład tworzy nowy katalog biblioteki:

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

Skopiuj lub zamontuj tam swoje utwory, a następnie zaloguj się jako administrator Ampache. Otwórz menu administratora i wybierz Dodaj katalog . Wprowadź nazwę, taką jak Music, ustaw pełną ścieżkę na /srv/music, wybierz lokalny katalog muzyczny i dodaj go. Uruchom aktualizację, aby Ampache odczytał pliki. Przewodnik po katalogu wyjaśnia, jak go konserwować i jakie są uprawnienia.

Zapewnij bezpieczny dostęp zdalny i aktualizuj bibliotekę

Aby uzyskać dostęp do serwera z internetu, skieruj rekord DNS swojej domeny na serwer i skonfiguruj HTTPS przed udostępnieniem adresu. W przewodniku Ampache po Ubuntu wykorzystano Certbota z Apache:

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

Po zainstalowaniu certyfikatu należy force_ssl = "true"go skonfigurować /var/www/ampache/config/ampache.cfg.phptak, aby Ampache generował łącza HTTPS. W UFW należy zezwolić na port SSH serwera przed włączeniem zapory sieciowej, a następnie zezwolić na ruch sieciowy na portach 80 i 443. Port MariaDB 3306 powinien być zamknięty dla publicznego internetu. Dokumentacja zapory sieciowej Ubuntu zawiera opis reguł UFW.

Jeśli skanowanie muzyki nic nie wykryje, sprawdź, czy ścieżka do katalogu jest poprawna i czy konto www-datamoże odczytywać pliki oraz poruszać się po każdym katalogu. W przypadku cyklicznych odświeżań katalogu i innych zaplanowanych zadań skonfiguruj zadania cron Ampache .