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 Źródłowy plik YAML pomyślnie uruchomił BookLore na ZimaOS i stanowi wartościowy dowód, że stos dwóch usług BookLore + MariaDB działa na tej platformie. Nie należy go jednak dziś kopiować bez zmian. Utrzymywane wdrożenie BookLore korzysta obecnie ze zaktualizowanych nazw obrazów, bardziej przejrzystego DISK_TYPE.
Źródło potwierdza, że sama usługa internetowa BookLore działała na ZimaOS.
Źródło używało BookLore wraz z MariaDB
W pliku YAML utworzono dwie usługi w prywatnej sieci Docker: BookLore na porcie 6060 oraz kontener MariaDB LinuxServer. Dane aplikacji, książki, bookdrop i konfigurację MariaDB zmapowano również do trwałych folderów hosta.
Nie używaj ponownie haseł ze źródła password dla hasła bazy danych BookLore i hasła roota MariaDB. Są to publiczne przykłady, a nie bezpieczne dane uwierzytelniające.
Obecne zalecenia źródła przenoszą sekrety do pliku .env plik i oczekuje, że użytkownicy wybiorą własne wartości.
Obecnie źródło używa przestrzeni nazw obrazów booklore-app
Aktualna dokumentacja BookLore wymienia ghcr.io/booklore-app/booklore:latest jako głównego obrazu i nadal korzysta z usługi opartej na MariaDB 11.4.
Użyj aktualnego przewodnika wdrażania BookLore zamiast zamrażać znaczniki obrazów z lutego 2026 roku.
Oddziel dane, książki, BookDrop i pamięć bazy danych
Obecny BookLore używa trwałych mapowań dla:
-
/app/data— dane aplikacji i pamięć podręczna metadanych; -
/books— zarządzana biblioteka; -
/bookdrop— automatyczny folder importu/drop; - Przechowywanie i konfiguracja MariaDB — stan bazy danych.
Nie ustawiaj domyślnie dużych bibliotek na ZimaOS-HD
W źródle połączono /media/ZimaOS-HD/AppData i /DATA/AppData. Obecnie ZimaOS zaleca przechowywanie danych aplikacji i bibliotek na rzeczywistej puli pamięci masowej zamiast zapełniania dysku systemowego.
Zweryfikuj USER_ID i GROUP_ID zamiast zakładać wartość 1000
W źródle na sztywno ustawiono UID/GID 1000. Może to działać w jednym środowisku, ale obecne kontenery i foldery hosta należy sprawdzić pod kątem rzeczywistego właściciela i uprawnień wybranych ścieżek przechowywania.
Obecny Compose dodaje sprawdzanie stanu BookLore
Nowszy Compose zawiera sprawdzanie stanu HTTP BookLore oraz zależność od stanu bazy danych. Zapewnia to lepsze uruchamianie niż samo uruchomienie obu kontenerów i liczenie na to, że MariaDB będzie na czas gotowa.
Problem mobilny w źródle nie był awarią instalacji ZimaOS
Autor powiedział, że interfejs internetowy był dobry, ale próby mobilnego połączenia zgodnego z Komga zakończyły się niepowodzeniem. Później poinformował, że MoonReader działał przez OPDS.
Należy to zdiagnozować jako problem zgodności protokołu BookLore z klientem, a nie jako dowód na awarię samego serwera BookLore.
OPDS lepiej pasuje do wielu aplikacji do czytania
Obecny BookLore kładzie nacisk na OPDS obok czytania w przeglądarce i zarządzania biblioteką. Jeśli aplikacja mobilna obsługuje OPDS, użyj bieżącego punktu końcowego OPDS BookLore i uwierzytelnionego użytkownika, zamiast wymuszać warstwę zgodności z Komga.
Wykonuj kopie zapasowe zarówno bazy danych, jak i biblioteki
Baza danych zawiera metadane, użytkowników, półki, stan czytania i konfigurację; folder z książkami zawiera rzeczywiste pliki. Plan tworzenia kopii zapasowych powinien chronić oba te elementy.
Obecny BookLore rozróżnia pamięć masową LOCAL i NETWORK
Współczesny BookLore zawiera ustawienie DISK_TYPE ustawienie. LOCAL to zwykły tryb, gdy BookLore może bezpośrednio zarządzać plikami. NETWORK jest przeznaczony dla pamięci masowej w stylu NFS/SMB i wyłącza niektóre operacje reorganizacji plików.
Wybierz tryb na podstawie miejsca zamontowania biblioteki, zamiast kopiować źródłowy plik YAML bez uwzględnienia tego nowszego zachowania.
BookDrop to skrzynka importu, a nie kanoniczna biblioteka
Element /bookdrop folder jest przeznaczony na pliki, które BookLore ma zaimportować. Trzymaj go oddzielnie od /books aby automatyczne importy nie zacierały różnicy między nowo dodanymi plikami a zarządzaną biblioteką.
Wykonuj spójne kopie zapasowe MariaDB
Kopiowanie aktywnego katalogu bazy danych nie zawsze jest równoznaczne ze spójną kopią zapasową bazy danych. W przypadku ważnych bibliotek użyj zrzutu z uwzględnieniem MariaDB albo poprawnie zatrzymaj bazę danych przed wykonaniem kopii na poziomie systemu plików, a następnie sprawdź procedury przywracania.
Przypnij wersje lub przejrzyj je przed włączeniem automatycznych aktualizacji
Źródło używało najnowszy dla BookLore. To wygodne, ale przyszłe pobranie może nieoczekiwanie wprowadzić zmiany w aplikacji lub bazie danych. Jeśli stabilność ma znaczenie, zapoznaj się z informacjami o wydaniach upstreamu i wykonaj kopię zapasową bazy danych przed ponownym utworzeniem stosu z nowszym obrazem.
BookLore na ZimaOS — FAQ
Czy źródłowy plik YAML pomyślnie uruchomił BookLore?
Tak. Autor opublikował działający panel BookLore.
Czy należy ponownie użyć publicznie podanych wartości haseł źródłowych?
Nie. Wygeneruj unikalne dane uwierzytelniające BookLore i MariaDB.
Jaka ścieżka mobilna zadziałała u autora źródła?
Zgłosili, że MoonReader działa przez OPDS, natomiast próby połączenia zgodnego z Komga zakończyły się niepowodzeniem.
