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 شغّل ملف YAML المصدر BookLore بنجاح على ZimaOS، وهو دليل عملي على أن حزمة BookLore + MariaDB المكوّنة من خدمتين تعمل على المنصة. لكن لا ينبغي نسخه كما هو اليوم. إذ يستخدم نشر BookLore المُدار حاليًا أسماء صور محدثة و DISK_TYPE.
يؤكد المصدر أن خدمة الويب نفسها الخاصة بـ BookLore كانت تعمل على ZimaOS.
استخدم المصدر BookLore مع MariaDB
أنشأ ملف YAML خدمتين على شبكة Docker خاصة: BookLore على المنفذ 6060 وحاوية MariaDB من LinuxServer. كما عيّن بيانات التطبيق والكتب وbookdrop وإعدادات MariaDB إلى مجلدات مضيفة دائمة.
لا تُعد استخدام كلمات المرور الموجودة في المصدر كلمة المرور لكلمة مرور قاعدة بيانات BookLore وكلمة مرور جذر MariaDB. هذه القيم أمثلة عامة وليست بيانات اعتماد آمنة.
تنقل إرشادات المنبع الحالية الأسرار إلى ملف .env ويتوقع من المستخدمين اختيار قيمهم الخاصة.
يستخدم المنبع الحالي مساحة أسماء الصور booklore-app
تسرد وثائق BookLore الحالية ghcr.io/booklore-app/booklore:latest بوصفه الصورة الرئيسية، ويواصل استخدام خدمة مبنية على MariaDB 11.4.
استخدم دليل نشر BookLore الحالي بدلًا من تثبيت وسوم الصور الخاصة بشهر فبراير 2026.
افصل بين تخزين البيانات والكتب وBookDrop وقاعدة البيانات
يستخدم BookLore حاليًا تعيينات مستمرة لـ:
-
/app/data— بيانات التطبيق وذاكرة التخزين المؤقت للبيانات الوصفية؛ -
/books— المكتبة المُدارة؛ -
/bookdrop— مجلد الاستيراد/الإسقاط التلقائي؛ - تخزين/إعداد MariaDB — حالة قاعدة البيانات.
لا تجعل ZimaOS-HD الوجهة الافتراضية للمكتبات الكبيرة
خلط المصدر بين /media/ZimaOS-HD/AppData و /DATA/AppData. توصي ZimaOS حاليًا بإبقاء بيانات التطبيقات والمكتبات على مجموعة تخزين فعلية بدلًا من ملء محرك النظام.
تحقق من USER_ID وGROUP_ID بدلًا من افتراض القيمة 1000
كان المصدر يثبت UID/GID على القيمة 1000. قد ينجح ذلك في بيئة معينة، لكن ينبغي فحص الحاويات الحالية والمجلدات المضيفة وفق الملكية والأذونات الفعلية لمسارات التخزين المحددة.
يضيف Compose الحالي فحصًا صحيًا لـ BookLore
يتضمن Compose الحديث من المنبع فحصًا صحيًا عبر HTTP لـ BookLore واعتمادية صحية لقاعدة البيانات. وهذا يوفر سلوكًا أفضل عند بدء التشغيل من مجرد تشغيل الحاويتين والأمل في أن تكون MariaDB جاهزة في الوقت المناسب.
لم تكن مشكلة الهاتف المحمول في المصدر فشلًا في تثبيت ZimaOS
قال المؤلف إن واجهة الويب كانت جيدة، لكن محاولات الاتصال عبر الهاتف المحمول المتوافقة مع Komga لم تنجح. ثم قال لاحقًا إن MoonReader عمل عبر OPDS.
ينبغي تشخيص ذلك على أنه توافق بين BookLore وبروتوكول العميل، لا باعتباره دليلًا على فشل خادم BookLore نفسه.
OPDS أنسب للعديد من تطبيقات القراءة
يركز BookLore الحالي على OPDS إلى جانب القراءة عبر الويب وإدارة المكتبة. إذا كان تطبيق الهاتف المحمول يدعم OPDS، فاستخدم نقطة نهاية OPDS الحالية لـ BookLore ومستخدمًا موثّقًا بدلًا من فرض طبقة توافق مع Komga.
أنشئ نسخة احتياطية لكل من قاعدة البيانات والمكتبة
تحتوي قاعدة البيانات على البيانات الوصفية والمستخدمين والأرفف وحالة القراءة والإعدادات؛ بينما يحتوي مجلد الكتب على الملفات الفعلية. ينبغي أن تحمي خطة النسخ الاحتياطي كليهما.
يميز BookLore الحالي بين تخزيني LOCAL وNETWORK
يتضمن BookLore الحديث DISK_TYPE الإعداد. يُعد LOCAL الوضع المعتاد عندما يستطيع BookLore إدارة الملفات مباشرةً. أما NETWORK فهو مخصص للتخزين بأسلوب NFS/SMB ويعطّل بعض عمليات إعادة تنظيم الملفات.
اختر الوضع استنادًا إلى مكان تثبيت المكتبة بدلًا من نسخ ملف YAML المصدر دون هذا السلوك الأحدث.
BookDrop هو صندوق وارد للاستيراد، وليس المكتبة الأساسية
إن /bookdrop مجلدًا مخصصًا للملفات التي تريد من BookLore استيعابها. أبقه منفصلًا عن /books حتى لا تخلط عمليات الاستيراد التلقائية بين الملفات الواردة حديثًا والمكتبة المُدارة.
أنشئ نسخة احتياطية متسقة لـ MariaDB
لا يعادل نسخ مجلد قاعدة بيانات قيد التشغيل دائمًا نسخة احتياطية متسقة لقاعدة البيانات. بالنسبة إلى المكتبات المهمة، استخدم تفريغًا مدركًا لـ MariaDB أو أوقف قاعدة البيانات بشكل سليم قبل إجراء نسخة احتياطية على مستوى نظام الملفات، ثم تحقّق من إجراءات الاستعادة.
ثبّت الإصدارات أو راجعها قبل التحديثات التلقائية
استخدم المصدر الأحدث لـ BookLore. وهذا مريح، لكن قد يؤدي سحب مستقبلي إلى إدخال تغييرات غير متوقعة على التطبيق أو قاعدة البيانات. إذا كانت الاستقرار مهمًا، فراجع ملاحظات إصدارات المصدر الأساسي وأنشئ نسخة احتياطية من قاعدة البيانات قبل إعادة إنشاء الحزمة باستخدام صورة أحدث.
الأسئلة الشائعة حول BookLore على ZimaOS
هل نجح ملف YAML المصدر في تشغيل BookLore؟
نعم. نشر المؤلف لوحة تحكم BookLore عاملة.
هل ينبغي إعادة استخدام قيم كلمات مرور المصدر العامة؟
لا. أنشئ بيانات اعتماد فريدة لـ BookLore وMariaDB.
ما المسار عبر الهاتف المحمول الذي نجح مع مؤلف المصدر؟
أفادوا بأن MoonReader عمل عبر OPDS، بينما لم تنجح محاولاتهم المتوافقة مع Komga.
