Tutoriales de VPS
Libros en VPS: Kavita, Calibre-Web, OPDS y backups (2026)
Elige Kavita, Calibre-Web o Komga, prepara metadatos y permisos, protege instalación y HTTPS, conecta lectores OPDS y verifica backups consistentes.

Un servidor de libros reúne la colección para dispositivos compatibles y, cuando la aplicación lo permite, sincroniza progreso. Complementa las guías de música, vídeo y fotos. Usa archivos legibles que tengas derecho a guardar; alojarlos no elimina DRM ni restricciones de formato o dispositivo.
Comparamos Calibre-Web, Kavita y Komga y desplegamos los dos primeros, sin presuponer idioma, país o catálogo de metadatos.
| Opción | Punto de partida | Condiciones |
|---|---|---|
| Calibre-Web | Biblioteca gestionada con Calibre | Requiere base Calibre; conversión, correo y Kobo necesitan configuración propia |
| Kavita | Libros/cómics organizados para su escáner | Sin base Calibre; revisa formatos, lector y metadatos actuales |
| Komga | Colección principalmente de cómics | Revisa formatos, integración y recursos JVM |
EPUB, CBZ/CBR, Kobo y conversión dependen de versión: prueba archivos representativos. Calibre aporta conversión amplia (el original decía 50+ formatos), sin garantizar fidelidad ni eliminar DRM. RAM en reposo de 80 MB, 150–250 MB y 150 MB+, y estrellas 16.7k/10.1k/6k, eran instantáneas históricas.
- Ya usas Calibre: considera Calibre-Web.
- Libros/cómics sueltos desde cero: considera Kavita.
- Principalmente cómics: considera Komga.
Calibre-Web necesita metadata.db, no solo archivos EPUB.
| Tipo | Tamaño ilustrativo | Presupuesto original para 1000 |
|---|---|---|
| EPUB de texto | 1–5 MB | 3–5 GB |
| PDF escaneado | 20–100 MB | 30–80 GB |
| CBZ | 50–200 MB | 100 GB+ |
Mide la colección: son ejemplos, sin multiplicación exacta garantizada. 20 GB puede servir para texto pequeño; cómics/PDF suelen justificar 100 GB o más, más base, miniaturas y backups. 1 vCPU/2 GB es presupuesto inicial útil. 1 GB puede servir para Kavita ligero, pero escaneo y otros servicios necesitan margen. Miles de miniaturas pueden consumir CPU/I/O durante decenas de minutos.
books/
├── 刘慈欣/
│ ├── 三体.epub
│ ├── 三体Ⅱ·黑暗森林.epub
│ └── 球状闪电.epub
├── 阿西莫夫/
│ └── 基地.epub
└── 漫画/
└── 进击的巨人/
├── 第01卷.cbz
└── 第02卷.cbz
- Organiza subcarpetas y comprueba agrupación por autor/serie en el escáner.
- Evita apilar archivos en raíz sin probar; sigue reglas del formato y biblioteca.
- Usa nombres de autor/serie si ayudan, sin asumir que cada carpeta es siempre una serie: metadatos EPUB pueden determinarlo.
Respalda nombres y prueba unos libros antes de renombrar. Unicode/chino no son inválidos universalmente: conserva títulos y evita colisiones.
- Revisa paréntesis con los ejemplos
三体(一).epub,三体_I.epub/三体1.epub. - Prueba símbolos
★/【】y emoji en el parser real. - Comprueba numeración
①②/Ⅲantes de cambiarla.
Ante UnauthorizedAccessException, comprueba UID/GID reales y permisos de carpetas. Verifica antes de cambiar propietario: UID 1001 no es universal y el cambio recursivo afecta libros:
sudo chown -R 1001:1001 ~/ebooks/books
Concede permisos necesarios; monta libros solo lectura si no necesitas cargas o escritura de metadatos.
mkdir -p ~/ebooks/{config,books}
cd ~/ebooks
Crea docker-compose.yml:
services:
kavita:
image: jvmilazz0/kavita:latest
container_name: kavita
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
ports:
- "127.0.0.1:5000:5000"
volumes:
- ./config:/kavita/config
- ./books:/books
Revisa y fija imagen/versión. /kavita/config es el destino de configuración del contenedor; la ruta del host puede cambiar mediante volumen. Contiene SQLite, usuarios y ajustes: respáldalo.
Enlaza a 127.0.0.1. Registra primer administrador mediante túnel privado antes de publicar proxy, evitando que lo cree otro visitante. PUID/PGID son opciones de imagen, no controles universales; usa chown solo tras verificar identidad efectiva. Asia/Shanghai del ejemplo no es requisito de localización.
docker compose up -d
docker compose logs -f
Accede por túnel a http://你的IP:5000 y crea credencial única.
Server Settings → Libraries → Add Library, según versión. Book para texto; Manga/Comic aportan convenciones como dirección de lectura. Selecciona /books, ruta del contenedor.
Separa novelas/cómics si requieren ajustes distintos:
volumes:
- ./config:/kavita/config
- ./novels:/novels
- ./comics:/comics
Espera escaneo, revisa agrupación y vuelve a escanear tras corregir. No presupongas clasificación recursiva sin revisar versión.
Comienza con metadatos EPUB/ComicInfo y edición manual. ComicVine, AniList, MyAnimeList y Google Books del original dependen de integraciones, cuentas o niveles de servicio; no se garantiza que Kavita base consulte todos automáticamente.
- Revisa coincidencias por idioma y edición.
- Para obras chinas, conserva limitaciones de catálogo y ausencia de integración Douban presumida, sin prometer cobertura mundial.
- Edita título, autor, descripción y portada, o acepta nombres útiles cuando falten datos.
Una buena organización sirve aunque no haya enriquecimiento automático.
/books debe contener base metadata.db y directorios asociados. Detén escritores antes de copiar:
rsync -av ~/Calibre\ 书库/ user@server:~/ebooks/library/
Si no tienes biblioteca, créala en Calibre de escritorio, añade un libro y transfiérela. calibredb es una familia de comandos que debes consultar, no una instrucción completa de inicialización por sí sola.
Crea docker-compose.yml:
services:
calibre-web:
image: lscr.io/linuxserver/calibre-web:latest
container_name: calibre-web
restart: unless-stopped
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai
- DOCKER_MODS=linuxserver/mods:universal-calibre
volumes:
- ./config:/config
- ./library:/books
ports:
- "127.0.0.1:8083:8083"
Ajusta PUID/PGID usando id -u/id -g. Si ejecutas ambas aplicaciones, usa proyectos/configuraciones separadas: sus ejemplos ./config no deben compartir estado.
DOCKER_MODS añade herramientas de conversión cuando imagen/mod las soportan. Puede tardar los 2–5 minutos del ejemplo o más. Revisa recursos y dependencias. Para Kindle usa formatos aceptados actualmente: el consejo de enviar MOBI es antiguo; Send to Kindle admite EPUB conforme a sus requisitos.
Instala en privado mediante http://你的IP:8083. Reemplaza admin/admin123 antes de exposición y confirma credenciales de tu versión. En Admin → Basic Configuration, ubicación de base: /books, ruta interna.
No permitas Calibre de escritorio y Calibre-Web escribiendo simultáneamente metadata.db. Usa un escritor y transferencias/backups consistentes.
- HTTPS habilita contexto seguro para ciertas funciones de portapapeles/PWA.
- Protege credenciales en Wi-Fi público y otras redes no confiables.
- Caddy automatiza certificados con DNS y desafíos correctos.
Configura el proxy:
books.example.com {
encode gzip
reverse_proxy 127.0.0.1:5000
}
Para Calibre-Web cambia puerto privado. reverse_proxy gestiona WebSocket en Caddy. El fragmento Nginx va dentro de un proxy completo apropiado:
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Forwarded-Proto $scheme;
client_max_body_size 2000m;
Revisa esquema X-Forwarded-Proto, Base URL y proxies fiables. client_max_body_size cambia límite de carga; 2000m es ejemplo grande, sin ser obligatorio. Ajusta a disco, proxy y aplicación. Consulta Caddy.
- Kavita: endpoint por usuario como
https://books.example.com/api/opds/你的API密钥. - Calibre-Web:
https://books.example.com/opds, según permisos configurados.
URL con API key es credencial. Comprueba OPDS, TLS, autenticación y formatos en KOReader, Moon+ Reader, KyBook o Panels; aplicación/dispositivo/versión no ofrecen siempre lo mismo. Firmware Kindle/Kobo y navegadores de tinta electrónica tienen restricciones propias.
Kavita web/PWA puede ofrecer Add to Home Screen y sincronización en dispositivos compatibles. Calibre-Web:
- Send to Kindle requiere SMTP, remitente aprobado, ajustes del dispositivo y archivos compatibles. App passwords Gmail dependen de cuenta/seguridad; no presupongas contraseña normal.
- Kobo necesita firmware y configuración documentada; verifica progreso además de descarga.
Usa cuenta lectora limitada en lugar de compartir administrador.
Conserva libros, configuración, usuarios, metadatos y progreso. Detén escritores para SQLite consistente:
cd ~/ebooks
docker compose stop
tar czf ~/ebooks-backup-$(date +%F).tar.gz config books
docker compose start
En variante Calibre-Web incluye library: books del ejemplo no basta. Verifica archivo y reinicio ante fallos. Usa rsync para incrementales cuando el destino lo admita y snapshots consistentes de configuración. El almacenamiento de objetos necesita herramienta apropiada; un montaje rclone solo no acredita backup. Comprueba subida, retención independiente y restauración.
Faltan libros: revisa reglas de escaneo/agrupación, chown 1001:1001, volúmenes y tipo de biblioteca; prueba un archivo.
Portadas vacías: revisa metadatos e integración real. Sube manualmente o usa Calibre ebook-meta con backup y otros escritores detenidos; catálogo chino puede ser incompleto.
PDF no abre: móvil/navegador puede agotar RAM; descarga mediante OPDS compatible y lee localmente.
Bucle de login Kavita: revisa X-Forwarded-Proto, esquema externo, Base URL y proxies adicionales.
DB Location is not valid: /books debe incluir metadata.db y biblioteca completa accesible, no EPUB sueltos.
Cargas no aparecen: activa Allow Uploads y permisos de usuario/filesystem; Kavita puede necesitar Rescan. Un montaje solo lectura no permite cargas.
Disco lleno: comprueba du -sh books/*, miniaturas, PDF/cómics y backups. Archiva conscientemente y verifica remoto antes de borrar única copia.
Controla archivos legibles y organización, sin garantizar propiedad incondicional ni quitar DRM. Suscripciones varían por región. Elige según biblioteca Calibre existente y prueba reglas antes de importar toda la colección.