Tutoriales de VPS
Navidrome en un VPS: música, Docker, HTTPS y copias seguras
Despliega Navidrome con música de lectura, estado persistente y HTTPS. Prepara etiquetas/clientes, prueba permisos y FFmpeg, distingue espejos de copias y restaura versiones compatibles.

Navidrome es un servidor musical ligero para navegador y clientes Subsonic/OpenSubsonic compatibles. Escanea etiquetas, organiza álbumes/listas y transcodifica audio. Comparte solo dentro de tus derechos musicales y condiciones del proveedor; alojar archivos no concede derecho de redistribución.
Ubuntu 24.04, Docker Compose y Caddy mantienen música de lectura y estado de aplicación escribible. Planifica copias, acceso y ancho de banda.
| Uso | CPU | RAM | Disco | Enfoque inicial |
|---|---|---|---|---|
| Personal | 2 vCPU | 2-4 GB | 40 GB SSD | Disco aparte o copia sincronizada de objetos |
| Familiar | 2-4 vCPU | 4 GB | 80 GB+ | Caché local y copia externa |
| Varios usuarios/transcodificación | 4 vCPU+ | 8 GB+ | 160 GB+ | Medir CPU, almacenamiento y red |
Son presupuestos, sin garantía. Configura A/AAAA para music.example.com, abre administración/80/443 necesarios y deja 4533 privado. Navidrome necesita archivos legibles: almacenamiento de objetos requiere sincronización o montaje apropiado, considerando latencia, solicitudes y salida. Consulta dimensionamiento.
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
Revisa instalador root o usa paquetes soportados. Comprueba propietario frente al UID del contenedor; tu usuario no es necesariamente 1000. Evita latest y registra tag/digest exacto.
Crea .env:
TZ=Asia/Shanghai
ND_SCANSCHEDULE=1h
ND_LOGLEVEL=info
ND_SESSIONTIMEOUT=24h
ND_BASEURL=
Asia/Shanghai es un ejemplo: elige tu zona IANA. Escaneo, sesión y URL base dependen de versión; estas variables no crean el 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 es un ejemplo antiguo. Revisa cambios antes de elegir versión; conserva /data escribible, música de lectura y UID/GID correctos.
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 navidrome
Inicializa la primera cuenta mediante túnel SSH a 4533 privado antes de abrir acceso. Para escaneos grandes, observa logs/I/O sin reiniciar continuamente.
- Usa nombres UTF-8 consistentes.
- Completa Album Artist, Album, pistas/discos y año.
- Mantén numeración coherente y marca compilaciones Various Artists.
- Usa
cover.jpgo imágenes embebidas compatibles. - Excluye descargas temporales, copias duplicadas y archivos incompletos.
Prueba una muestra en /opt/navidrome/music, agrupación, portada y orden. Edita etiquetas en la fuente y reescanea; el montaje del servidor sigue de lectura.
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
Una puerta de entrada ocupa 80/443. Prueba renovación y HSTS/includeSubDomains solo con HTTPS funcional. Clientes usan URL HTTPS final y credenciales propias. Letras/marcadores OpenSubsonic dependen de ambos extremos. Para subrutas, coordina ND_BASEURL, proxy y cliente. Consulta Caddy.
- Usa cuentas normales para escuchar y limita administración/registro innecesario.
- Prueba visibilidad compatible de bibliotecas/listas; lista privada no aísla todos los archivos.
- Usa contraseñas únicas largas y elimina cuentas sin uso.
- Restringe administración mediante VPN o controles compatibles.
- Evita compartir sin límites de ancho de banda o derechos.
No publiques /data como archivos estáticos; contiene estado y ajustes sensibles. Vigila errores/flujo. Autenticación adicional del navegador puede romper clientes musicales: prueba su API o usa VPN compatible.
docker compose exec navidrome ffmpeg -version
Verifica FFmpeg real. Si falta, usa imagen compatible/personalizada, no instalación efímera en el contenedor. Convertir FLAC/ALAC o alta tasa consume CPU: elige formato/tasa según cliente y prueba concurrencia.
Distingue red, lectura de música y CPU FFmpeg. Evita escanear demasiado; usa horario diario o escaneo tras importar. Coloca estado/portadas en SSD y música en almacenamiento adecuado. Confirma montajes remotos completos antes de escanear, para no interpretar una caída como archivos borrados.
Guarda /data, originales, Compose y .env. Si los originales se gestionan fuera, necesitan checksums y protección externa propia.
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/
Copia data con Navidrome detenido o método SQLite consistente admitido. rsync --delete es un espejo: propaga borrados y elimina archivos exclusivos del destino. Prueba --dry-run, verifica destino y conserva snapshots/versiones aparte. Protege secretos y nombre real de Compose.
Al menos mensualmente, restaura /data en instancia aislada de la misma versión y prueba usuarios, listas, favoritos y escaneo con música segura. Incluye portadas/originales y verifica checksums. Consulta recuperación.
Registra versiones Navidrome/FFmpeg, ajustes y rutas. Copia /data a una prueba aislada y verifica base/escaneo:
docker compose pull
docker compose up -d
docker compose logs --tail=200 navidrome
docker compose ps
Detén escrituras si falla migración/login. Restaura imagen antigua con /data correspondiente en aislamiento; solo cambiar imagen no revierte migraciones. No borres el volumen de cuentas, listas e historial.
Revisa Caddy, contenedor, 4533 privado, DNS/firewall y docker compose logs navidrome por errores de permisos/base.
Verifica lectura de /music, montaje y UID/GID. Revisa etiquetas/duplicados antes de escanear; no borres repetidamente la base.
Revisa CPU, I/O, salida y logs FFmpeg. Prueba formato original o menor tasa antes de ampliar recursos.
Comprueba HTTPS, ruta, credenciales y logs proxy. Login adicional, API incompatible o TLS pueden impedir acceso. Verifica antes de restablecer contraseña; conserva Host/cookies y conexiones del cliente.
- Versión decidida y
data/música persistentes. - Dominio, HTTPS y cliente probados.
- Administración/cuentas de escucha y acceso verificados.
- Etiquetas, portadas, compilaciones y multidisco correctos.
- FFmpeg, móvil y concurrencia probados.
/data, originales, ajustes y versiones con copia externa.- Restauración aislada probada y cronometrada.
Empieza con música de lectura y un cliente; amplía después de verificar escaneo y reproducción.
Lecturas relacionadas: