The source YAML successfully launched BookLore on ZimaOS and is valuable as a proof that a two-service BookLore + MariaDB stack works on the platform. But it should not be copied unchanged today. BookLore's maintained deployment now uses updated image names, a clearer .env Il file YAML sorgente ha avviato correttamente BookLore su ZimaOS ed è una prova utile del fatto che uno stack BookLore + MariaDB a due servizi funziona sulla piattaforma. Tuttavia, oggi non dovrebbe essere copiato senza modifiche. La distribuzione mantenuta di BookLore ora utilizza nomi delle immagini aggiornati, un DISK_TYPE.
Il codice sorgente conferma che il servizio web di BookLore funzionava su ZimaOS.
Il codice sorgente utilizzava BookLore più MariaDB
Il file YAML creava due servizi su una rete Docker privata: BookLore sulla porta 6060 e un container MariaDB di LinuxServer. Mappava inoltre i dati dell’applicazione, i libri, BookDrop e la configurazione di MariaDB in cartelle persistenti dell’host.
Non riutilizzare le password del codice sorgente password per la password del database BookLore e la password root di MariaDB. Questi valori sono esempi pubblici e non credenziali sicure.
Le indicazioni upstream attuali spostano i segreti in un .env e si aspetta che gli utenti scelgano i propri valori.
L’upstream attuale utilizza lo spazio dei nomi delle immagini booklore-app
La documentazione attuale di BookLore elenca ghcr.io/booklore-app/booklore:latest come immagine principale e continua a utilizzare un servizio basato su MariaDB 11.4.
Usa la guida aggiornata alla distribuzione di BookLore invece di bloccare i tag delle immagini di febbraio 2026.
Mantieni separati dati, libri, BookDrop e archiviazione del database
L’attuale BookLore utilizza mappature persistenti per:
-
/app/data— dati dell’applicazione e cache dei metadati; -
/books— libreria gestita; -
/bookdrop— cartella per l’importazione automatica e il deposito; - Archiviazione/configurazione di MariaDB — lo stato del database.
Non impostare ZimaOS-HD come destinazione predefinita per le librerie di grandi dimensioni
Il codice sorgente mescolava /media/ZimaOS-HD/AppData e /DATA/AppData. L’attuale ZimaOS consiglia di conservare i dati delle applicazioni e le librerie su un pool di archiviazione reale, invece di riempire l’unità di sistema.
Verifica USER_ID e GROUP_ID invece di presumere 1000
Il codice sorgente impostava il valore UID/GID su 1000. Potrebbe funzionare in un ambiente, ma i container attuali e le cartelle dell’host devono essere verificati rispetto a proprietà e autorizzazioni effettive dei percorsi di archiviazione scelti.
L’attuale Compose aggiunge un controllo dello stato di BookLore
Compose upstream moderno include un controllo dello stato HTTP per BookLore e una dipendenza dallo stato del database. Questo garantisce un avvio più affidabile rispetto al semplice avvio di entrambi i container, sperando che MariaDB sia pronto in tempo.
Il problema mobile della fonte non era un errore di installazione di ZimaOS
L'autore ha detto che l'interfaccia web era valida, ma i tentativi di connessione mobile compatibili con Komga non hanno avuto successo. In seguito ha detto che MoonReader funzionava tramite OPDS.
Questo dovrebbe essere diagnosticato come un problema di compatibilità tra BookLore e il client o il protocollo, non come una prova del malfunzionamento del server BookLore.
OPDS è più adatto per molte app di lettura
Le versioni attuali di BookLore enfatizzano OPDS insieme alla lettura sul web e alla gestione della libreria. Se un'app mobile supporta OPDS, usa l'endpoint OPDS attuale di BookLore e un utente autenticato invece di forzare un livello di compatibilità con Komga.
Esegui il backup sia del database sia della libreria
Il database contiene metadati, utenti, scaffali, stato di lettura e configurazione; la cartella dei libri contiene i file effettivi. Un piano di backup dovrebbe proteggere entrambi.
Le versioni attuali di BookLore distinguono tra spazio di archiviazione LOCAL e NETWORK
Le versioni moderne di BookLore includono un'impostazione DISK_TYPE impostazione. LOCAL è la modalità normale quando BookLore può gestire direttamente i file. NETWORK è destinata allo spazio di archiviazione in stile NFS/SMB e disabilita alcune operazioni di riorganizzazione dei file.
Scegli la modalità in base alla posizione di montaggio della libreria invece di copiare il file YAML della fonte senza considerare questo comportamento più recente.
BookDrop è una casella di importazione, non la libreria canonica
La /bookdrop La cartella è progettata per i file che vuoi far acquisire a BookLore. Tienila separata da /books in modo che le importazioni automatiche non confondano i nuovi file in arrivo con la libreria gestita.
Esegui un backup coerente di MariaDB
Copiare una directory di database attiva non equivale sempre a un backup coerente del database. Per le librerie importanti, usa un dump compatibile con MariaDB oppure arresta correttamente il database prima di eseguire un backup a livello di filesystem, quindi verifica le procedure di ripristino.
Blocca o verifica le versioni prima degli aggiornamenti automatici
La fonte ha utilizzato più recente per BookLore. È comodo, ma un aggiornamento futuro potrebbe introdurre in modo imprevisto modifiche all'applicazione o al database. Se la stabilità è importante, consulta le note di rilascio upstream ed esegui il backup del database prima di ricreare lo stack con un'immagine più recente.
Domande frequenti su BookLore su ZimaOS
Il file YAML della fonte ha avviato BookLore correttamente?
Sì. L'autore ha pubblicato una dashboard di BookLore funzionante.
È opportuno riutilizzare i valori delle password della fonte pubblica?
No. Genera credenziali univoche per BookLore e MariaDB.
Quale metodo mobile ha funzionato per l'autore della fonte?
Hanno riferito che MoonReader funzionava tramite OPDS, mentre i tentativi compatibili con Komga non hanno avuto successo.
