Audiobookshelf Docker Compose: Tu Biblioteca de Audiolibros 2025

Si buscas una solución moderna para gestionar tus audiolibros y podcasts, Audiobookshelf Docker Compose es la herramienta perfecta. Este servidor self-hosted te permite organizar tu colección completa, sincronizar tu progreso entre dispositivos y disfrutar de tus contenidos sin depender de servicios en la nube.

En esta guía completa aprenderás a desplegar Audiobookshelf usando Docker Compose, configurar tus bibliotecas y aprovechar todas sus funcionalidades para crear tu propio Netflix de audiolibros.

Qué es Audiobookshelf Docker Compose

Audiobookshelf Docker Compose es un servidor de medios self-hosted diseñado específicamente para gestionar audiolibros y podcasts. A diferencia de otras soluciones multimedia generalistas, esta aplicación está optimizada para contenido de audio largo con características como seguimiento de progreso, gestión de capítulos y sincronización entre dispositivos.

El proyecto es completamente open-source y cuenta con una comunidad activa en GitHub. Su arquitectura basada en Node.js y FFmpeg garantiza compatibilidad con todos los formatos de audio modernos mientras mantiene un consumo de recursos reducido.

Lo mejor de esta solución es que puedes tenerla funcionando en minutos con un simple archivo docker-compose.yml, sin necesidad de configuraciones complejas ni dependencias externas difíciles de gestionar.

Características principales de Audiobookshelf

Esta plataforma ofrece funcionalidades que rivalizan con servicios comerciales:

• Streaming universal: Reproduce cualquier formato de audio al vuelo sin conversiones previas
• Gestión de podcasts: Busca, suscríbete y descarga episodios automáticamente
• Multi-usuario: Permisos personalizados y seguimiento individual del progreso de reproducción
• Sincronización: Tu progreso se mantiene actualizado entre todos tus dispositivos
• Apps móviles: Aplicaciones nativas para Android e iOS con reproducción offline
• Gestión de metadatos: Búsqueda automática de información, portadas y capítulos desde múltiples fuentes
• Conversión M4B: Combina archivos múltiples en audiolibros con capítulos incrustados
• E-reader integrado: Soporte para EPUB, PDF, CBR y CBZ con envío a Kindle
• Feeds RSS: Genera feeds abiertos para compartir audiolibros y podcasts
• Backups automáticos: Copias de seguridad diarias de metadatos y configuración

Requisitos previos para Audiobookshelf Docker Compose

Antes de comenzar con la instalación, asegúrate de tener preparado lo siguiente:

• Docker y Docker Compose: Versión 20.10 o superior recomendada
• Sistema operativo: Linux (Ubuntu, Debian, CentOS), Windows con WSL2, o macOS
• Recursos mínimos: 512MB RAM y 1GB espacio para la aplicación
• Almacenamiento: Espacio suficiente para tu colección de audiolibros
• Puertos disponibles: Puerto 13378 (o el que prefieras configurar)

Si planeas acceder desde Internet, también necesitarás configurar un proxy inverso con certificado SSL. Herramientas como Caddy o Nginx Proxy Manager funcionan perfectamente con esta aplicación.

Instalación con Audiobookshelf Docker Compose

La instalación es extremadamente sencilla. Crea un directorio para tu proyecto y prepara la siguiente estructura:

mkdir -p ~/audiobookshelf/{audiobooks,podcasts,config,metadata}
cd ~/audiobookshelf
nano docker-compose.yml

Ahora crea tu archivo Audiobookshelf Docker Compose con esta configuración optimizada:

version: '3.8'

services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    restart: unless-stopped
    ports:
      - "13378:80"
    volumes:
      - ./audiobooks:/audiobooks
      - ./podcasts:/podcasts
      - ./config:/config
      - ./metadata:/metadata
    environment:
      - TZ=Europe/Madrid
      - AUDIOBOOKSHELF_UID=1000
      - AUDIOBOOKSHELF_GID=1000
    networks:
      - audiobookshelf_network

networks:
  audiobookshelf_network:
    driver: bridge

Ajusta la zona horaria (TZ) a tu ubicación y verifica que los UID/GID coincidan con tu usuario del sistema para evitar problemas de permisos.

Inicia el servicio con un simple comando:

docker-compose up -d

Verifica que el contenedor esté ejecutándose correctamente:

