Cum se rulează un server Ampache pe un server Ubuntu

Ampache transformă un server Ubuntu într-o bibliotecă muzicală auto-găzduită, pe care o puteți reda într-un browser sau într-o aplicație compatibilă. Această demonstrație folosește Ubuntu Server 26.04 LTS, Apache, MariaDB și Ampache 8.3.0. Ampache 8 necesită PHP 8.5 sau o versiune mai nouă, așa că verificați cerințele oficiale de instalare înainte de a utiliza o versiune mai veche de Ubuntu.

Vei avea nevoie de un cont sudo, suficient spațiu pe disc pentru muzica ta și un nume de domeniu dacă intenționezi să faci serverul accesibil prin internetul public. Păstrează programul de instalare limitat la o rețea de încredere până la finalizarea configurării.

Instalați Ampache pe serverul Ubuntu

1. Instalați Apache, MariaDB, PHP și instrumente audio

Actualizați Ubuntu și instalați componentele serverului și extensiile PHP. Verificările Ampache. FFmpeg și utilitarele audio acceptă procesarea și transcodarea media.

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 include PHP 8.5 în arhiva sa. Dacă serverul dvs. oferă o versiune diferită de PHP, alegeți o versiune Ampache compatibilă cu acea versiune sau urmați ghidul specific versiunii Ampache; nu presupuneți că phppachetul neversționat îndeplinește cerințele Ampache 8.

2. Creați o bază de date și un utilizator dedicat

Deschideți shell-ul administrativ local al MariaDB. Contul aplicației va avea acces doar la baza de date Ampache, în timp ce administrarea locală MariaDB a Ubuntu rămâne separată.

sudo mariadb

La promptul MariaDB, creați baza de date și înlocuiți parola exemplu cu o parolă lungă și unică. Evitați ghilimelele simple în parolă, cu excepția cazului în care le folosiți corect în 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. Descărcați arhiva versiunii Ampache

Pagina oficială de lansare listează arhivele versionate. Exemplul de mai jos fixează Ampache 8.3.0 și versiunea sa PHP 8.5; dacă este disponibilă o versiune mai nouă la instalare, actualizați atât versiunea, cât și numele fișierului.

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

Serverul web trebuie să scrie directorul de configurare în timpul configurării. Restul fișierelor aplicației pot rămâne deținute de utilizatorul root și pot fi citite de Apache.

4. Indicați Apache către directorul public al Ampache

Directorul web rădăcină al Ampache este publicsubdirectorul. Pe un server nou dedicat Ampache, editați gazda virtuală implicită; utilizați o gazdă virtuală separată dacă Apache deservește deja alte site-uri.

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

În interiorul blocului existent <VirtualHost *:80>, setați numele serverului și rădăcina documentului, apoi adăugați regulile directorului:

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

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

Activați rescrierea Apache, generați fișierele de rescriere livrate de Ampache, testați configurația și reîncărcați Apache:

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

Setarea AllowOverride Allpermite Apache să citească acele fișiere. Ampache avertizează că streamingul și API-urile sale pot returna erori 404 atunci când rescrierea nu este disponibilă; consultați ghidul său cu reguli de rescriere dacă utilizați o gazdă virtuală personalizată.

5. Verificați serverul în programul de instalare Ampache

De pe un computer din rețeaua dvs. de încredere, deschideți http://ampache.example.com/install.php. Dacă nu ați configurat DNS, utilizați în schimb adresa IP privată a serverului. Alegeți o limbă, selectați Pornire configurare și examinați pagina cu cerințe. Remediați fiecare modul PHP lipsă înainte de a continua; instalați pachetul corespunzător php8.5-și reporniți Apache când este necesar.

6. Conectați baza de date și scrieți configurația

Introduceți localhostca gazdă a bazei de date, ampacheca nume al bazei de date și ampacheuseracreditările create anterior. Folosiți acest cont dedicat în locul contului root MariaDB. Selectați tipul de instalare standard. Dacă doriți ca Ampache să transcodeze audio, alegeți FFmpeg în opțiunile de transcodare; altfel, lăsați transcodarea dezactivată. Selectați Creare configurare pentru a salva fișierul de configurare.

7. Creați contul de administrator Ampache

Creați un nume de utilizator și o parolă puternice pentru administratorul Ampache. Acesta este contul pe care îl veți folosi pentru a gestiona muzica și utilizatorii în Ampache; este separat atât de datele de conectare Ubuntu, cât și de contul MariaDB. Permiteți programului de instalare să aplice orice actualizări ale bazei de date, apoi conectați-vă.

8. Adăugați muzica dvs. ca un catalog

Faceți folderul de muzică lizibil de către Apache. Folosiți calea în care se află de fapt fișierele dvs.; exemplul creează un nou director de bibliotecă:

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

Copiați sau montați piesele acolo, apoi conectați-vă ca administrator Ampache. Deschideți meniul Admin și alegeți Adăugați un catalog . Introduceți un nume precum Music, setați calea completă la /srv/music, alegeți un catalog muzical local și adăugați-l. Rulați o actualizare astfel încât Ampache să citească fișierele. Ghidul catalogului explică întreținerea și permisiunile catalogului.

Securizarea accesului de la distanță și menținerea bibliotecii la zi

Pentru un server accesibil de pe internet, direcționați înregistrarea DNS a domeniului dvs. către server și configurați HTTPS înainte de a partaja adresa. Ghidul Ubuntu al lui Ampache folosește Certbot cu Apache:

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

După instalarea certificatului, setați force_ssl = "true"-l /var/www/ampache/config/ampache.cfg.phpastfel încât Ampache să genereze linkuri HTTPS. În UFW, permiteți portul SSH al serverului înainte de a activa firewall-ul, apoi permiteți traficul web pe porturile 80 și 443. Mențineți portul 3306 al MariaDB închis internetului public. Documentația firewall- ului Ubuntu acoperă regulile UFW.

Dacă o scanare muzicală nu găsește nimic, confirmați că este corectă calea catalogului și că respectivul www-datacont poate citi fișierele și poate parcurge fiecare director. Pentru reîmprospătarea recurentă a catalogului și alte sarcini programate, configurați cron job-urile Ampache .