Guía

Tu propio servidor de música en una Raspberry Pi

Una Raspberry Pi es una forma silenciosa y de bajo consumo de tener toda tu colección de música en casa y escucharla desde cualquier sitio. Esta guía monta una con Navidrome, un servidor de música gratuito y de código abierto que funciona con soltura en una Pi, y le conecta Audex. Calcula unos 30 minutos, la mayor parte esperando descargas.

Unos 30 minutos Raspberry Pi 3, 4 o 5 Navidrome + Docker

Qué necesitas

  • Una Raspberry Pi 4 o 5 (una Pi 3 también sirve). Navidrome necesita muy poco; 2 GB de memoria son de sobra.
  • Una tarjeta microSD de 16 GB o más, y la fuente de alimentación de la Pi. Para una colección grande, un SSD USB es mejor que la tarjeta.
  • Una conexión de red. Un cable al router es lo más fiable; la wifi también sirve.
  • Un ordenador para preparar la tarjeta y copiar tu música, en la misma red que la Pi.
  • Tus archivos de música (MP3, FLAC, M4A, OGG, Opus y similares) y Audex en tu teléfono.

¿Prefieres verlo antes?

Este vídeo muestra cómo se instala Navidrome en una Raspberry Pi 5, y después cómo corregir las etiquetas de las canciones y añadir radio por internet. Los pasos de abajo siguen la instalación oficial de Navidrome con Docker, así que los comandos difieren un poco del vídeo; ambos terminan con el mismo servidor. (El vídeo está en inglés.)

Navidrome se instala a partir del minuto 4:29. Vídeo de Jeffs Pi in the Sky, sin relación con Audex. No se carga nada de YouTube hasta que pulsas reproducir. Ver en YouTube

1. Prepara la Raspberry Pi

  1. Instala Raspberry Pi OS en la tarjeta

    Instala Raspberry Pi Imager en tu ordenador, elige tu modelo de Pi y luego Raspberry Pi OS Lite (64-bit) en «Raspberry Pi OS (other)». En un servidor no necesitas escritorio.

    Descargar Raspberry Pi Imager
  2. Rellena los ajustes antes de grabar

    Cuando Imager te ofrezca personalizar el sistema, pon un nombre de equipo como audex-pi, un usuario y una contraseña, tu wifi si no usas cable, y activa SSH con inicio de sesión por contraseña. Después graba la tarjeta, ponla en la Pi y enciéndela. El primer arranque tarda unos minutos.

  3. Conéctate a la Pi desde tu ordenador

    Abre un terminal (PowerShell en Windows, Terminal en macOS o Linux) e inicia sesión con el usuario que elegiste:

    ssh [email protected]

    Si no encuentra audex-pi.local, usa la dirección IP de la Pi que aparece en la lista de dispositivos de tu router.

  4. Actualízala
    sudo apt update && sudo apt full-upgrade -y

2. Instala Navidrome

  1. Instala Docker

    Docker ejecuta Navidrome en un contenedor fácil de actualizar. Esto usa el script de instalación oficial de Docker y luego permite a tu usuario usarlo sin sudo:

    curl -fsSL https://get.docker.com -o get-docker.sh
    sudo sh get-docker.sh
    sudo usermod -aG docker $USER

    Escribe exit y vuelve a iniciar sesión con ssh para que el cambio surta efecto.

  2. Crea carpetas para Navidrome y tu música
    mkdir -p ~/navidrome/data ~/music
  3. Copia tu música a la Pi

    Desde un terminal de tu ordenador (no de la Pi), copia una carpeta de música. Repite para cada carpeta o copia toda tu biblioteca de una vez:

    scp -r "Path/To/Your Music Folder" [email protected]:music/

    Una biblioteca grande se copia más rápido desde una unidad USB conectada a la Pi. Mantén una carpeta por artista o álbum; Navidrome lee las etiquetas de los archivos de todos modos.

  4. Describe el servidor en un archivo Compose

    De vuelta en la Pi, abre un archivo nuevo:

    nano ~/navidrome/compose.yaml

    Pega esto y guarda con Ctrl+O, Intro, y cierra con Ctrl+X:

    services:
      navidrome:
        image: navidrome/navidrome:latest
        user: 1000:1000
        ports:
          - "4533:4533"
        restart: unless-stopped
        volumes:
          - ./data:/data
          - ../music:/music:ro

    1000:1000es el primer usuario de Raspberry Pi OS, el que creaste. La carpeta de música se monta en solo lectura, así que Navidrome nunca puede cambiar tus archivos.

  5. Ponlo en marcha
    cd ~/navidrome
    docker compose up -d

    El primer arranque descarga Navidrome. restart: unless-stopped lo vuelve a arrancar solo cada vez que la Pi se reinicia.

  6. Crea tu cuenta de Navidrome

    En un navegador de tu ordenador, abre http://audex-pi.local:4533 y crea el primer usuario; será el administrador. Después Navidrome analiza tu carpeta de música por sí solo y los álbumes aparecen en pocos minutos.

  7. Dale a la Pi una dirección fija

    Averigua la dirección de la Pi con hostname -I y resérvala en los ajustes de tu router (suele llamarse reserva DHCP o IP estática). Así la dirección que le das a Audex nunca cambia.

