SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor · Actualizado 2026-10-28

Cómo alojar Navidrome en tu propio VPS

Instala Navidrome en un VPS y reproduce tu biblioteca desde cualquier teléfono. Incluye cálculo de almacenamiento, clientes Subsonic, modo offline, TLS y copias seguras.

Qué ofrece la transmisión de música autoalojada en un VPS

La transmisión de música autoalojada en un VPS significa que usted ejecuta el reproductor y proporciona la música. El servidor almacena archivos que ya posee, y cualquier teléfono puede acceder a él por Internet con un inicio de sesión normal. Sea consciente de la limitación antes de empezar: esto sustituye al reproductor de un servicio de streaming, no a su catálogo. No aparecerá nada nuevo en su biblioteca hasta que compre la música o la extraiga y copie el archivo al servidor.

El audio exige muchos menos recursos del servidor que el vídeo. Los archivos son pequeños, los teléfonos decodifican todos los formatos habituales sin ayuda y un oyente utiliza menos ancho de banda que una videollamada. La CPU no suele ser un problema. El espacio en disco es la limitación real. Los otros dos factores que determinan si esto funcionará son la calidad de las etiquetas y si la aplicación del teléfono puede descargar música para usarla sin conexión.

¿Qué servidor de música elegir: Navidrome, Jellyfin o Funkwhale?

Navidrome es la opción predeterminada si sólo necesita audio. Es un único binario de Go dentro de un contenedor y guarda su estado en una sola base de datos SQLite. Responde a la API de Subsonic, por lo que existe una amplia familia de aplicaciones móviles de terceros. La versión 0.64.2, publicada el 24 de septiembre de 2026, seguía siendo la versión actual el 2026-10-27. No ejecute nada anterior a 0.64.1, que corrigió cinco avisos de seguridad, entre ellos la posibilidad de adivinar contraseñas sin límite de intentos contra el inicio de sesión de Subsonic. El proyecto indica que funciona bien en hardware con recursos limitados, como una Raspberry Pi, por lo que el software del servidor no será el componente por el que tendrá que pagar.

Jellyfin resulta útil si ya ejecuta Jellyfin como servidor multimedia en un VPS para vídeo. Su biblioteca de música funciona, y Finamp es una aplicación gratuita de música para Jellyfin en Android e iOS que descarga pistas para escucharlas sin conexión. Jellyfin todavía no incluye un endpoint de Subsonic, pero un plugin comunitario añade uno. Subfin-NG, un fork del plugin Subfin, «permite que las aplicaciones de música compatibles con Subsonic reproduzcan la biblioteca de música de Jellyfin» al añadir una API OpenSubsonic a Jellyfin. Requiere Jellyfin 12.0 o posterior, requisito que estableció la versión 12.1.13.0 el 16 de octubre de 2026 al añadir compatibilidad con Jellyfin 12.0. También cambia con rapidez: se publicaron al menos siete versiones entre el 24 y el 28 de septiembre de 2026. Por tanto, las aplicaciones de Subsonic también pueden acceder a Jellyfin mediante un plugin de terceros, no mediante una función integrada, y conviene probar el cliente elegido antes de depender de él. La conexión también funciona en sentido inverso: Navidrome 0.64.0 añadió una API experimental de Jellyfin, desactivada de forma predeterminada y activada con ND_JELLYFIN_ENABLED, que según su documentación está probada con Finamp, Jellify y Feishin.

Funkwhale es la opción federada, y la versión 2.0 se publicó en marzo de 2026. Un servidor de Funkwhale se denomina pod; los pods se federan mediante ActivityPub, el protocolo en el que se basa Mastodon, y los usuarios siguen las listas de reproducción de otros usuarios entre pods. La versión 2.0 sustituyó las bibliotecas antiguas por listas de reproducción, por lo que los seguimientos de bibliotecas pasaron a ser seguimientos de listas de reproducción. Un pod con la versión 2.0 no se federa con pods que todavía ejecutan la versión 1.x. También responde a parte de la API de Subsonic, con una diferencia importante: cada usuario establece una contraseña de Subsonic independiente en su propia configuración, porque el protocolo de Subsonic espera una contraseña que el servidor pueda leer. La instalación de Funkwhale es más pesada, ya que necesita PostgreSQL y una cola de tareas además de la aplicación web.

