📚 تثبيت Stump — خادم قراءة وبث المانجا والقصص المصورة والكتب الرقمية على Docker
نشر خادم Stump على Ubuntu باستخدام Docker — خادم الميديا فائق السرعة والمبني بلغة Rust لبث وقراءة القصص المصورة (Comics) والمانجا وخلاصات OPDS-PSE للقراءة على الهواتف والأجهزة اللوحية على المنفذ 10801.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/stump/stump-ubuntu.sh
chmod +x stump-ubuntu.sh
./stump-ubuntu.sh
خطوات التنفيذ
1 تحميل سكريبت التثبيت من مستودع GitHub إلى سيرفر Ubuntu باستخدام wget أو curl.
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/stump/stump-ubuntu.sh
2 منح صلاحيات التنفيذ للسكريبت باستخدام الأمر `chmod +x stump-ubuntu.sh`.
chmod +x stump-ubuntu.sh
3 تشغيل المثبت لتهيئة Docker ومسارات التخزين الدائمة (`./config` و`./data`) وتشغيل حاوية Stump على المنفذ 10801.
./stump-ubuntu.sh
4 فتح الرابط http://ip-سيرفرك:10801، وإنشاء حساب المشرف، وربط مجلدات القصص والمانجا، وبدء البث لتطبيقات الهواتف.
http://your-server-ip:10801
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 10801 | Stump web interface and OPDS catalogue |
نظرة عامة
تعد Stump منصة خادم وسائط عصرية وفائقة السرعة ومفتوحة المصدر صُممت خصيصاً للقصص المصورة (Comic Books)، ومجلدات المانجا، والكتب الرقمية. تم بناؤها بلغة Rust مع واجهة أمامية جذابة بـ React، وتعمل عبر المنفذ 10801. تقوم المنصة بفهرسة وأرشفة ملفات CBZ وCBR وPDF وEPUB في أجزاء من الثانية، وتوفر قارئ ويب تفاعلي يدعم التمرير المستمر والصفحات المزدوجة ومزامنة تقدم القراءة، مع دعم بروتوكول OPDS-PSE لبث الصفحات عند الطلب لتطبيقات القراءة الشهيرة على الهواتف (مثل Panels وChunky وPaperback).
لماذا تستخدمه
تعاني خوادم القصص المصورة القديمة مثل Ubooquity من البطء واستهلاك الذاكرة المرتفع لأنها مبنية بـ Java أو Python وتملك واجهات قديمة. يستفيد Stump من كفاءة لغة Rust وسرعة معالجة الملفات: حيث يفهرس مئات الجيجابايت من المجلدات في ثوانٍ معدودة، ويستهلك أقل من 50 ميجابايت من الذاكرة، ويمنحك تجربة قراءة سلسة وعصرية تشبه نتفليكس على الحواسيب والهواتف والأجهزة اللوحية.
متى تحتاجه
- تمتلك مكتبة رقمية ضخمة من القصص المصورة (CBZ وCBR) والمانجا وتريد بثها وقراءتها عن بُعد
- تبحث عن خادم وسائط رقمية فائق السرعة وخفيف جداً مبني بـ Rust يستهلك أقل قدر من موارد السيرفر
- تريد خلاصة OPDS / OPDS-PSE لبث صفحات القصص مباشرة داخل تطبيقات القراءة على الآيباد والهواتف (مثل Panels)
- تحتاج إلى قارئ ويب يدعم وضع الويبتون (Webtoon) بالتمرير الرأسي المستمر ووضع قراءة المانجا من اليمين لليسار (RTL)
- تريد دعماً للمستخدمين المتعددين مع تتبع تقدم القراءة لكل مستخدم وصلاحيات وصول مخصصة للأطفال
من يحتاجه
- عشاق ومتابعو القصص المصورة والمانجا والروايات المصورة الباحثون عن سيرفر بث واستضافة ذاتية مخصص
- أصحاب السيرفرات المنزلية لتشغيل منظومة ترفيه متكاملة (Plex للأفلام وNavidrome للصوتيات وStump للمانجا)
- مستخدمو أجهزة الآيباد والتابلت للربط عبر OPDS مع أفضل تطبيقات قراءة القصص المصورة
- مديرو الخوادم لإتاحة مكتبة رقمية عائلية مشتركة مع التحكم في تصنيفات المحتوى المسموحة لكل فرد
- الموثقون وهواة الأرشفة لتصنيف وفهرسة آلاف الكتب والمنشورات والمجلات المصورة القديمة
حالات الاستخدام الشائعة
- بث سلسلة مانجا تتكون من 500 فصل لجهاز iPad عبر تطبيق Panels باستخدام خلاصة OPDS-PSE
- قراءة قصص الويبتون الكورية من متصفح الهاتف عبر وضع التمرير الرأسي السلس في Stump
- استخراج البيانات الوصفية وأسماء المؤلفين وأغلفة الأعداد تلقائياً من ملفات ComicInfo.xml المدمجة داخل أرشيف CBZ
- إنشاء حسابات مقيدة للأطفال تعرض فقط المجلدات والقصص المصورة المناسبة لأعمارهم
- مزامنة صفحة القراءة الحالية تلقائياً بين متصفح الكمبيوتر والتابلت دون فقدان مكان توقفك
الميزات الرئيسية
- خلفية برمجية فائقة السرعة بـ Rust: استخراج لحظي لصفحات الأرشيف وتوليد سريع للصور المصغرة وفهرسة لحظية
- قارئ ويب تفاعلي متطور: دعم وضع الصفحة الواحدة أو المزدوجة، والتمرير الرأسي للويبتون، وقراءة المانجا من اليمين لليسار
- بروتوكول OPDS وOPDS-PSE: توافق كامل مع تطبيقات القراءة الخارجية لبث الصفحات عند الطلب
- دعم متعدد الصيغ: قراءة وفهرسة ملفات CBZ وCBR (RAR) وPDF وEPUB بكفاءة
- قراءة البيانات الوصفية الذكية: استخراج بيانات `ComicInfo.xml` وأسماء السلاسل والرسامين وسنوات النشر
- مستخدمون متعددون وصلاحيات دقيقة: تتبع تقدم القراءة الفردي والإشارات المرجعية وتقييد المكتبات
- واجهة REST API وبث عبر WebSockets: استدعاء التحديثات وتتبع نسبة تقدم فهرسة المجلدات فورياً
- معمارية Docker Compose مع ربط مجلد `./config` للإعدادات ومجلد `./data` لملفات المانجا والقصص
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:10801 لبدء معالج الإعداد
- أنشئ حساب المشرف الأساسي باسم مستخدم وكلمة مرور آمنة
- انتقل إلى 'Libraries' ← 'Create Library'، وسمِّ مكتبتك (مثل 'Manga' أو 'Comics')، وحدد المسار إلى `/data`
- اضغط 'Scan Library' ليقوم Stump بفهرسة القصص وتوليد أغلفة الأعداد فورياً
- في تطبيق القراءة بالهاتف (مثل Panels أو Paperback)، أضف رابط الـ OPDS: `http://ip-سيرفرك:10801/opds/v1.2/catalog`
- ضع Stump خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- أعد سكريبت نسخ احتياطي دوري لمجلد الإعدادات `./config`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: غيّر بيانات المشرف فور التثبيت واشترط تسجيل الدخول للوصول للمكتبات
- استخدم تشفير HTTPS دائماً عبر وكيل عكسي لتأمين جلسات القراءة والوصول عن بُعد
- لا تكشف المنفذ 10801 للإنترنت العام مباشرة دون حماية الوكيل العكسي
- اربط مجلدات المانجا والقصص (`./data`) بصلاحية القراءة فقط (`:ro`) في Docker لمنع مسح الملفات بالخطأ
- احمِ مجلد الإعدادات `./config` الذي يحتوي على قاعدة بيانات SQLite بصلاحيات نظام مناسبة بالسيرفر
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وميزات القارئ الجديدة
المنافذ وإعدادات جدار الحماية
يقدم Stump واجهة الويب وقارئ المانجا وخلاصات OPDS عبر منفذ TCP 10801. يجب السماح بالمنفذ 10801 في جدار الحماية للشبكة المحلية (`ufw allow 10801/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 وأبقِ المنفذ 10801 مغلقاً خارجياً.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./config` احتياطياً، والذي يحتوي على ملف `stump.db` (المكتبات، والمستخدمين، وتقدم القراءة، والبيانات الوصفية)
- احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على المنافذ ومسارات التخزين
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد الإعدادات بحاوية تجريبية للتأكد من استرجاع تقدم القراءة بنجاح
الأخطاء الشائعة
- ربط مجلدات القصص بصلاحيات مستخدم خاطئة مما يمنع Stump من قراءة ملفات الأرشيف
- التشغيل عبر بروتوكول HTTP غير المشفر في الإنتاج مما يسبب رفض تطبيقات OPDS بالهواتف للاتصال
- عدم ربط مجلد التخزين الدائم `./config`، مما يسبب فقدان تقدم القراءة عند تحديث الحاوية
- وضع ملفات أرشيف CBR تالفة أو محمية بكلمة مرور بدون مكتبات فك ضغط متوافقة
- ترك تسجيل المستخدمين الجدد مفتوحاً للعامة بدون موافقة المشرف
استكشاف الأخطاء وإصلاحها
- الفحص لا يظهر أي كتب — تأكد من صحة مسار ربط المجلدات إلى `/data` في `docker-compose.yml` وصلاحيات الملفات
- فشل اتصال الـ OPDS على الآيباد — تأكد من كتابة مسار الفهرس كاملاً: `/opds/v1.2/catalog` مع رابط HTTPS صحيح
- ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs stump -f`
- أغلفة القصص لا تظهر — أعد تشغيل فحص المكتبة أو امسح كاش المتصفح
- فشل فتح ملفات CBR — تأكد من أن ملفات CBR غير مشفرة ومضغوطة بصيغة متوافقة مع unrar
البدائل
خادم Komga الشهير المبني بـ Java. خادم Kavita المبني بـ .NET. خادم Ubooquity الكلاسيكي. خادم Calibre-Web المخصص للكتب الإلكترونية. برنامج YACReaderLibrary للربط بالحواسيب.
متى لا تستخدمه
تجنب استخدام Stump إذا كنت تدير مكتبة كتب نصية بحتة (EPUB وMOBI) وتريد تحويل الصيغ وتعديل البيانات الوصفية وإرسال الكتب لأجهزة كيندل (Kindle) عبر البريد (حيث صُممت Calibre-Web خصيصاً لأجهزة كيندل). وإذا كنت تريد فقط مشاركة الملفات عبر مجلد عادي دون قارئ قصص مخصص، فإن Nextcloud أو Seafile أسهل.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي صيغ الملفات المدعومة في Stump؟
يدعم Stump أصلياً ملفات القصص المصورة الرقمية (CBZ وCBR) ومستندات PDF والكتب الإلكترونية بصيغة EPUB مع استخراج البيانات الوصفية تلقائياً.
هل يمكنني قراءة القصص على جهاز الآيباد أو هواتف أندرويد؟
نعم! يمكنك القراءة مباشرة عبر متصفحات الهواتف باستخدام قارئ الويب المتجاوب، أو ربط تطبيقات القراءة الشهيرة (مثل Panels وPaperback وChunky) عبر خلاصات OPDS-PSE.
ما هي ميزة بروتوكول OPDS-PSE؟
يتيح بروتوكول OPDS-PSE (Page Streaming Extension) لتطبيقات الهواتف بث وعرض صفحات القصص المصورة صفحة بصفحة عند الطلب أثناء القراءة، دون إجبارك على تنزيل ملف القصة بالكامل (الذي قد يتجاوز 100 ميجابايت) على هاتفك.
كيف يقرأ Stump البيانات الوصفية للقصص والمانجا؟
يقوم Stump تلقائياً بقراءة ملفات `ComicInfo.xml` المدمجة داخل ملفات CBZ لاستخراج أسماء السلاسل، ورقم العدد، والملخص، وأسماء المؤلفين والرسامين، وتاريخ الإصدار.
كم يستهلك Stump من الذاكرة العشوائية (RAM)؟
بما أن Stump مبني بلغة Rust، فهو فائق الخفة والكفاءة، حيث يستهلك عادة ما بين 30 إلى 70 ميجابايت فقط من الذاكرة العشوائية داخل Docker.