3. Conecta Audex

  1. Añade el servidor

    En Audex, abre Ajustes → Servidores multimedia → Añadir servidor y elige Subsonic / OpenSubsonic / Navidrome. (Los servidores Jellyfin, Emby y Kodi aparecen solos en En esta red; Navidrome no se anuncia en la red, así que lo añades por su dirección.)

  2. Escribe su dirección y tus credenciales

    Usa la dirección y el puerto de la Pi, por ejemplo http://192.168.1.50:4533, con el usuario y la contraseña de Navidrome que acabas de crear. Audex prueba la conexión antes de guardar, así que sabrás al instante que funciona.

  3. Activa Reproducir en calidad original

    En el mismo formulario (o más tarde, en la página del servidor en Ajustes → Servidores multimedia), activa Reproducir en calidad original. La Pi enviará tus archivos tal cual en vez de convertirlos, lo que la mantiene fresca y rápida. Fuera de casa gasta más datos móviles, así que déjalo desactivado si tu tarifa es pequeña.

  4. Reproduce algo

    Elige el servidor en el selector de fuentes, arriba en la Biblioteca. Los álbumes, artistas, géneros y listas aparecen tal como los organiza Navidrome, y todo se puede descargar para escucharlo sin conexión.

Opcional: escucha fuera de casa

Tu Pi solo es accesible en tu red doméstica hasta que añadas una forma de entrar desde fuera. La más sencilla y segura es una VPN privada como Tailscale, que no requiere tocar el router:

  1. Instala Tailscale en la Pi e inicia sesión
    curl -fsSL https://tailscale.com/install.sh | sh
    sudo tailscale up

    Abre el enlace que muestra para iniciar sesión e instala la app de Tailscale en tu teléfono con la misma cuenta.

    Conseguir Tailscale
  2. Añádela como segunda dirección del servidor

    Edita el servidor en Audex y pon la dirección Tailscale de la Pi (empieza por 100., más :4533) en Segunda dirección (opcional). En casa, Audex usa tu dirección de casa; cuando no responde, cambia por sí solo a la segunda.

¿Usas HTTPS con un certificado autofirmado? Audex muestra los detalles del certificado y su huella SHA-256 la primera vez, para que confíes exactamente en ese certificado. Si alguna vez cambia, Audex se detiene y te pregunta antes de volver a conectarse.

Si algo no funciona

Navidrome se abre, pero la biblioteca está vacía
Navidrome no puede leer la carpeta de música. Haz que tu usuario sea su propietario y reinicia Navidrome:
sudo chown -R 1000:1000 ~/music ~/navidrome/data
cd ~/navidrome && docker compose restart
Audex no consigue conectar con el servidor
Comprueba que tu teléfono esté en la misma wifi que la Pi y que la dirección en Audex incluya :4533. En la Pi, docker compose ps (dentro de ~/navidrome) debería mostrar Navidrome en marcha. Si la dirección de la Pi cambió, resérvala en el router como en el paso 2.
¿Cómo actualizo Navidrome más adelante?
En la Pi:
cd ~/navidrome
docker compose pull && docker compose up -d
Tu cuenta y tus ajustes están en ~/navidrome/data y se conservan.
¿Puedo usar Jellyfin en la Pi en su lugar?
Sí. Jellyfin funciona bien para música en una Pi 4 o 5, y Audex se conecta igual (puerto 8096), normalmente encontrándolo solo en En esta red. Para vídeo, usa formatos que tus dispositivos reproduzcan directamente, porque una Pi no convierte vídeo con rapidez. Navidrome es la opción más ligera si solo necesitas música.

¿Sigues atascado? Escribe a [email protected]: una persona real lee cada mensaje.