Elija Navidrome salvo que necesite federación o ya tenga Jellyfin en ejecución. El resto de esta guía configura Navidrome con Docker.

Por qué la API de Subsonic decide qué aplicación móvil utiliza

Subsonic era un servidor de música cuya API HTTP se convirtió en el lenguaje común del audio autoalojado, y OpenSubsonic es el proyecto comunitario que sigue ampliándolo. Por eso puede elegir entre varias aplicaciones para el teléfono. Navidrome no incluye una aplicación móvil propia ni la necesita, porque cualquier cliente de Subsonic inicia sesión con la dirección del servidor y los datos de su cuenta.

Esto es especialmente importante para la sincronización sin conexión, que determina si la configuración resulta útil en el uso diario. Un teléfono en un túnel no puede acceder al servidor, por lo que el cliente debe haber copiado los archivos al almacenamiento local con antelación. Todos los clientes reproducen contenido en streaming. Sólo algunos permiten descargarlo. El directorio de clientes de navidrome.org/apps indica cuáles lo permiten, y hay muchas opciones en ambas plataformas: Substreamer y Ultrasonic en Android, Amperfy y play:Sub en iOS. Varias de las mejores aplicaciones son de pago, y Symfonium en Android es la que se menciona con más frecuencia. Instale dos antes de decidir, porque esta es la parte del sistema que utilizará a diario.

¿Cuánto almacenamiento necesita una biblioteca musical?

GráficoStorage per 1,000 albums by audio format
Los datos de este 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"
  }
]

Son cifras de orden de magnitud derivadas de la tasa de bits, no mediciones de una colección real. El cálculo es lo bastante sencillo como para compararlo con sus propios archivos. Considere que un álbum dura 45 minutos, es decir, 2,700 segundos. Multiplique la tasa de bits en kilobits por segundo por 2,700 y divida el resultado entre 8,000 para obtener megabytes. A 320 kbps, un álbum ocupa 108 MB. Por tanto, mil álbumes ocupan aproximadamente 108 GB.

El formato sin pérdida cambia el resultado. Un FLAC con calidad de CD tiene una media cercana a 900 kbps en material normal, por lo que esos mismos mil álbumes necesitan aproximadamente 304 GB. Una biblioteca en 24 bits y 96 kHz ocupa aproximadamente 1,013 GB, un terabyte completo para una colección que podría enumerar en papel. Una copia Opus optimizada para teléfonos a 128 kbps permite almacenar esos mismos mil álbumes en 43 GB. Ejecute du -sh /path/to/music sobre la biblioteca que ya tiene, porque su tasa de bits media es el único dato que importa al elegir un plan.

El ancho de banda es la parte menor de la factura. Un flujo de 320 kbps equivale a 40 kilobytes por segundo, por lo que una hora de escucha transfiere aproximadamente 144 MB. Cien horas al mes son unos 14 GB, una cantidad que ninguna cuota de transferencia de un VPS suele notar. La excepción es la primera sincronización sin conexión de un teléfono, que puede transferir decenas de gigabytes en una sola tarde.

¿Nivel de almacenamiento o nivel de cómputo?

Un servidor de música contiene una gran cantidad de datos fríos y casi no necesita capacidad de cómputo. Leer un archivo a 40 kilobytes por segundo mantiene cualquier disco prácticamente inactivo. La CPU sólo trabaja de verdad durante un análisis de la biblioteca, durante la transcodificación, que normalmente no necesitará, y cuando extrae y almacena en caché las carátulas, durante el análisis o la primera vez que alguien abre un elemento. Por tanto, el NVMe rápido de un plan de cómputo no le aporta nada, mientras que su precio por gigabyte es lo que impide subir las copias FLAC. Este es el caso en el que un VPS de almacenamiento supera a un VPS normal, porque esos planes se facturan por terabyte y no por núcleo.

