Cómo ejecutar un servidor Ampache en Ubuntu Server

Ampache convierte un servidor Ubuntu en una biblioteca musical autoalojada que puedes reproducir en un navegador o una aplicación compatible. Este tutorial utiliza Ubuntu Server 26.04 LTS, Apache, MariaDB y Ampache 8.3.0. Ampache 8 requiere PHP 8.5 o superior, así que consulta los requisitos de instalación oficiales antes de usar una versión anterior de Ubuntu.

Necesitarás una cuenta de superusuario (sudo), suficiente espacio en disco para tu música y un nombre de dominio si quieres que el servidor sea accesible a través de internet. Mantén el instalador restringido a una red de confianza hasta que finalice la configuración.

Instalar Ampache en Ubuntu Server

1. Instalar Apache, MariaDB, PHP y herramientas de audio.

Actualiza Ubuntu e instala los componentes del servidor y las extensiones PHP. Comprobación de Ampache. FFmpeg y las utilidades de audio admiten el procesamiento y la transcodificación de medios.

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 incluye PHP 8.5 en su repositorio. Si su servidor ofrece una versión de PHP diferente, elija una versión de Ampache compatible con dicha versión o siga la guía específica de Ampache para esa versión; no dé por sentado que el phppaquete sin versión cumple con los requisitos de Ampache 8.

2. Crea una base de datos y un usuario dedicado.

Abra la consola de administración local de MariaDB. La cuenta de la aplicación solo tendrá acceso a la base de datos de Ampache, mientras que la administración local de MariaDB de Ubuntu permanecerá separada.

sudo mariadb

En la consola de MariaDB, crea la base de datos y reemplaza la contraseña de ejemplo por una contraseña larga y única. Evita usar comillas simples en la contraseña, a menos que las hayas escapado correctamente en 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. Descargue el archivo de lanzamiento de Ampache.

La página de lanzamiento oficial muestra los archivos con versiones. El ejemplo siguiente muestra Ampache 8.3.0 y su compilación para PHP 8.5; si hay una versión más reciente disponible al instalarla, actualice tanto la versión como el nombre del archivo.

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

El servidor web necesita escribir el directorio de configuración durante la instalación. El resto de los archivos de la aplicación pueden seguir perteneciendo al usuario root y ser legibles por Apache.

4. Indique a Apache la ruta al directorio público de Ampache.

El directorio raíz web de Ampache es el publicsubdirectorio. En un servidor nuevo dedicado a Ampache, edite el host virtual predeterminado; utilice un host virtual independiente si Apache ya aloja otros sitios.

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

Dentro del <VirtualHost *:80>bloque existente, configure el nombre de su servidor y la raíz del documento, luego agregue las reglas de directorio:

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

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

Habilite la reescritura de Apache, genere los archivos de reescritura que incluye Apache, pruebe la configuración y recargue Apache:

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

Esta AllowOverride Allconfiguración permite que Apache lea esos archivos. Apache advierte que la transmisión de datos y sus API pueden devolver errores 404 cuando la reescritura no está disponible; consulte su guía de reglas de reescritura si utiliza un host virtual personalizado.

5. Compruebe el servidor en el instalador de Ampache.

Desde un equipo de tu red de confianza, abre el servidor http://ampache.example.com/install.php. Si no has configurado el DNS, usa la dirección IP privada del servidor. Selecciona un idioma, elige « Iniciar configuración» y revisa la página de requisitos. Resuelve cualquier módulo PHP que falte antes de continuar; instala el php8.5-paquete correspondiente y reinicia Apache cuando sea necesario.

6. Conectar la base de datos y escribir la configuración.

Introduzca localhostel host de la base de datos, ampacheel nombre de la base de datos y las ampacheusercredenciales creadas previamente. Utilice esta cuenta dedicada en lugar de la cuenta raíz de MariaDB. Seleccione el tipo de instalación estándar. Si desea que Ampache transcodifique el audio, seleccione FFmpeg en las opciones de transcodificación; de lo contrario, deje la transcodificación desactivada. Seleccione Crear configuración para guardar el archivo de configuración.

7. Cree la cuenta de administrador de Ampache.

Crea un nombre de usuario y una contraseña de administrador de Ampache seguros. Esta es la cuenta que usarás para gestionar la música y los usuarios en Ampache; es independiente tanto de tu cuenta de Ubuntu como de la cuenta de MariaDB. Deja que el instalador aplique las actualizaciones de la base de datos y, a continuación, inicia sesión.

8. Añade tu música como catálogo.

Haz que Apache pueda leer la carpeta de música. Usa la ruta donde realmente se encuentran tus archivos; el ejemplo crea un nuevo directorio de biblioteca:

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

Copia o monta tus pistas allí y luego inicia sesión como administrador de Ampache. Abre el menú de administración y selecciona Agregar un catálogo . Introduce un nombre como Music, establece la ruta completa a /srv/music, elige un catálogo de música local y agrégalo. Ejecuta una actualización para que Ampache lea los archivos. La guía del catálogo explica el mantenimiento y los permisos del catálogo.

Acceso remoto seguro y mantener la biblioteca actualizada

Para un servidor accesible desde internet, apunta el registro DNS de tu dominio al servidor y configura HTTPS antes de compartir la dirección. La guía de Apache para Ubuntu utiliza Certbot con Apache:

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

Una vez instalado el certificado, configure force_ssl = "true"Ampache /var/www/ampache/config/ampache.cfg.phppara que genere enlaces HTTPS. En UFW, permita el puerto SSH del servidor antes de habilitar el cortafuegos y, a continuación, permita el tráfico web en los puertos 80 y 443. Mantenga el puerto 3306 de MariaDB cerrado al acceso público a internet. La documentación del cortafuegos de Ubuntu incluye las reglas de UFW.

Si el escaneo de música no encuentra nada, confirme que la ruta del catálogo sea correcta y que la www-datacuenta pueda leer los archivos y navegar por cada directorio. Para actualizaciones periódicas del catálogo y otras tareas programadas, configure las tareas cron de Ampache .