docker-compose logs -f

Accede a la interfaz web en http://tu-servidor:13378 y completa la configuración inicial creando tu cuenta de administrador.

Configuración inicial de bibliotecas

Una vez dentro del panel de administración, el primer paso es configurar tus bibliotecas. El sistema soporta dos tipos principales: audiolibros y podcasts.

Para crear una biblioteca de audiolibros:

1. Haz clic en «Bibliotecas» en el menú lateral
2. Selecciona «Crear biblioteca»
3. Elige el tipo «Audiolibros»
4. Asigna la ruta /audiobooks que montaste en el contenedor
5. Configura el proveedor de metadatos (Audible, Google Books, OpenLibrary)
6. Guarda los cambios

La aplicación escaneará automáticamente la carpeta y detectará tus audiolibros. La estructura de carpetas recomendada es:

/audiobooks
  /Autor - Título del Libro
    - 01-capitulo.mp3
    - 02-capitulo.mp3
    - cover.jpg

El sistema también soporta audiolibros en un solo archivo M4B con capítulos incrustados, que es el formato más eficiente.

Gestión avanzada de metadatos

Una de las características más potentes del servicio es su capacidad para gestionar metadatos de forma inteligente. El sistema puede buscar automáticamente información de múltiples fuentes y completar campos como autor, narrador, descripción, géneros y portadas.

Para optimizar la detección automática:

• Nombra tus carpetas siguiendo el patrón «Autor – Título»
• Incluye archivos de portada (cover.jpg o folder.jpg)
• Mantén metadatos ID3 básicos en los archivos de audio
• Utiliza el buscador integrado cuando la detección automática falle

También puedes editar manualmente cualquier campo desde la interfaz web, incluyendo la gestión de capítulos con timestamps precisos.

Aplicaciones móviles y reproducción offline

Una de las ventajas más importantes es contar con apps móviles nativas para Android e iOS. Ambas aplicaciones están disponibles en sus respectivas tiendas y son completamente gratuitas.

Las apps permiten:

• Descarga offline: Guarda audiolibros completos para escuchar sin conexión
• Sincronización automática: Tu progreso se actualiza en tiempo real entre dispositivos
• Control de reproducción: Velocidad variable, sleep timer, bookmarks
• Gestión de colas: Crea listas de reproducción personalizadas
• Integración con CarPlay/Android Auto: Control desde tu vehículo

Para conectar la app móvil, simplemente escanea el código QR que aparece en la configuración del servidor o introduce manualmente la URL y tus credenciales.

Integración con proxy inverso y SSL

Para acceder de forma segura desde cualquier lugar, necesitas configurar un proxy inverso con certificado SSL. La documentación oficial incluye ejemplos para Nginx, Caddy, Traefik y Apache.

Aspecto crítico: debes asegurar que el proxy soporte WebSockets correctamente. Ejemplo de configuración con Caddy:

audiobooks.tudominio.com {
    reverse_proxy audiobookshelf:80 {
        transport http {
            response_header_timeout 0
        }
    }
}

Con Nginx necesitas incluir las directivas específicas para WebSocket:

