Tutoriais de VPS
Navidrome na VPS: música, Docker, HTTPS e backups seguros
Implante Navidrome com música somente leitura, estado persistente e HTTPS. Prepare tags/clientes, teste permissões e FFmpeg, diferencie espelhos de backups e restaure versões compatíveis.

O Navidrome é um servidor leve de música para navegador e clientes Subsonic/OpenSubsonic compatíveis. Ele lê tags, organiza álbuns/playlists e transcodifica áudio. Compartilhe dentro dos seus direitos musicais e termos do provedor; hospedar arquivos não concede direito de redistribuição.
Ubuntu 24.04, Docker Compose e Caddy mantêm música somente leitura e estado da aplicação gravável. Planeje backups, acesso e banda.
| Uso | CPU | RAM | Disco | Abordagem inicial |
|---|---|---|---|---|
| Pessoal | 2 vCPU | 2-4 GB | 40 GB SSD | Disco separado ou cópia sincronizada de objetos |
| Familiar | 2-4 vCPU | 4 GB | 80 GB+ | Cache local e cópia externa |
| Vários usuários/transcodificação | 4 vCPU+ | 8 GB+ | 160 GB+ | Medir CPU, armazenamento e rede |
São orçamentos, sem garantia. Configure A/AAAA para music.example.com, abra administração/80/443 necessários e mantenha 4533 privada. Navidrome exige arquivos legíveis: armazenamento de objetos precisa de sincronização ou montagem apropriada, considerando latência, requisições e saída. Veja dimensionamento.
sudo apt update
sudo apt install -y ca-certificates curl openssl
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/navidrome/{data,music,backups}
sudo chown -R "$USER":"$USER" /opt/navidrome
cd /opt/navidrome
Revise instalador root ou use pacotes suportados. Confira proprietário e UID do contêiner; seu usuário não é necessariamente 1000. Evite latest e registre tag/digest exato.
Crie .env:
TZ=Asia/Shanghai
ND_SCANSCHEDULE=1h
ND_LOGLEVEL=info
ND_SESSIONTIMEOUT=24h
ND_BASEURL=
Asia/Shanghai é exemplo: escolha seu fuso IANA. Escaneamento, sessão e URL base dependem da versão; essas variáveis não criam administrador.
services:
navidrome:
image: deluan/navidrome:0.58.0
user: "1000:1000"
restart: unless-stopped
environment:
ND_SCANSCHEDULE: ${ND_SCANSCHEDULE}
ND_LOGLEVEL: ${ND_LOGLEVEL}
ND_SESSIONTIMEOUT: ${ND_SESSIONTIMEOUT}
ND_BASEURL: ${ND_BASEURL}
ND_MUSICFOLDER: /music
ND_DATAFOLDER: /data
TZ: ${TZ}
ports:
- "127.0.0.1:4533:4533"
volumes:
- ./data:/data
- ./music:/music:ro
0.58.0 é exemplo antigo. Revise mudanças antes de escolher versão; preserve /data gravável, música somente leitura e UID/GID corretos.
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 navidrome
Configure a primeira conta por túnel SSH à 4533 privada antes de abrir acesso. Em bibliotecas grandes, observe logs/I/O sem reiniciar continuamente.
- Use nomes UTF-8 consistentes.
- Preencha Album Artist, Album, faixas/discos e ano.
- Preserve numeração coerente e identifique coletâneas Various Artists.
- Use
cover.jpgou imagens embutidas suportadas. - Exclua downloads temporários, cópias duplicadas e arquivos incompletos.
Teste amostra em /opt/navidrome/music, agrupamento, capa e ordem. Edite tags na origem e reescaneie; a montagem do servidor continua somente leitura.
sudo apt install -y caddy
sudo nano /etc/caddy/Caddyfile
music.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:4533
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
}
}
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://music.example.com
Use um gateway em 80/443. Teste renovação e HSTS/includeSubDomains apenas com HTTPS funcional. Clientes usam URL HTTPS final e credenciais próprias. Letras/marcadores OpenSubsonic dependem de ambos os lados. Em subcaminhos, coordene ND_BASEURL, proxy e cliente. Veja Caddy.
- Use contas comuns para ouvir e limite administração/cadastro desnecessário.
- Teste visibilidade de bibliotecas/playlists; playlist privada não isola todos os arquivos.
- Use senhas longas únicas e remova contas sem uso.
- Restrinja administração por VPN ou controles suportados.
- Evite compartilhamento sem limites de banda ou direitos.
Não publique /data como arquivos estáticos; ele contém estado e ajustes sensíveis. Monitore falhas/tráfego. Login adicional do navegador pode quebrar clientes musicais: teste API ou use VPN compatível.
docker compose exec navidrome ffmpeg -version
Confira FFmpeg real. Se faltar, use imagem compatível/personalizada, sem instalação efêmera no contêiner. Converter FLAC/ALAC ou alta taxa consome CPU: escolha formato/taxa para o cliente e teste concorrência.
Diferencie rede, leitura de música e CPU FFmpeg. Evite escanear excessivamente; use agenda diária ou após importação. Ponha estado/capas em SSD e música em armazenamento adequado. Confirme montagens remotas completas antes de escanear, para não interpretar uma falha como arquivos apagados.
Salve /data, originais, Compose e .env. Originais gerenciados fora precisam de checksums e proteção externa própria.
mkdir -p /opt/navidrome/backups
tar -czf /opt/navidrome/backups/navidrome-data-$(date +%F).tar.gz data
cp docker-compose.yml .env /opt/navidrome/backups/
rsync -a --delete /opt/navidrome/music/ backup-host:/srv/music/
Copie data com Navidrome parado ou método SQLite consistente suportado. rsync --delete é espelho: propaga exclusões e remove arquivos exclusivos do destino. Teste --dry-run, valide destino e preserve snapshots/versões separadamente. Proteja segredos e nome real do Compose.
Pelo menos mensalmente, restaure /data em instância isolada da mesma versão e teste usuários, playlists, favoritos e escaneamento com música segura. Inclua capas/originais e confira checksums. Veja recuperação.
Registre versões Navidrome/FFmpeg, ajustes e caminhos. Copie /data para teste isolado e confira banco/escaneamento:
docker compose pull
docker compose up -d
docker compose logs --tail=200 navidrome
docker compose ps
Pare escritas se migração/login falhar. Restaure imagem antiga com /data correspondente em isolamento; trocar só imagem não reverte migração. Não apague volume de contas, playlists e histórico.
Confira Caddy, contêiner, 4533 privada, DNS/firewall e docker compose logs navidrome para erros de permissões/banco.
Confira leitura de /music, montagem e UID/GID. Revise tags/duplicados antes de escanear; não apague repetidamente o banco.
Examine CPU, I/O, saída e logs FFmpeg. Teste formato original ou taxa menor antes de ampliar recursos.
Confira HTTPS, caminho, credenciais e logs proxy. Login adicional, API incompatível ou TLS podem impedir acesso. Verifique antes de redefinir senha; preserve Host/cookies e conexões do cliente.
- Versão escolhida e
data/música persistentes. - Domínio, HTTPS e cliente testados.
- Administração/contas de reprodução e acesso verificados.
- Tags, capas, coletâneas e múltiplos discos corretos.
- FFmpeg, celular e concorrência testados.
/data, originais, ajustes e versões com cópia externa.- Restauração isolada testada e cronometrada.
Comece com música somente leitura e um cliente; amplie após validar escaneamento e reprodução.
Leituras relacionadas: