El YAML de la fuente inició BookLore correctamente en ZimaOS y demuestra que una pila de dos servicios, BookLore + MariaDB, funciona en la plataforma. Sin embargo, hoy no debería copiarse sin cambios. La implementación mantenida de BookLore utiliza ahora nombres de imagen actualizados, una estructura más clara .env modelo, comprobaciones de estado y un comportamiento de almacenamiento explícito, como DISK_TYPE.
La fuente utilizaba BookLore junto con MariaDB
El YAML creó dos servicios en una red Docker privada: BookLore en el puerto 6060 y un contenedor de MariaDB de LinuxServer. También asignó los datos de la aplicación, los libros, BookDrop y la configuración de MariaDB a carpetas persistentes del host.
El YAML publicado utilizaba
No reutilices las contraseñas de la fuente contraseña para la contraseña de la base de datos de BookLore y la contraseña raíz de MariaDB. Esos valores son ejemplos públicos, no credenciales seguras.
Las instrucciones actuales de upstream trasladan los secretos a un .env y espera que los usuarios elijan sus propios valores.
La versión upstream actual utiliza el espacio de nombres de imagen booklore-app
La documentación actual de BookLore incluye ghcr.io/booklore-app/booklore:latest como imagen principal y sigue utilizando un servicio basado en MariaDB 11.4.
Usa la guía de implementación actual de BookLore en lugar de fijar las etiquetas de imagen de febrero de 2026.
Mantén separados los datos, los libros, BookDrop y el almacenamiento de la base de datos
El BookLore actual utiliza asignaciones persistentes para:
-
/app/data— datos de la aplicación y caché de metadatos; -
/books— biblioteca administrada; -
/bookdrop— carpeta de importación automática; - Almacenamiento y configuración de MariaDB: el estado de la base de datos.
No establezcas bibliotecas grandes de forma predeterminada en ZimaOS-HD
La fuente mezclaba /media/ZimaOS-HD/AppData y /DATA/AppData. El ZimaOS actual recomienda mantener los datos de las aplicaciones y las bibliotecas en un grupo de almacenamiento real, en lugar de llenar la unidad del sistema.
Verifica USER_ID y GROUP_ID en lugar de asumir 1000
El código fuente fijaba UID/GID 1000. Puede funcionar en un entorno, pero los contenedores actuales y las carpetas del host deben comprobarse con respecto a la propiedad y los permisos reales de las rutas de almacenamiento elegidas.
El Compose actual añade una comprobación de estado para BookLore
Compose moderno incorpora una comprobación de estado HTTP para BookLore y una dependencia de estado de la base de datos. Esto ofrece un inicio más fiable que limitarse a iniciar ambos contenedores y esperar que MariaDB esté lista a tiempo.
El problema móvil de la fuente no fue un fallo de instalación de ZimaOS
El autor dijo que la interfaz web era buena, pero que los intentos de conexión móvil compatibles con Komga no tuvieron éxito. Más tarde dijo que MoonReader funcionaba mediante OPDS.
Eso debe diagnosticarse como un problema de compatibilidad entre BookLore y el protocolo del cliente, no como una prueba de que el servidor de BookLore haya fallado.
OPDS se adapta mejor a muchas aplicaciones de lectura
Las versiones actuales de BookLore destacan OPDS junto con la lectura web y la administración de la biblioteca. Si una aplicación móvil admite OPDS, utiliza el endpoint OPDS actual de BookLore y un usuario autenticado en lugar de forzar una capa de compatibilidad con Komga.
Haz copias de seguridad tanto de la base de datos como de la biblioteca
La base de datos contiene metadatos, usuarios, estanterías, estado de lectura y configuración; la carpeta de libros contiene los archivos reales. Un plan de copias de seguridad debe proteger ambos.
Las versiones actuales de BookLore distinguen entre el almacenamiento LOCAL y NETWORK
Las versiones modernas de BookLore incluyen una DISK_TYPE configuración. LOCAL es el modo normal cuando BookLore puede administrar los archivos directamente. NETWORK está pensado para almacenamiento de tipo NFS/SMB y desactiva algunas operaciones de reorganización de archivos.
Elige el modo según dónde esté montada la biblioteca, en lugar de copiar el YAML de la fuente sin tener en cuenta este comportamiento más reciente.
BookDrop es una bandeja de entrada para importaciones, no la biblioteca canónica
La /bookdrop La carpeta está diseñada para los archivos que quieres que BookLore incorpore. Mantenla separada de /books para que las importaciones automáticas no difuminen la distinción entre los archivos entrantes nuevos y la biblioteca administrada.
Haz copias de seguridad coherentes de MariaDB
Copiar un directorio de base de datos activo no siempre equivale a una copia de seguridad coherente de la base de datos. Para bibliotecas importantes, utiliza un volcado compatible con MariaDB o detén correctamente la base de datos antes de realizar una copia de seguridad a nivel del sistema de archivos; después, verifica los procedimientos de restauración.
Fijar o revisar las versiones antes de las actualizaciones automáticas
La fuente utilizó más reciente para BookLore. Esto resulta práctico, pero una actualización futura puede introducir cambios inesperados en la aplicación o la base de datos. Si la estabilidad es importante, revisa las notas de lanzamiento de la fuente y haz una copia de seguridad de la base de datos antes de recrear la pila con una imagen más reciente.
Preguntas frecuentes sobre BookLore en ZimaOS
¿El YAML de la fuente inició BookLore correctamente?
Sí. El autor publicó un panel de BookLore funcional.
¿Deben reutilizarse los valores de contraseña de la fuente pública?
No. Genera credenciales únicas para BookLore y MariaDB.
¿Qué método móvil funcionó para el autor de la fuente?
Informaron que MoonReader funcionaba mediante OPDS, mientras que sus intentos compatibles con Komga no tuvieron éxito.