La memoria necesaria es moderada. Navidrome sirve una biblioteca personal con unos pocos cientos de megabytes, y el análisis representa el pico de consumo, no la reproducción. Asigne al servidor 1 GB o 2 GB de RAM y destine el resto del presupuesto al disco.

Instalar Navidrome con Docker Compose

Cree primero los directorios y asígneles como propietario el identificador de usuario con el que se ejecutará el contenedor. Si no conoce Compose, Docker Compose en un VPS explica las suposiciones de este archivo.

sudo install -d -m 755 -o 1000 -g 1000 /srv/navidrome /srv/music

Escriba docker-compose.yml sin añadir prácticamente nada más y dentro de su propio directorio:

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:ro
docker compose up -d
docker compose ps

docker compose ps debe mostrar el servicio como en ejecución, no como reiniciándose. Un contenedor que se reinicia en bucle casi siempre tiene un problema de permisos en /srv/navidrome, y docker compose logs navidrome indica el nombre del archivo que no pudo escribir.

Conviene explicar cuatro detalles de ese archivo. El puerto se publica sólo en 127.0.0.1, por lo que se puede acceder al servidor mediante el proxy inverso y no por el puerto 4533 desde Internet abierta: Docker escribe sus propias reglas de firewall, de modo que un 4533:4533 normal sigue expuesto incluso en un equipo donde ufw informa que todo está denegado. El volumen de música es de sólo lectura, por lo que un error del escáner no puede borrar su única copia. ND_SCANNER_SCHEDULE está desactivado de forma predeterminada, y las guías escritas antes de Navidrome 0.55 lo denominan ND_SCANSCHEDULE, el nombre antiguo que 0.55 cambió. Las tres opciones de copia de seguridad activan la copia de seguridad integrada de la base de datos en la que se basa la sección de copias de seguridad siguiente.

Transfiera la música al servidor

Copie la biblioteca con rsync. Si la conexión se interrumpe, la transferencia se reanuda en lugar de comenzar de nuevo.

rsync -av --info=progress2 ~/Music/ user@music.example.com:/srv/music/

La barra final de la ruta de origen es importante. Sin ella, obtiene /srv/music/Music. Cuando termine la copia, corrija el propietario:

sudo chown -R 1000:1000 /srv/music
id -u

El contenedor se ejecuta con el ID de usuario 1000 y el montaje es de sólo lectura. Por tanto, ese ID necesita acceso de lectura a todos los archivos y permiso de recorrido en todos los directorios. Si la copia queda asignada a otra cuenta con permisos que impiden el acceso al resto de usuarios, el análisis no encuentra ninguna pista, aunque la interfaz web sigue apareciendo vacía, y el registro muestra open /music: permission denied. El chown anterior es una forma de corregirlo. Si otros programas también utilizan la carpeta, la documentación de Docker de Navidrome recomienda habilitar el acceso de lectura sin cambiar el propietario: sudo chmod -R a+rX /srv/music. id -u muestra su ID real, y explicación completa de cómo funcionan PUID y PGID en los contenedores Docker describe el mapeo en detalle.

Un reverse proxy y TLS para que el teléfono funcione desde cualquier lugar

Apunte un registro DNS A al VPS y proporcione a Caddy estas tres líneas:

music.example.com {
    reverse_proxy 127.0.0.1:4533
}
sudo systemctl reload caddy

Caddy solicita el certificado en segundo plano en cuanto carga el sitio, sin esperar a que llegue un visitante. El puerto 443 debe estar abierto. Caddy habilita dos desafíos ACME (automatic certificate management environment) de forma predeterminada: el desafío HTTP en el puerto 80 y el desafío TLS-ALPN en el puerto 443. Elige uno al azar, en lugar de empezar siempre por HTTP. Después de un fallo, reintenta una vez y cambia al otro desafío, por lo que un puerto 80 cerrado no impide obtener el certificado. Mantenga abierto el puerto 80 de todos modos, porque allí se sirve la redirección automática de HTTP a HTTPS de Caddy. En nginx, añada proxy_buffering off; al bloque location: Navidrome envía eventos de progreso a la interfaz web mediante una conexión persistente, y con el buffering activado la interfaz espera una respuesta que nginx todavía mantiene retenida. Si lo sirve bajo una ruta como /music en lugar de usar su propio subdominio, establezca ND_BASEURL con la misma ruta; de lo contrario, la interfaz se carga como una página en blanco. Los tres proxies habituales se comparan en Nginx, Caddy y Traefik en un VPS.

