Tropic Host

Audiobookshelf en un VPS: tu propia biblioteca de audiolibros y podcasts

7 min de lectura
Tropic
Audiobookshelf en un VPS: tu propia biblioteca de audiolibros y podcasts

Audiobookshelf: cómo crear tu propio servidor de audiolibros y podcasts

Empezar a escuchar un libro en el ordenador, continuar desde el mismo punto en el teléfono, descargarlo antes de un viaje y no perder el progreso al cambiar de dispositivo: para todo ello no es necesario depender de otro servicio de pago. Audiobookshelf convierte tu propia colección de archivos de audio en una biblioteca en línea ordenada, con portadas, capítulos, aplicaciones y perfiles separados para toda la familia.

No es una tienda ni una fuente de libros gratuitos. El usuario añade por su cuenta archivos de audio obtenidos legalmente y sin una protección DRM incompatible. A cambio, los libros, el historial de escucha y los ajustes permanecen en su propio servidor.

Qué es Audiobookshelf

Audiobookshelf es un servidor gratuito, de código abierto y autoalojado para audiolibros y podcasts. Escanea las carpetas con archivos multimedia, organiza la biblioteca por autores y series, descarga metadatos y portadas y, después, permite escuchar la colección desde un navegador o una aplicación móvil.

En esencia, es un servicio personal de streaming cuyo catálogo creas tú mismo. El servidor almacena la biblioteca y el progreso, mientras que el teléfono, la tableta o el ordenador actúan como clientes. Por eso puedes detener un libro en un dispositivo y continuarlo en otro desde la posición guardada.

Audiobookshelf puede ejecutarse en casa, en un NAS o en un miniordenador. Un VPS es más práctico cuando necesitas acceder desde cualquier red sin mantener encendido un ordenador doméstico, configurar el reenvío de puertos ni depender de la conexión a Internet de casa.

Qué puede hacer Audiobookshelf

Sincronizar el progreso entre dispositivos

Para cada usuario se guardan por separado la posición, el historial y los marcadores. Hay disponibles una interfaz web, una Progressive Web App y clientes móviles oficiales para Android e iOS. También puedes descargar un libro previamente en el teléfono y escucharlo sin conexión a Internet.

Crear cuentas separadas

En un mismo servidor se pueden crear varios usuarios sin mezclar su progreso. El administrador define el acceso a las bibliotecas y los permisos y, cuando es necesario, restringe el contenido mediante etiquetas. Cada persona conserva su propia lista de libros empezados, su historial y sus marcadores.

Ordenar la biblioteca

El servicio obtiene títulos, descripciones, autores y portadas de fuentes externas, agrupa los libros por autores y series y permite corregir los capítulos y el orden de las pistas. Varios archivos MP3 se pueden unir en un único M4B, mientras que la portada y los metadatos pueden integrarse en el archivo. Antes de modificar los originales, conviene hacer una copia de la biblioteca.

Descargar podcasts automáticamente

Puedes añadir un podcast por su nombre, mediante un enlace RSS o con un archivo OPML y, después, programar la descarga de nuevos episodios. El servicio no transmite el episodio directamente: primero guarda el archivo en el servidor. Esto permite archivar episodios que podrían desaparecer, aunque requiere espacio en disco.

Guardar la versión electrónica junto al audiolibro

Puedes colocar un archivo EPUB, PDF, CBR, CBZ, AZW3 o MOBI en la carpeta del libro para abrir el audio y el texto desde la misma ficha. El lector integrado es básico y no sustituye a Calibre-Web ni a Kavita.

Para quién es adecuado Audiobookshelf

El servicio resulta especialmente útil en varios escenarios:

  • ya tienes una colección de audiolibros en MP3, M4B, M4A u otros formatos habituales;
  • escuchas desde varios dispositivos y quieres sincronización;
  • varios miembros de la familia utilizan la biblioteca;
  • necesitas conservar tu propio archivo de podcasts;
  • quieres controlar por tu cuenta los archivos, las cuentas de usuario y las copias de seguridad;
  • una carpeta normal en la nube ya resulta incómoda porque no incluye portadas, capítulos ni historial de escucha.

