Como executar um servidor Ampache no Ubuntu Server

O Ampache transforma um servidor Ubuntu em uma biblioteca de música auto-hospedada que você pode reproduzir em um navegador ou aplicativo compatível. Este tutorial usa o Ubuntu Server 26.04 LTS, Apache, MariaDB e Ampache 8.3.0. O Ampache 8 requer PHP 8.5 ou superior, portanto, verifique os requisitos de instalação oficiais antes de usar uma versão mais antiga do Ubuntu.

Você precisará de uma conta sudo, espaço suficiente em disco para suas músicas e um nome de domínio, caso pretenda tornar o servidor acessível pela internet pública. Mantenha o instalador restrito a uma rede confiável até que a instalação esteja concluída.

Instalar o Ampache no servidor Ubuntu

1. Instale o Apache, MariaDB, PHP e ferramentas de áudio.

Atualize o Ubuntu e instale os componentes do servidor e as extensões do PHP. Verifique o Ampache. O FFmpeg e os utilitários de áudio oferecem suporte ao processamento e transcodificação de mídia.

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

O Ubuntu 26.04 inclui o PHP 8.5 em seu repositório. Se o seu servidor oferece uma versão diferente do PHP, escolha uma versão do Ampache compatível com essa versão ou siga o guia específico da versão do Ampache; não assuma que o phppacote sem versão atenda aos requisitos do Ampache 8.

2. Crie um banco de dados e um usuário dedicado.

Abra o shell administrativo local do MariaDB. A conta do aplicativo terá acesso apenas ao banco de dados do Ampache, enquanto a administração local do MariaDB no Ubuntu permanecerá separada.

sudo mariadb

No prompt do MariaDB, crie o banco de dados e substitua a senha de exemplo por uma senha longa e exclusiva. Evite o uso de aspas simples na senha, a menos que você as escape corretamente em 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. Baixe o arquivo de lançamento do Ampache.

A página oficial de lançamentos lista arquivos com versões. O exemplo abaixo fixa o Ampache 8.3.0 e sua versão para PHP 8.5; se uma versão mais recente estiver disponível durante a instalação, atualize tanto a versão quanto o nome do arquivo.

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

O servidor web precisa gravar o diretório de configuração durante a instalação. Os demais arquivos da aplicação podem permanecer com o usuário root e serem legíveis pelo Apache.

4. Direcione o Apache para o diretório público do Ampache.

O diretório raiz do Ampache é o publicsubdiretório. Em um servidor novo dedicado ao Ampache, edite o host virtual padrão; use um host virtual separado se o Apache já estiver servindo outros sites.

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

Dentro do <VirtualHost *:80>bloco existente, defina o nome do servidor e o diretório raiz do documento e, em seguida, adicione as regras de diretório:

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

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

Habilite a reescrita de rotas do Apache, gere os arquivos de reescrita fornecidos com o Ampache, teste a configuração e reinicie o Apache:

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

Essa AllowOverride Allconfiguração permite que o Apache leia esses arquivos. O Ampache alerta que o streaming e suas APIs podem retornar erros 404 quando a reescrita não estiver disponível; consulte o guia de regras de reescrita se você usar um host virtual personalizado.

5. Verifique o servidor no instalador do Ampache.

Em um computador conectado à sua rede confiável, abra o servidor http://ampache.example.com/install.php. Se você não configurou o DNS, use o endereço IP privado do servidor. Escolha um idioma, selecione " Iniciar Configuração" e revise a página de requisitos. Resolva todos os problemas com os módulos PHP ausentes antes de continuar; instale o php8.5-pacote correspondente e reinicie o Apache quando necessário.

6. Conecte o banco de dados e escreva a configuração.

Insira localhosto host do banco de dados, ampacheo nome do banco de dados e as ampacheusercredenciais criadas anteriormente. Use esta conta dedicada em vez da conta root do MariaDB. Selecione o tipo de instalação padrão. Se desejar que o Ampache transcodifique o áudio, escolha FFmpeg nas opções de transcodificação; caso contrário, deixe a transcodificação desativada. Selecione Criar Configuração para salvar o arquivo de configuração.

7. Crie a conta de administrador do Ampache.

Crie um nome de usuário e senha de administrador fortes para o Ampache. Esta é a conta que você usará para gerenciar músicas e usuários no Ampache; ela é separada tanto do seu login do Ubuntu quanto da conta do MariaDB. Deixe o instalador aplicar quaisquer atualizações de banco de dados e, em seguida, faça login.

8. Adicione sua música como um catálogo.

Torne a pasta de música legível para o Apache. Use o caminho onde seus arquivos estão localizados; o exemplo cria um novo diretório de biblioteca:

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

Copie ou monte suas faixas lá e, em seguida, faça login como administrador do Ampache. Abra o menu Admin e escolha Adicionar um Catálogo . Insira um nome, como Music, defina o caminho completo para /srv/music, escolha um catálogo de músicas local e adicione-o. Execute uma atualização para que o Ampache leia os arquivos. O guia do catálogo explica a manutenção e as permissões do catálogo.

Acesso remoto seguro e biblioteca atualizada

Para um servidor acessível pela internet, aponte o registro DNS do seu domínio para o servidor e configure o HTTPS antes de compartilhar o endereço. O guia do Ampache para Ubuntu usa o Certbot com o Apache:

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

Após a instalação do certificado, configure force_ssl = "true"o /var/www/ampache/config/ampache.cfg.phpAmpache para gerar links HTTPS. No UFW, permita a porta SSH do servidor antes de habilitar o firewall e, em seguida, permita o tráfego web nas portas 80 e 443. Mantenha a porta 3306 do MariaDB fechada para a internet pública. A documentação do firewall do Ubuntu aborda as regras do UFW.

Se uma verificação de música não encontrar nada, confirme se o caminho do catálogo está correto e se a www-dataconta tem permissão para ler os arquivos e navegar por cada diretório. Para atualizações recorrentes do catálogo e outras tarefas agendadas, configure os trabalhos cron do Ampache .