Como hospedar seu streaming de música em um VPS
Veja como rodar o Navidrome no VPS, dimensionar armazenamento, usar clientes Subsonic, sincronizar offline, configurar TLS e fazer backups seguros.
O que o streaming de música autoalojado num VPS oferece
O streaming de música autoalojado num VPS significa que executa o leitor e fornece a música. O servidor armazena ficheiros que já possui, e qualquer telemóvel pode aceder-lhe através da Internet com um início de sessão normal. Tenha em conta esta limitação antes de começar: isto substitui o leitor de um serviço de streaming, não o respetivo catálogo. Nada de novo aparece na sua biblioteca até comprar ou extrair a música e copiar o ficheiro para o servidor.
O áudio exige muito menos de um servidor do que o vídeo. Os ficheiros são pequenos, os telemóveis descodificam todos os formatos comuns sem ajuda e um ouvinte utiliza menos largura de banda do que uma chamada de vídeo. O CPU não é um problema neste caso. O espaço em disco é a verdadeira limitação. Os outros dois fatores que determinam se isto funciona são a qualidade das etiquetas e a capacidade da aplicação do telemóvel para descarregar música para utilização offline.
Qual servidor de música: Navidrome, Jellyfin ou Funkwhale?
Navidrome é a escolha padrão quando você só precisa de áudio. Ele é um único binário Go em um único container e mantém o estado em um único banco de dados SQLite. Ele responde à API Subsonic, razão pela qual existe uma grande variedade de aplicativos de celular de terceiros. A versão 0.64.2, lançada em 24 September 2026, ainda era a versão atual em 2026-10-27. Não execute nada anterior à versão 0.64.1, que corrigiu cinco avisos de segurança, incluindo a tentativa de adivinhar senhas sem limitação de taxa contra o login do Subsonic. O projeto informa que ele funciona bem em hardware com recursos limitados, como um Raspberry Pi, portanto o software do servidor não será o componente pelo qual você pagará.
Jellyfin vale a pena se você já executa Jellyfin como servidor de mídia em um VPS para vídeo. A biblioteca de música funciona, e o Finamp é um aplicativo gratuito de música do Jellyfin para Android e iOS que baixa faixas para ouvir offline. O próprio Jellyfin ainda não tem um endpoint Subsonic integrado, mas um plugin da comunidade adiciona um. O Subfin-NG, um fork do plugin Subfin, "permite que aplicativos de música compatíveis com Subsonic reproduzam sua biblioteca de música do Jellyfin" ao adicionar uma API OpenSubsonic ao Jellyfin. Ele exige Jellyfin 12.0 ou posterior, requisito mínimo definido pela versão v12.1.13.0 em 16 October 2026, quando adicionou suporte ao Jellyfin 12.0. Ele também muda rapidamente: pelo menos sete versões foram lançadas entre 24 e 28 September 2026. Assim, os aplicativos Subsonic também podem acessar o Jellyfin, por meio de um plugin de terceiros em vez de um recurso integrado, e vale a pena testar o cliente escolhido com ele antes de depender dessa configuração. A integração também funciona no sentido inverso: o Navidrome 0.64.0 adicionou uma API Jellyfin experimental, desativada por padrão e ativada com ND_JELLYFIN_ENABLED, que, segundo a documentação, é testada com Finamp, Jellify e Feishin.
Funkwhale é a opção federada, e a versão 2.0 foi lançada em March 2026. Um servidor Funkwhale é chamado de pod, os pods fazem federação por meio do ActivityPub (o protocolo usado pelo Mastodon), e os usuários seguem as playlists uns dos outros entre pods. A versão 2.0 substituiu as bibliotecas antigas por playlists, transformando os follows de bibliotecas em follows de playlists, e um pod 2.0 não faz federação com pods que ainda executam a versão 1.x. Ele também responde a parte da API Subsonic, com uma diferença importante: cada usuário define uma senha Subsonic separada nas próprias configurações, porque o protocolo Subsonic espera uma senha que o servidor consiga ler. O Funkwhale exige uma instalação mais pesada, pois precisa do PostgreSQL e de uma fila de tarefas além da aplicação web.
Escolha o Navidrome, a menos que você queira federação ou que o Jellyfin já esteja em execução. O restante deste guia configura o Navidrome com Docker.
Como a API do Subsonic determina qual aplicação de telemóvel utiliza
O Subsonic era um servidor de música cuja API HTTP se tornou a linguagem comum do áudio autoalojado, e o OpenSubsonic é o projeto da comunidade que continua a estendê-la. É por isso que o seu telemóvel tem várias opções. O Navidrome não inclui uma aplicação móvel própria nem precisa de uma, porque qualquer cliente Subsonic inicia sessão com o endereço do servidor e os dados da sua conta.
Isto é mais importante para a sincronização offline, que é a funcionalidade que determina se a configuração é adequada ao uso diário. Um telemóvel num túnel não consegue contactar o servidor, por isso o cliente tem de ter copiado previamente os ficheiros para o armazenamento local. Todos os clientes fazem streaming. Apenas alguns permitem descarregar ficheiros. O diretório de clientes em navidrome.org/apps indica quais permitem essa operação, e a escolha é ampla em ambas as plataformas: Substreamer e Ultrasonic no Android, Amperfy e play:Sub no iOS. Vários dos clientes mais completos são aplicações pagas, e o Symfonium no Android é o mais mencionado. Instale dois antes de decidir, porque esta é a parte do sistema com que irá interagir todos os dias.
De quanto armazenamento precisa uma biblioteca de música?
Os dados por trás deste gráfico
[
{
"label": "Opus 128k",
"kbps": 128,
"gb_per_1000_albums": 43
},
{
"label": "MP3 320k",
"kbps": 320,
"gb_per_1000_albums": 108
},
{
"label": "FLAC 16/44.1",
"kbps": 900,
"gb_per_1000_albums": 304
},
{
"label": "FLAC 24/96",
"kbps": "3,000",
"gb_per_1000_albums": "1,013"
}
]Estes são valores aproximados, derivados do bitrate, e não medições de uma coleção real. A aritmética é simples o suficiente para ser confirmada com os seus próprios ficheiros. Considere um álbum com 45 minutos, ou seja, 2,700 segundos. Multiplique o bitrate em quilobits por segundo por 2,700 e divida por 8,000 para obter megabytes. A 320 kbps, isso corresponde a 108 MB por álbum. Assim, mil álbuns ocupam cerca de 108 GB.
O formato sem perdas altera o resultado. Um FLAC com qualidade de CD tem, em material normal, uma média próxima de 900 kbps. Por isso, os mesmos mil álbuns precisam de cerca de 304 GB. Uma biblioteca em 24 bit e 96 kHz chega aproximadamente a 1,013 GB, ou seja, um terabyte completo para uma coleção que poderia ser listada numa folha de papel. Uma cópia Opus a 128 kbps, otimizada para telemóveis, reduz os mesmos mil álbuns a 43 GB. Execute du -sh /path/to/music na biblioteca que já tem, porque a sua bitrate média é o único valor relevante ao escolher um plano.
A largura de banda representa a parte menor do custo. Um stream a 320 kbps transfere 40 quilobytes por segundo. Assim, uma hora de audição transfere cerca de 144 MB. Cem horas por mês correspondem a aproximadamente 14 GB, um volume que nenhum limite de transferência de um VPS costuma notar. A exceção é a primeira sincronização offline de um telemóvel, que pode transferir dezenas de gigabytes numa só noite.
Camada de armazenamento ou camada de computação?
Um servidor de música é um grande conjunto de dados frios, com quase nenhuma computação sobre esses dados. Ler um ficheiro a 40 kilobytes por segundo mantém qualquer disco praticamente inativo. A CPU só tem trabalho relevante durante a análise da biblioteca, durante a transcodificação, que na maioria dos casos não fará, e enquanto extrai e coloca em cache as capas dos álbuns, durante a análise ou na primeira vez que alguém abre um item. Por isso, o NVMe rápido de um plano de computação não traz qualquer vantagem neste caso. O preço por gigabyte é que impede o carregamento das cópias FLAC. Este é o caso em que um VPS de armazenamento é melhor do que um VPS normal, porque esses planos têm preços por terabyte e não por core.
A memória necessária é modesta. O Navidrome serve uma biblioteca pessoal com algumas centenas de megabytes, e a análise é o momento de maior utilização, não a reprodução. Atribua 1 GB ou 2 GB de RAM ao servidor e use o restante orçamento no armazenamento.
Instalar o Navidrome com Docker Compose
Crie primeiro os diretórios, pertencentes ao ID do utilizador com o qual o contentor será executado. Se o Compose for uma novidade para si, Docker Compose num VPS explica o que este ficheiro pressupõe.
sudo install -d -m 755 -o 1000 -g 1000 /srv/navidrome /srv/musicEscreva docker-compose.yml sem praticamente mais nada, no seu próprio diretório:
services:
navidrome:
image: deluan/navidrome:0.64.2
user: "1000:1000"
ports:
- "127.0.0.1:4533:4533"
restart: unless-stopped
environment:
ND_LOGLEVEL: "info"
ND_SESSIONTIMEOUT: "24h"
ND_SCANNER_SCHEDULE: "@every 24h"
ND_BACKUP_PATH: "/data/backup"
ND_BACKUP_SCHEDULE: "0 4 * * *"
ND_BACKUP_COUNT: "7"
volumes:
- /srv/navidrome:/data
- /srv/music:/music:rodocker compose up -d
docker compose psdocker compose ps deve mostrar o serviço como em execução, e não em reinício contínuo. Um contentor que reinicia em ciclo quase sempre tem um problema de permissões em /srv/navidrome, e docker compose logs navidrome indica o nome do ficheiro que não conseguiu escrever.
Vale a pena explicar quatro detalhes desse ficheiro. A porta é publicada apenas em 127.0.0.1, por isso o servidor é acessível através do reverse proxy e não na porta 4533 a partir da Internet pública: o Docker escreve as suas próprias regras de firewall, portanto um simples 4533:4533 continua exposto mesmo num servidor em que o ufw indique que tudo está negado. O volume de música é somente de leitura, o que significa que um erro no scanner não pode apagar a sua única cópia. ND_SCANNER_SCHEDULE está desativado por predefinição, e os guias escritos antes do Navidrome 0.55 chamam-lhe ND_SCANSCHEDULE, o nome antigo que a versão 0.55 alterou. As três definições de cópia de segurança ativam a cópia de segurança integrada da base de dados, da qual a secção seguinte depende.
Coloque a sua música no servidor
Copie a biblioteca com rsync. A cópia é retomada em vez de começar novamente quando a ligação cai.
rsync -av --info=progress2 ~/Music/ user@music.example.com:/srv/music/A barra final na origem é importante. Sem ela, obtém /srv/music/Music. Quando a cópia terminar, corrija o proprietário:
sudo chown -R 1000:1000 /srv/music
id -uO contentor é executado com o ID de utilizador 1000, e a montagem é só de leitura. Por isso, esse ID precisa de ter acesso de leitura a todos os ficheiros e permissão para atravessar todos os diretórios. Se a cópia ficar pertencente a outra conta, com permissões que impeçam o acesso dos restantes utilizadores, a análise não encontra nenhuma faixa, enquanto a interface Web continua vazia. O log mostra open /music: permission denied. O chown acima é uma forma de corrigir o problema. Se outros programas também utilizarem a pasta, a documentação do Docker do Navidrome sugere permitir o acesso de leitura sem alterar o proprietário: sudo chmod -R a+rX /srv/music. id -u mostra o seu ID real, e explica em detalhe como PUID e PGID funcionam nos contentores Docker.
Um reverse proxy e TLS para o celular funcionar de qualquer lugar
Aponte um registro DNS A para o VPS e forneça estas três linhas ao Caddy:
music.example.com {
reverse_proxy 127.0.0.1:4533
}sudo systemctl reload caddyO Caddy solicita o certificado em segundo plano assim que carrega o site, sem esperar por um visitante. A porta 443 precisa estar aberta. O Caddy habilita dois desafios ACME (automatic certificate management environment) por padrão: o desafio HTTP na porta 80 e o desafio TLS-ALPN na porta 443. Ele escolhe um deles aleatoriamente, em vez de sempre começar pelo HTTP. Depois de uma falha, ele tenta novamente uma vez e então muda para o outro desafio, portanto uma porta 80 fechada não impede a emissão do certificado. Ainda assim, mantenha a porta 80 aberta, porque o redirecionamento automático de HTTP para HTTPS do Caddy é servido nela. No nginx, adicione proxy_buffering off; ao bloco location: o Navidrome envia eventos de progresso para a interface web por meio de uma conexão longa, e, com o buffering ativado, a interface fica esperando uma resposta que o nginx ainda está mantendo. Se você o servir em um caminho como /music, em vez de usar um subdomínio próprio, defina ND_BASEURL com o mesmo caminho. Caso contrário, a interface será carregada como uma página em branco. Os três proxies mais comuns são comparados em Nginx, Caddy e Traefik em um VPS.
Abra o site e crie a primeira conta. Não existe uma senha padrão, e o primeiro visitante precisa criar o usuário administrador. Faça isso antes de informar o endereço a qualquer pessoa. Em seguida, teste o caminho exato usado por um cliente de celular:
SALT=$(openssl rand -hex 6)
TOKEN=$(printf '%s%s' 'YOUR_PASSWORD' "$SALT" | md5sum | cut -d' ' -f1)
curl -s "https://music.example.com/rest/ping.view?u=YOUR_USER&t=$TOKEN&s=$SALT&v=1.16.1&c=curl&f=json"Uma resposta saudável começa com {"subsonic-response":{"status":"ok" e identifica navidrome como o tipo de servidor. Um corpo que contenha "status":"failed" e o código de erro 40 significa que o proxy está funcionando e que as credenciais estão incorretas. Um erro de certificado nesta etapa deve ser corrigido primeiro, porque a maioria dos clientes de celular rejeita um certificado inválido com uma mensagem que não informa nada ao usuário.
Por que a biblioteca fica incorreta depois da primeira verificação
O Navidrome navega pelas tags, não pelas pastas, por isso são as tags que determinam o que vê. Uma faixa sem a tag de artista do álbum é organizada pelo artista da faixa. Por esse motivo, uma compilação com um artista diferente em cada faixa transforma-se em vinte álbuns com uma faixa cada. Corrija isso nos ficheiros, não no Navidrome: o MusicBrainz Picard e o beets procuram o álbum na base de dados do MusicBrainz e escrevem novamente as tags padrão.
O Navidrome também divide uma tag com vários artistas em artistas separados. Assim, o nome de uma banda que contenha um separador é dividido por engano. AC/DC é o exemplo mais comum. ND_SCANNER_ARTISTSPLITEXCEPTIONS contém os nomes que nunca devem ser divididos.
Os ficheiros novos são detetados por um monitor de ficheiros alguns segundos depois de serem adicionados. O monitor depende das notificações de alterações do kernel. Essas notificações não são recebidas para ficheiros gravados num compartilhamento de rede montado a partir de outra máquina. Nesse tipo de configuração, o ND_SCANNER_SCHEDULE periódico é o que mantém a biblioteca atualizada. Uma verificação completa lê as tags de todos os ficheiros, o que é lento numa biblioteca grande. Esse é um dos motivos para proteger a base de dados apresentada abaixo.
Utilizadores, playlists e partilha
Um administrador cria as restantes contas na interface web, e não existe registo autónomo. Cada utilizador tem contagens de reproduções, playlists, favoritos e classificações separadas. Assim, os membros de uma casa não acabam por partilhar o mesmo perfil de preferências.
As playlists podem vir de duas fontes. Uma playlist criada num cliente fica guardada na base de dados. Um ficheiro .m3u colocado na pasta da biblioteca é importado durante a análise. Esta é a forma simples de transferir playlists de um leitor de música para desktop. As playlists inteligentes são ficheiros .nsp, ficheiros JSON pequenos com regras, importados da mesma forma. São atualizados automaticamente à medida que a biblioteca muda.
A partilha fica ativada por predefinição a partir da versão 0.63.0, lançada em julho de 2026. Permite que um utilizador crie uma ligação pública para um álbum, que qualquer pessoa pode abrir sem iniciar sessão. Num servidor que contém toda a sua biblioteca, talvez não queira esse comportamento. Definir ND_ENABLESHARING como false desativa-o.
Faça o backup da base de dados separadamente dos ficheiros de música
O backup do próprio Navidrome abrange apenas a base de dados. A documentação é clara: o processo faz backup da base de dados, incluindo utilizadores, contagens de reproduções e o restante conteúdo, mas não faz backup da música nem da configuração. Esta separação é a forma correta de pensar no problema, porque as duas partes falham de forma diferente. Os ficheiros de música podem ser copiados novamente a partir do disco de onde foram extraídos. As contagens de reproduções, classificações, favoritos e listas de reprodução não existem em nenhum outro local, e uma nova verificação não os recupera.
O ficheiro compose já grava uma cópia noturna em /data/backup e mantém sete cópias. Faça uma cópia manual antes de uma atualização:
sudo docker compose run --rm navidrome backup createA atualização de 0.63 para 0.64 é a que mais precisa dessa cópia. A versão 0.64.0 codifica novamente todos os identificadores internos numa migração que altera todas as tabelas, e os clientes que mantêm downloads offline podem ter de sincronizar novamente depois.
A restauração apaga a base de dados atual e copia o backup para o respetivo local. Tem de ser executada com o Navidrome parado. Uma restauração nunca é segura num servidor em produção.
Esses ficheiros continuam no mesmo VPS, por isso não sobrevivem à perda do VPS. Envie /srv/navidrome regularmente para outra máquina ou para armazenamento de objetos. Essa é a finalidade de restic e BorgBackup. O diretório inteiro é pequeno, normalmente muito abaixo de um gigabyte. Por isso, uma cópia diária cifrada fora do servidor custa quase nada e recupera tudo o que uma nova verificação não consegue restaurar.
FAQ
Preciso de transcodificar música num VPS?
Quase nunca. Os telemóveis descodificam MP3, AAC, Opus e FLAC localmente, tal como os browsers atuais na maioria dos sistemas. Por isso, o servidor envia o ficheiro tal como está e usa quase nenhum CPU. O ponto a verificar são os browsers: o Firefox só reproduz AAC quando o sistema operativo ou uma biblioteca externa fornece o descodificador. Assim, um leitor web com uma biblioteca AAC pode precisar de um fluxo transcodificado. O caso em que mais compensa ativar esta opção é uma biblioteca FLAC transmitida através de dados móveis. Converter de cerca de 900 kbps para Opus a 128 kbps reduz o consumo de dados aproximadamente sete vezes. O Navidrome suporta transcodificação gerida no servidor desde a versão 0.61: deteta os codecs suportados pelo cliente, aplica valores predefinidos de bitrate adaptados ao formato e permite limitar o bitrate por leitor.
Porque é que a aplicação do meu telemóvel não consegue descarregar música para ouvir offline?
Porque o armazenamento offline é uma funcionalidade do cliente, não do servidor. A API Subsonic permite que qualquer cliente obtenha um ficheiro completo, mas é a aplicação que decide se mantém uma cópia no telemóvel. Consulte o diretório de clientes em navidrome.org/apps e escolha um cuja descrição mencione descargas offline ou cache. Alguns clientes só fazem cache do que já reproduziu. Isso não é o mesmo que sincronizar um álbum antes de uma viagem.
Porque é que um álbum ficou dividido em vários álbuns depois da análise?
A tag do artista do álbum está em falta ou é inconsistente entre as faixas. O Navidrome agrupa por tags, não por diretórios. Por isso, doze faixas com doze valores diferentes de artista e sem um valor comum de artista do álbum são apresentadas como doze álbuns. Defina a tag do artista do álbum em todas as faixas. Numa compilação, normalmente use Various Artists. Depois, deixe o Navidrome voltar a analisar a biblioteca. O MusicBrainz Picard ou o beets fazem isto para um diretório completo de uma só vez.
O streaming de música autoalojado substitui o Spotify?
Substitui o leitor e a biblioteca, não o catálogo. Tem a sua coleção em todos os dispositivos, com as playlists e as contagens de reproduções que nenhuma alteração de licenciamento lhe pode retirar. Não tem lançamentos novos nem recomendações baseadas nos hábitos de audição de outras pessoas. A maioria das pessoas que usam esta solução compra a própria música e mantém uma conta de streaming barata para descobrir música nova.