Si solo escuchas uno o dos libros en un único teléfono, puede que un servidor independiente sea innecesario. Audiobookshelf muestra todo su potencial cuando la colección crece o necesita acceso remoto permanente.

Qué servidor necesita Audiobookshelf

El proyecto no establece un mínimo oficial universal: la carga depende del tamaño de la biblioteca, del número de usuarios, del escaneo de archivos y de si es necesario transcodificar el audio. Para una colección personal pequeña, puedes tomar como referencia esta configuración inicial:

EscenarioCPURAMDisco
1–2 usuarios, biblioteca pequeña1 vCPU1 GBdesde 30–40 GB
Familia y varias conexiones simultáneas2 vCPU2 GBdesde 60–100 GB
Biblioteca grande, escaneo frecuente y procesamiento de archivos2–4 vCPU4 GBsegún el tamaño de la colección

Es una referencia práctica, no un mínimo oficial. El recurso principal es el disco. Un libro de diez horas a 64–128 Kbit/s ocupa aproximadamente 0,3–0,6 GB; por tanto, cien libros requerirán alrededor de 30–60 GB, sin contar los podcasts ni las copias. Lo razonable es empezar con un VPS pequeño que pueda ampliarse más adelante.

Cómo instalar Audiobookshelf mediante Docker Compose

Docker es el método de instalación recomendado por los desarrolladores. Supondremos que Docker y el complemento Compose ya están instalados en Ubuntu o Debian.

Crea el directorio del proyecto y las carpetas de datos:

mkdir -p /opt/audiobookshelf/{config,metadata,audiobooks,podcasts}
cd /opt/audiobookshelf

Crea el archivo compose.yml:

services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    ports:
      - "13378:80"
    volumes:
      - ./config:/config
      - ./metadata:/metadata
      - ./audiobooks:/audiobooks
      - ./podcasts:/podcasts
    environment:
      - TZ=UTC
    restart: unless-stopped

Inicia el contenedor:

docker compose up -d

Después del inicio, el panel estará disponible temporalmente en la dirección:

http://SERVER_IP:13378

En el primer acceso, crea el administrador raíz. Después, añade una biblioteca del tipo Books e indica el directorio /audiobooks. Para los podcasts, crea una biblioteca independiente con la ruta /podcasts.

Cómo organizar correctamente los audiolibros en carpetas

En Audiobookshelf, un libro suele corresponder a una carpeta. La estructura más clara es la siguiente:

/audiobooks/
  Autor/
    Serie/
      01 - Título del libro/
        01 - Capítulo.mp3
        02 - Capítulo.mp3
        cover.jpg

En el caso de un libro independiente, se puede omitir el nivel de la serie. Un único archivo M4B también puede guardarse en su propia carpeta de libro.

La estructura es importante: si colocas varios libros del mismo autor en una carpeta común, el escáner puede unirlos en una sola ficha. Es mejor ordenar los archivos antes del primer escaneo completo. Mover un libro entre bibliotecas se interpreta como la creación de un objeto nuevo, por lo que sus metadatos y su progreso no se transfieren automáticamente.

Cómo abrir la biblioteca a Internet de forma segura

No se recomienda dejar el panel expuesto de manera permanente en el puerto HTTP abierto 13378. Para el acceso remoto, es preferible configurar un dominio, un certificado HTTPS y un proxy inverso basado en Nginx, Caddy o Traefik.

Audiobookshelf utiliza WebSocket, por lo que hay que habilitar su compatibilidad en el proxy. Después de configurar HTTPS, el puerto del contenedor puede vincularse únicamente a la interfaz local:

ports:
  - "127.0.0.1:13378:80"

