دليل OPDS عملي

استضف مكتبتك وافتحها في Lectern

تبقى الملفات على عتادك، وتتصفح الرف من Android وتنزّل الكتب مباشرة إلى Lectern. يناسب Calibre-Web الكتب الإلكترونية، بينما يناسب Storyteller الكتب المتزامنة مع الصوت.

الجواب المختصر

اختر Calibre-Web لرف خاص من الكتب الإلكترونية. اختر Storyteller لدمج كتاب إلكتروني وكتاب صوتي بلا DRM في EPUB 3 متزامن. يقدّم كلاهما فهرس OPDS يستطيع Lectern تصفحه.

اختر الخادم المناسب

السؤالCalibre-WebStoryteller
الأفضل لـإدارة الكتب وتنزيلهاالكتب الإلكترونية والصوتية والمتزامنة
المكتبةCalibre مع metadata.dbمخزن خاص به
في Lecternإصدارات EPUBEPUB أو EPUB متزامن
الحملخفيفالمحاذاة قد تتطلب موارد كبيرة

ابدأ بـ Calibre-Web للشبكة المنزلية. اقرأ المقارنة الكاملة إن كان هدفك القراءة والاستماع معًا.

قبل البدء

  • حاسوب أو NAS أو خادم منزلي يعمل وقت التصفح.
  • Docker Compose ومجلدات بيانات دائمة.
  • ملفات EPUB بلا DRM. يخفي Lectern العناصر الصوتية فقط.
  • عنوان IP المحلي مثل 192.168.1.50.

ابدأ على شبكة المنزل. للوصول من الخارج استخدم VPN خاصًا أو وكيلاً عكسيًا مع HTTPS مضبوطًا جيدًا. لا تكشف تسجيل دخول غير مشفر.

المسار أ: Calibre-Web

استبدل مسارات /path/to/... واضبط PUID وPGID والمنطقة الزمنية. يجب أن يتضمن مجلد الكتب مكتبة Calibre وملف metadata.db.

services:
        calibre-web:
          image: lscr.io/linuxserver/calibre-web:latest
          container_name: calibre-web
          environment:
            - PUID=1000
            - PGID=1000
            - TZ=Etc/UTC
          volumes:
            - /path/to/calibre-web/config:/config
            - /path/to/calibre/library:/books
          ports:
            - 8083:8083
          restart: unless-stopped
  1. احفظه باسم compose.yaml وشغّل docker compose up -d.
  2. افتح http://SERVER-IP:8083 وحدد /books.
  3. ادخل باسم admin وكلمة admin123 ثم غيّرها فورًا.
  4. أضف الكتب عبر Calibre. للاستيراد التلقائي استخدم Calibre-Web Automated.
  5. اختبر http://SERVER-IP:8083/opds.

راجع مستودع LinuxServer الرسمي للإعداد الحالي.

المسار ب: Storyteller

أنشئ مفتاحًا عبر openssl rand -base64 32 واحفظ قيمته فقط في STORYTELLER_SECRET_KEY.txt.

services:
        web:
          image: registry.gitlab.com/storyteller-platform/storyteller:latest
          volumes:
            - /path/to/storyteller/data:/data:rw
          environment:
            - STORYTELLER_SECRET_KEY_FILE=/run/secrets/secret_key
          ports:
            - "8001:8001"
          secrets:
            - secret_key
          restart: unless-stopped
      secrets:
        secret_key:
          file: ./STORYTELLER_SECRET_KEY.txt
  1. شغّل Compose وافتح http://SERVER-IP:8001.
  2. أنشئ حساب المدير وأضف كتابًا إلكترونيًا أو صوتيًا أو كليهما.
  3. ابدأ المحاذاة عند وجود الملفين وانتظر اكتمالها.
  4. موجز OPDS مفعّل افتراضيًا؛ فيكفي إدخال بيانات الدخول. إن كان معطّلًا فأعد تفعيله من الإعدادات ثم OPDS. ينتهي العنوان بـ /opds.
  5. استخدم اسم مستخدم Storyteller وكلمة المرور المعتادين في Lectern.

راجع دليل الاستضافة الرسمي وتوثيق OPDS.

الاتصال من Lectern

  1. افتح المكتبة. اضغط علامة الجمع ثم كتب مجانية وذاتية الاستضافة.
  2. اختر Storyteller أو Calibre-Web.
  3. أدخل العنوان. مثل http://192.168.1.50:8083 أو نطاق HTTPS.
  4. أضف اسم المستخدم وكلمة المرور. يبقيان مشفرين على الجهاز.
  5. اتصل. نزّل EPUB إلى مكتبة Lectern العادية.
مكتبة Lectern فارغة مع زر الكتب المجانية وذاتية الاستضافة
في المكتبة الفارغة يظهر مسار الاستضافة الذاتية مباشرة دون عناصر دائمة إضافية.
نافذة اتصال Storyteller في Lectern مع العنوان واسم المستخدم وكلمة المرور
اختر الخادم وأدخل العنوان والبيانات ثم اتصل.

إن استخدم الوكيل العكسي مسارًا فرعيًا فأدخل رابط الموجز كاملًا. للخوادم الأخرى اختر موجز OPDS آخر.

حل المشكلات الشائعة

تعذر الوصول

يشير localhost إلى الهاتف نفسه. استخدم عنوان LAN وتحقق من الشبكة والجدار الناري.

طلب تسجيل الدخول مجددًا

اختبر البيانات نفسها في الويب. قد يحتاج إعداد OAuth فقط إلى مستخدم محلي لـ OPDS.

الفهرس فارغ

يجب أن يعرض الموجز EPUB. يخفي Lectern العناصر الصوتية فقط.

فشل HTTPS

استخدم شهادة يثق بها Android مع سلسلة الشهادات كاملة.

أسئلة عن OPDS المستضاف ذاتيًا

هل أدخل عنوان الخادم أم رابط OPDS كاملًا؟

يكفي عنوان الخادم لـ Storyteller وCalibre-Web. استخدم الرابط الكامل للمسارات الفرعية أو الخوادم الأخرى.

هل يعمل عبر الإنترنت؟

نعم، عبر HTTPS موثوق أو VPN خاص. لا تكشف تسجيل دخول غير مشفر.

هل يشغّل Lectern كتب Storyteller الصوتية؟

لا. يستورد EPUB وEPUB المتزامن ويخفي العناصر الصوتية فقط.

هل تصل بيانات الدخول إلى مطور Lectern؟

لا. تبقى مشفرة على جهاز Android وتُرسل إلى خادمك فقط.

كتبك على خادمك

اتصل مرة، ونزّل ما تريد، ثم اقرأ واستمع بلا اتصال.

احصل عليه منGoogle Play