Abra el sitio y cree la primera cuenta. No hay una contraseña predeterminada y al primer visitante se le pide crear el usuario administrador, así que hágalo antes de comunicar la dirección a otras personas. Después, pruebe la ruta exacta que utiliza un cliente móvil:

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"

Una respuesta correcta empieza por {"subsonic-response":{"status":"ok" e indica navidrome como tipo de servidor. Un cuerpo que contiene "status":"failed" y el código de error 40 significa que el proxy funciona y que las credenciales son incorrectas. Un error de certificado en este paso es lo primero que debe corregir, porque la mayoría de los clientes móviles rechazan un certificado incorrecto con un mensaje que no proporciona información útil al usuario.

Por qué tu biblioteca aparece mal después del primer escaneo

Navidrome examina las etiquetas, no las carpetas, por lo que las etiquetas determinan lo que ves. Una pista sin etiqueta de artista del álbum se clasifica con su artista de pista. Por eso, una recopilación con un artista diferente en cada pista se convierte en veinte álbumes de una sola pista. Corrígelo en los archivos, no en Navidrome: MusicBrainz Picard y beets buscan el álbum en la base de datos de MusicBrainz y escriben de nuevo las etiquetas estándar.

Navidrome también separa una etiqueta con varios artistas en artistas independientes. Por eso, una banda cuyo nombre contiene un separador se divide por error; AC/DC es el ejemplo más habitual. ND_SCANNER_ARTISTSPLITEXCEPTIONS contiene los nombres que nunca deben separarse.

Los archivos nuevos se detectan unos segundos después de copiarse. El observador depende de las notificaciones de cambios del kernel. Estas notificaciones no llegan para los archivos escritos en un recurso compartido de red montado desde otra máquina. En ese tipo de configuración, el ND_SCANNER_SCHEDULE periódico es lo que mantiene actualizada la biblioteca. Un escaneo completo lee las etiquetas de todos los archivos. Esto es lento en una biblioteca grande y es una de las razones por las que conviene proteger la base de datos siguiente.

Usuarios, listas de reproducción y uso compartido

Un administrador crea las demás cuentas en la interfaz web y no existe el registro de usuarios. Cada usuario tiene recuentos de reproducciones, listas de reproducción, favoritos y valoraciones independientes, por lo que los miembros de una familia no terminan compartiendo un único perfil de gustos.

Las listas de reproducción llegan de dos formas. Una lista creada en un cliente se guarda en la base de datos. Un archivo .m3u colocado en la carpeta de la biblioteca se importa durante el análisis. Esta es la forma sencilla de transferir listas desde un reproductor de escritorio. Las listas de reproducción inteligentes son archivos .nsp: archivos JSON pequeños con reglas que se importan del mismo modo y se actualizan automáticamente cuando cambia la biblioteca.

El uso compartido está habilitado de forma predeterminada desde la versión 0.63.0, publicada en julio de 2026. Permite que un usuario cree un enlace público a un álbum que cualquiera puede abrir sin iniciar sesión. En un servidor que contiene toda la biblioteca, quizá no sea lo que necesita. Establecer ND_ENABLESHARING en false lo desactiva.

Haga una copia de seguridad de la base de datos por separado de los archivos de música

La copia de seguridad propia de Navidrome sólo cubre la base de datos. La documentación lo indica claramente: el proceso hace una copia de la base de datos, incluidos los usuarios, las reproducciones y el resto de los datos, pero no copia la música ni la configuración. Esta separación es la forma correcta de plantearlo, porque ambas partes fallan de manera distinta. Los archivos de música se pueden volver a copiar desde el disco del que se extrajeron. Las reproducciones, las valoraciones, los favoritos y las listas de reproducción no existen en ningún otro lugar, y un nuevo escaneo no los recupera.

El archivo de compose ya guarda una copia nocturna en /data/backup y conserva siete. Cree una copia manual antes de actualizar:

sudo docker compose run --rm navidrome backup create

La actualización de 0.63 a 0.64 es la que más necesita esta precaución. La versión 0.64.0 vuelve a codificar todos los identificadores internos en una migración que afecta a todas las tablas, y los clientes que conservan descargas sin conexión pueden necesitar volver a sincronizarse después.

La restauración elimina la base de datos actual y copia la copia de seguridad en su lugar. Debe ejecutarse mientras Navidrome está detenido. Una restauración no es segura con el servidor en ejecución.

Esos archivos siguen almacenados en el mismo VPS, por lo que no sobreviven a una pérdida del VPS. Envíe /srv/navidrome a otra máquina o a un almacenamiento de objetos según una programación. Esa es precisamente la función para la que están diseñados restic y BorgBackup. El directorio completo es pequeño, normalmente muy inferior a un gigabyte, por lo que una copia diaria cifrada fuera del servidor casi no cuesta nada y permite recuperar todo lo que un nuevo escaneo no puede recuperar.

FAQ

¿Necesito transcodificar la música en un VPS?

Casi nunca. Los teléfonos decodifican MP3, AAC, Opus y FLAC por sí mismos, al igual que los navegadores actuales en la mayoría de los sistemas. Por tanto, el servidor envía el archivo tal cual y utiliza casi nada de CPU. El navegador es el elemento que debe comprobarse: Firefox reproduce AAC sólo cuando el sistema operativo o una biblioteca externa proporciona el decodificador. Por eso, un reproductor web con una biblioteca AAC puede necesitar un flujo transcodificado. El caso en el que más conviene activarla es una biblioteca FLAC transmitida mediante datos móviles. Convertirla desde aproximadamente 900 kbps a Opus a 128 kbps reduce los datos utilizados aproximadamente siete veces. Navidrome admite la transcodificación gestionada en el servidor desde la versión 0.61: detecta los códecs compatibles con el cliente, aplica valores predeterminados de bitrate según el formato y permite limitar el bitrate por reproductor.

¿Por qué la aplicación de mi teléfono no puede descargar música para escucharla sin conexión?

Porque el almacenamiento sin conexión es una función del cliente, no del servidor. La API de Subsonic permite que cualquier cliente descargue un archivo completo, pero la aplicación decide si conserva una copia en el teléfono. Consulte el directorio de clientes en navidrome.org/apps y elija uno cuya descripción mencione las descargas sin conexión o el almacenamiento en caché. Algunos clientes sólo almacenan en caché lo que ya ha reproducido. Eso no equivale a sincronizar un álbum antes de un viaje.

¿Por qué un álbum se dividió en varios álbumes después del escaneo?

Falta la etiqueta del artista del álbum o sus valores no son coherentes entre las pistas. Navidrome agrupa por etiquetas, no por carpetas. Por eso, doce pistas con doce valores de artista diferentes y sin un valor común de artista del álbum aparecen como doce álbumes. Establezca la etiqueta del artista del álbum en todas las pistas del álbum, normalmente como Various Artists para una recopilación, y deje que Navidrome vuelva a escanear la biblioteca. MusicBrainz Picard o beets pueden hacerlo de una vez para toda una carpeta.

¿El streaming de música autohospedado sustituye a Spotify?

Sustituye al reproductor y a la biblioteca, no al catálogo. Tiene su propia colección en todos los dispositivos, con las listas de reproducción y los recuentos de reproducciones que ningún cambio de licencia puede quitarle. No obtiene lanzamientos nuevos ni recomendaciones basadas en lo que escuchan otras personas. La mayoría de las personas que utilizan este sistema compran su música y mantienen una cuenta de streaming económica para descubrir música nueva.

¿Te resultó útil este artículo?

#navidrome#music#streaming#self-hosting#media-server