Utiliza contraseñas únicas, crea una cuenta separada para cada oyente, mantén el contenedor actualizado y no concedas permisos de administrador innecesarios.

Qué hay que saber sobre las copias de seguridad

Las copias integradas de Audiobookshelf guardan la base de datos y parte de los metadatos, incluidas las portadas del directorio metadata. Los audiolibros, los podcasts y las portadas almacenadas junto a los archivos multimedia no se incluyen en esa copia.

Por eso, una estrategia fiable de copias de seguridad consta de dos partes:

  1. una copia automática integrada de la base de datos y los metadatos;
  2. una copia independiente de los directorios audiobooks y podcasts en otro disco o en un almacenamiento remoto.

El directorio /config contiene la base de datos SQLite. Los desarrolladores recomiendan mantenerlo en un disco local del mismo servidor, en lugar de montarlo a través de la red: el almacenamiento en red puede reducir el rendimiento y provocar daños en la base de datos.

Audiobookshelf en un VPS de tropic.host

Para una biblioteca personal, la máxima potencia de cálculo importa menos que la disponibilidad constante, el espacio suficiente en disco y una conexión estable. En un VPS, Audiobookshelf funciona las 24 horas y está disponible desde el teléfono, el ordenador o la tableta, independientemente del estado de la red doméstica.

Para una colección pequeña, puedes empezar con un servidor básico de tropic.host, instalar Docker, conectar un dominio y HTTPS y aumentar los recursos a medida que crezca la biblioteca. Al elegir un plan, calcula primero el volumen de los archivos de audio y deja espacio para nuevos libros y podcasts.

Limitaciones que conviene conocer de antemano

Audiobookshelf no proporciona un catálogo de libros ni elimina la protección DRM. Funciona con archivos que el usuario ha añadido por su cuenta y tiene derecho a almacenar.

Las aplicaciones móviles se desarrollan activamente y mantienen oficialmente el estado de beta, por lo que la interfaz web o la PWA siguen siendo una alternativa útil. La compatibilidad con libros electrónicos es básica y, para importar una colección grande de forma ordenada, será necesario respetar la estructura de carpetas y corregir a veces los metadatos manualmente.

Para los audiolibros, el servicio aporta lo que falta en una carpeta convencional de la nube: capítulos, series, progreso, descarga sin conexión, perfiles y gestión de podcasts.

Resumen breve

Audiobookshelf convierte los archivos de audio en una biblioteca multimedia personal para distintos dispositivos y usuarios. La instalación mediante Docker Compose es sencilla, pero para un funcionamiento fiable hacen falta una estructura ordenada de carpetas, HTTPS y copias independientes de los archivos multimedia.

FAQ

¿Audiobookshelf es gratuito?

Sí. El servidor y los clientes oficiales se distribuyen como software de código abierto. Solo hay que pagar el hardware, el VPS, el dominio o el almacenamiento adicional si se utilizan.

¿Audiobookshelf proporciona audiolibros gratuitos?

No. Es un servidor y reproductor para tu propia colección. Debes obtener los archivos de audio legalmente y añadirlos a la biblioteca por tu cuenta.

¿Se pueden escuchar libros sin Internet?

Sí. La aplicación móvil permite descargar previamente un libro en el dispositivo. Una vez descargado, no se necesita conexión con el servidor para escucharlo.

¿Cuánta memoria RAM necesita Audiobookshelf?

Para una biblioteca pequeña y uno o dos usuarios, 1 GB de RAM es un punto de partida razonable. Para varios oyentes, escaneos extensos o procesamiento de archivos, es mejor elegir 2–4 GB.

¿Es obligatorio instalar Audiobookshelf en un VPS?

No. Puede ejecutarse en un servidor doméstico, un NAS o un ordenador compatible. Un VPS resulta más práctico cuando necesitas acceso permanente desde distintas redes sin configurar el router de casa ni depender de la conexión doméstica.

Audiobookshelf en un VPS: tu propia biblioteca de audiolibros y podcasts