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 O YAML da origem iniciou com êxito o BookLore no ZimaOS e é uma prova útil de que uma stack BookLore + MariaDB com dois serviços funciona na plataforma. No entanto, não deve ser copiado sem alterações atualmente. A implementação mantida do BookLore utiliza agora nomes de imagens atualizados, um DISK_TYPE.
A origem confirma que o próprio serviço Web do BookLore estava a funcionar no ZimaOS.
A origem utilizava BookLore e MariaDB
O YAML publicado criou dois serviços numa rede Docker privada: o BookLore na porta 6060 e um contentor MariaDB da LinuxServer. Também mapeou os dados da aplicação, os livros, o bookdrop e a configuração do MariaDB para pastas persistentes no anfitrião.
Não reutilize as palavras-passe da origem password para a palavra-passe da base de dados do BookLore e a palavra-passe de root do MariaDB. Esses valores são exemplos públicos, não credenciais seguras.
As orientações atuais do upstream transferem os segredos para um .env e espera que os utilizadores escolham os seus próprios valores.
O upstream atual utiliza o espaço de nomes de imagens booklore-app
A documentação atual do BookLore indica ghcr.io/booklore-app/booklore:latest como imagem principal e continua a utilizar um serviço baseado no MariaDB 11.4.
Utilize o guia de implementação atual do BookLore em vez de fixar as etiquetas de imagem de fevereiro de 2026.
Mantenha separados o armazenamento de dados, livros, BookDrop e base de dados
O BookLore atual utiliza mapeamentos persistentes para:
-
/app/data— dados da aplicação e cache de metadados; -
/books— biblioteca gerida; -
/bookdrop— pasta de importação/eliminação automática; - Armazenamento/configuração do MariaDB — o estado da base de dados.
Não predefina bibliotecas grandes no ZimaOS-HD
A origem misturava /media/ZimaOS-HD/AppData e /DATA/AppData. Atualmente, o ZimaOS recomenda manter os dados das aplicações e as bibliotecas num conjunto de armazenamento real, em vez de encher a unidade do sistema.
Verifique USER_ID e GROUP_ID em vez de assumir 1000
A origem fixava o UID/GID como 1000. Isso pode funcionar num ambiente, mas os contentores atuais e as pastas do anfitrião devem ser verificados em função do proprietário e das permissões efetivas dos caminhos de armazenamento escolhidos.
O Compose atual adiciona uma verificação de estado do BookLore
O Compose upstream moderno inclui uma verificação de estado HTTP para o BookLore e uma dependência de estado da base de dados. Isso proporciona um arranque mais fiável do que simplesmente iniciar ambos os contentores e esperar que o MariaDB esteja pronto a tempo.
O problema móvel da fonte não foi uma falha de instalação no ZimaOS
O autor afirmou que a interface Web era boa, mas que as tentativas de ligação móvel compatíveis com o Komga não foram bem-sucedidas. Mais tarde, afirmou que o MoonReader funcionava através de OPDS.
Isto deve ser diagnosticado como uma incompatibilidade entre o BookLore e o protocolo do cliente, e não como prova de que o próprio servidor BookLore falhou.
O OPDS é mais adequado para muitas aplicações de leitura
As versões atuais do BookLore dão destaque ao OPDS, além da leitura na Web e da gestão da biblioteca. Se uma aplicação móvel suportar OPDS, utilize o endpoint OPDS atual do BookLore e um utilizador autenticado, em vez de forçar uma camada de compatibilidade com o Komga.
Faça cópias de segurança da base de dados e da biblioteca
A base de dados contém metadados, utilizadores, estantes, estado de leitura e configuração; a pasta de livros contém os ficheiros propriamente ditos. Um plano de cópias de segurança deve proteger ambos.
As versões atuais do BookLore distinguem o armazenamento LOCAL do NETWORK
As versões modernas do BookLore incluem uma DISK_TYPE definição. LOCAL é o modo normal quando o BookLore pode gerir os ficheiros diretamente. NETWORK destina-se a armazenamento do tipo NFS/SMB e desativa algumas operações de reorganização de ficheiros.
Escolha o modo com base no local onde a biblioteca está montada, em vez de copiar o YAML da fonte sem considerar este comportamento mais recente.
O BookDrop é uma caixa de entrada para importações, não a biblioteca canónica
A /bookdrop A pasta destina-se aos ficheiros que pretende que o BookLore importe. Mantenha-a separada de /books para que as importações automatizadas não confundam a distinção entre ficheiros novos recebidos e a biblioteca gerida.
Faça cópias de segurança consistentes do MariaDB
Copiar um diretório de uma base de dados em funcionamento nem sempre equivale a uma cópia de segurança consistente da base de dados. Para bibliotecas importantes, utilize uma exportação compatível com o MariaDB ou pare a base de dados corretamente antes de fazer uma cópia de segurança ao nível do sistema de ficheiros e, em seguida, verifique os procedimentos de restauro.
Fixe ou reveja as versões antes das atualizações automáticas
A fonte utilizou mais recente para o BookLore. Isto é conveniente, mas uma atualização futura pode introduzir inesperadamente alterações na aplicação ou na base de dados. Se a estabilidade for importante, consulte as notas de lançamento a montante e faça uma cópia de segurança da base de dados antes de recriar a stack com uma imagem mais recente.
Perguntas frequentes sobre o BookLore no ZimaOS
O YAML da fonte iniciou o BookLore com sucesso?
Sim. O autor publicou um painel do BookLore funcional.
Devem ser reutilizados os valores públicos das palavras-passe da fonte?
Não. Gere credenciais exclusivas para o BookLore e o MariaDB.
Que método móvel funcionou para o autor da fonte?
Relataram que o MoonReader funcionava através de OPDS, enquanto as tentativas compatíveis com o Komga não foram bem-sucedidas.