location / {
    proxy_pass http://localhost:13378;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

Una vez configurado el proxy, puedes acceder mediante HTTPS y las apps móviles funcionarán sin problemas desde redes externas.

Gestión de usuarios y permisos

El sistema multiusuario permite crear cuentas para toda tu familia con permisos granulares. Cada usuario mantiene su propio progreso de reproducción, bookmarks y estadísticas independientes.

Los roles disponibles son:

• Administrador: Control total sobre configuración, usuarios y bibliotecas
• Usuario: Acceso a reproducción y gestión de su progreso personal
• Invitado: Acceso limitado solo a reproducción sin capacidad de modificar

También puedes restringir el acceso de usuarios específicos a determinadas bibliotecas, útil si tienes contenido para adultos o material educativo separado.

Backups y mantenimiento

La aplicación genera backups automáticos diarios de toda la base de datos, incluyendo usuarios, progreso, metadatos y configuración. Estos backups se almacenan en el directorio /metadata/backups.

Para garantizar la seguridad de tus datos, configura un backup externo de los directorios críticos:

tar -czf audiobookshelf-backup-$(date +%Y%m%d).tar.gz \
  ~/audiobookshelf/config \
  ~/audiobookshelf/metadata

Las actualizaciones son automáticas si utilizas la etiqueta :latest en tu configuración. Simplemente ejecuta:

docker-compose pull
docker-compose up -d

El sistema mantendrá todos tus datos intactos durante las actualizaciones.

Optimización y mejores prácticas

Para obtener el mejor rendimiento:

• Formato M4B: Usa la función integrada de conversión para consolidar archivos múltiples
• Organización: Mantén una estructura de carpetas consistente para facilitar el escaneo
• Portadas: Incluye imágenes de al menos 600x600px para visualización óptima
• Escaneo incremental: Configura escaneos automáticos en horarios de baja actividad
• Cache: El directorio metadata/cache puede crecer, límpialo periódicamente
• Recursos: Asigna al menos 1GB RAM si gestionas bibliotecas superiores a 1000 títulos

Para colecciones muy grandes, considera separar audiolibros y podcasts en instancias diferentes para mejorar el rendimiento.

Casos de uso reales

Esta solución es perfecta para diversos escenarios:

• Bibliotecas personales: Gestiona tu colección de audiolibros comprados sin DRM
• Contenido educativo: Ideal para cursos, conferencias y material de aprendizaje
• Podcasts locales: Descarga y organiza episodios para escucha offline
• Bibliotecas familiares: Comparte contenido con múltiples usuarios y perfiles
• Archivos históricos: Preserva grabaciones de audio con metadatos estructurados

La comunidad en Reddit r/selfhosted comparte constantemente casos de uso innovadores y configuraciones avanzadas.

Comparación con alternativas

Existen otras opciones para gestionar audiolibros self-hosted, pero esta solución destaca por:

• Frente a Plex: Especialización en audiolibros, mejor gestión de capítulos y progreso
• Frente a Booksonic: Interfaz más moderna, apps móviles activas y mejor rendimiento
• Frente a Jellyfin: Optimización específica para audio largo, mejor experiencia de usuario

El desarrollo activo y la comunidad comprometida garantizan mejoras constantes y soporte a largo plazo.

Preguntas frecuentes (FAQ)

¿Necesito conocimientos avanzados para instalar Audiobookshelf?

No. Si sabes ejecutar comandos básicos de Docker Compose, puedes tenerlo funcionando en menos de 5 minutos. La configuración inicial es intuitiva y la interfaz web te guía en cada paso.

¿Qué formatos de audio soporta?

Todos los formatos populares: MP3, M4A, M4B, AAC, OGG, OPUS, FLAC, WMA, y más. Gracias a FFmpeg, puede transcodificar cualquier formato al vuelo para streaming.

¿Puedo acceder desde Internet de forma segura?

Sí. Configurando un proxy inverso con SSL (Nginx, Caddy, Traefik) puedes acceder de forma cifrada desde cualquier lugar. Las apps móviles funcionan perfectamente con HTTPS.

¿Consume muchos recursos del servidor?

No. Con 512MB RAM y un procesador modesto es suficiente para bibliotecas medianas. El streaming consume recursos mínimos gracias a su eficiente arquitectura.

¿Las apps móviles son gratuitas?

Completamente. Las aplicaciones para Android e iOS son open-source y gratuitas, disponibles en Google Play y App Store. No hay compras dentro de la app ni limitaciones.

Conclusión

Audiobookshelf Docker Compose representa la solución definitiva para gestionar audiolibros y podcasts de forma self-hosted. Su combinación de facilidad de uso, características profesionales y apps móviles nativas lo convierten en la mejor alternativa a servicios comerciales como Audible.

La instalación mediante contenedores garantiza portabilidad total y actualizaciones sin complicaciones. El sistema multiusuario, sincronización automática y gestión inteligente de metadatos ofrecen una experiencia comparable a plataformas comerciales, pero con control total sobre tus datos.

Si valoras la privacidad, quieres evitar suscripciones mensuales o simplemente prefieres tener control completo sobre tu contenido, esta es la solución que necesitas. Con una comunidad activa y desarrollo constante, el futuro del proyecto se ve prometedor.

Empieza hoy mismo a construir tu biblioteca personal de audiolibros y descubre la libertad de gestionar tu contenido sin restricciones.

¿Quieres explorar más soluciones self-hosted? Visita nuestra categoría de Docker Compose para descubrir otras herramientas que puedes desplegar en tu servidor.