📚 تثبيت Readeck — منصة القراءة لاحقاً وأرشفة المقالات المستقلة على Docker

نشر تطبيق Readeck على Ubuntu باستخدام Docker — الأداة مفتوحة المصدر فائقة الخفة المكتوبة بلغة Go لحفظ المقالات وقراءتها بدون إعلانات وأرشفة الصور وتصدير الكتب الإلكترونية ePub.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر Readeck على المنفذ 8177 مع قاعدة بيانات SQLite وحفظ دائم للمقالات والوسائط.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/readeck/readeck-ubuntu.sh
chmod +x readeck-ubuntu.sh
sudo bash readeck-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/readeck/readeck-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x readeck-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للبيانات (`./data`) وتشغيل حاوية Readeck الرسمية على المنفذ 8177 (المحول من 8000 الداخلي).

sudo bash readeck-ubuntu.sh

4 إتمام معالج الإعداد

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8177. اتبع معالج الإعداد الأول لإنشاء حساب المشرف وتثبيت إضافات المتصفح وبدء أرشفة المقالات.

http://<your-server-ip>:8177

المنافذ المستخدمة

المنفذالغرض
8177Web UI (host → container 8000) — first-run wizard creates the account
READECK_ALLOWED_HOSTSSet to your server IP — add your domain if you add one
./dataAccount, database, and every archived article

نظرة عامة

تعد Readeck منصة ويب عصرية وفائقة الخفة مفتوحة المصدر لأرشفة المقالات والروابط والقراءة لاحقاً (Read-Later) مكتوبة بلغة Go. تعمل المنصة على المنفذ 8177 (المحول من 8000 الداخلي)، وتقوم بحفظ المقالات والتدوينات والدروس عبر إزالة كافة الإعلانات المزعجة، ونوافذ الكوكيز، وحواجز الدفع المشوشة. وتقوم بتنزيل النصوص والصور المرفقة محلياً على سيرفرك، مع إتاحة تظليل النصوص، والتنظيم بالوسوم، وتصدير قوائم القراءة بصيغة ePub لأجهزة القراءة الإلكترونية (Kindle وKobo).

لماذا تستخدمه

تقوم المنصات التجارية (مثل Pocket وInstapaper) بإغلاق خدماتها أو تقييد البحث بالنصوص خلف اشتراكات شهرية وبيع بيانات القراءة لشبكات الإعلانات. تمنحك الاستضافة الذاتية لـ Readeck أرشيفاً دائماً ومحلياً لمقالاتك المفضلة: فحتى لو توقف الموقع الأصلي عن العمل أو حُذِف المقال، فإن نسختك المؤرشفة تظل محفوظة بالكامل على سيرفرك للأبد بدون أي اشتراكات.

متى تحتاجه

  • تبحث عن بديل مفتوح المصدر ومستقل لتطبيقات Pocket أو Instapaper بدون أي إعلانات أو تتبع
  • تريد أرشفة المقالات والدروس التقنية والوثائق المهمة قبل أن تختفي من الإنترنت (ظاهرة اندثار الروابط Link Rot)
  • تحتاج إلى وضع قراءة مريح وخالٍ من المشتتات مع إمكانية تخصيص الخطوط والوضع الداكن وتظليل النصوص
  • تريد تصدير مقالاتك إلى كتب إلكترونية بصيغة ePub لقراءتها على أجهزة الحبر الإلكتروني (Kindle أو Kobo)
  • تريد حفظ المقالات بضغطة زر واحدة عبر إضافات المتصفحات الرسمية لـ Chrome وFirefox والهواتف

من يحتاجه

  • الباحثون والصحفيون والطلاب لأرشفة المراجع والمقالات التحليلية والأوراق البحثية
  • مهندسو البرمجيات والمطورون لحفظ الشروحات التقنية وكتيبات التوثيق البرمجي
  • القراء النهمون الذين يفضلون القراءة النقية على الحواسيب والهواتف وأجهزة القراءة الإلكترونية
  • المدافعون عن الخصوصية للحفاظ على سرية اهتماماتهم وقوائم قراءاتهم بعيداً عن كبرى الشركات
  • أصحاب السيرفرات المنزلية الراغبون في أداة قراءة وحفظ سريعة وخفيفة جداً بلغة Go

حالات الاستخدام الشائعة

  • حفظ المقالات التقنية الطويلة بضغطة زر من متصفح Firefox وقراءتها لاحقاً بدون أي إعلانات منبثقة
  • تظليل الفقرات المهمة في المقالات البحثية والبحث السريع داخل كافة النصوص المظللة فورياً
  • تصدير 20 مقالاً تقنياً في كتاب ePub موحد لقراءته بدون إنترنت أثناء السفر بالطائرة
  • تنظيم الروابط والمقالات بوسوم مخصصة (مثل `#devops` و`#security` و`#cooking`)
  • أرشفة المقالات الإخبارية مع حفظ كافة المخططات والرسوم البيانية والصور التوضيحية محلياً بالسيرفر

الميزات الرئيسية

  • محرك معالجة فائق السرعة بلغة Go مع استهلاك ذاكرة منخفض واستخلاص فوري لنصوص المقالات
  • أرشفة محلية كاملة: تنزيل نصوص HTML النظيفة والصور عالية الجودة والخطوط على القرص مباشرة
  • وضع قراءة مخصص وخالٍ من المشتتات: التحكم في حجم الخط، وارتفاع الأسطر، وعرض الصفحة، والألوان
  • تظليل النصوص والملاحظات: تظليل العبارات الرئيسية واستعراضها في تبويب مخصص للملاحظات
  • تصدير بصيغة ePub وPDF: توليد كتب إلكترونية منسقة خصيصاً لأجهزة الحبر الإلكتروني
  • محرك بحث شامل بالنصوص: البحث في العناوين وأسماء الكتاب وكامل نصوص المقالات والملاحظات
  • إضافات متصفحات رسمية: إضافات مخصصة لمتصفحي Firefox وChrome لحفظ الروابط بضغطة زر
  • نشر منظم في حاوية موحدة عبر Docker مع ربط مجلد `./data` لحفظ قاعدة بيانات SQLite والوسائط

كيفية الاستخدام بعد التثبيت

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8177 لعرض معالج الإعداد الأولي
  • أدخل اسم المستخدم وبريدك الإلكتروني وكلمة المرور لإنشاء حساب المشرف الأساسي
  • ثبت إضافة Readeck على متصفح Chrome أو Firefox واربطها برابط سيرفرك
  • احفظ مقالاً تجريبياً وتأكد من استخلاص النصوص والصور وتنسيقها النقي بنجاح
  • ضع Readeck خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • تأكد من كتابة نطاق موقعك في متغير `READECK_ALLOWED_HOSTS` داخل ملف `docker-compose.yml`

أفضل ممارسات الأمان

  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي في الإنتاج لحماية رموز الجلسات والمحتوى المؤرشف
  • اضبط متغير `READECK_ALLOWED_HOSTS` بنطاق موقعك أو عنوان IP بدقة لمنع هجمات ترويسة المضيف
  • لا تفتح المنفذ 8177 للإنترنت العام مباشرة دون وكيل عكسي مشفر بـ SSL
  • احمِ مجلد البيانات `./data` الذي يحتوي على قاعدة بيانات SQLite والوسائط بصلاحيات نظام مناسبة
  • عيّن كلمة مرور قوية للمشرف وحافظ على سرية مفاتيح API
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وتحسينات محرك القراءة

المنافذ وإعدادات جدار الحماية

يقدم تطبيق Readeck واجهته والواجهة البرمجية API عبر منفذ TCP 8177 (المحول من 8000 الداخلي). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8177، مع إبقاء المنفذ 8177 مغلقاً في جدار الحماية الخارجي وفتح المنفذين القياسيين 80 و443 للزوار.

النسخ الاحتياطي والصيانة

  • انسخ مجلد `./data` احتياطياً، والذي يحتوي على ملف قاعدة بيانات `readeck.db` وكافة ملفات وصور المقالات
  • احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على المتغيرات والنطاقات المسموحة
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع المقالات والتظليلات بنجاح

الأخطاء الشائعة

  • نسيان كتابة النطاق في متغير `READECK_ALLOWED_HOSTS` مما يسبب ظهور خطأ 400 Bad Request عند الدخول عبر الدومين
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر بدون شهادة SSL
  • عدم ربط مجلد التخزين الدائم `./data`، مما يسبب مسح كافة المقالات والروابط المحفوظة عند تحديث الحاوية
  • محاولة حفظ صفحات ويب تفاعلية بالغة التعقيد تعتمد كلياً على جافاسكريبت متقدم دون فحص توافق القارئ
  • كشف منفذ 8177 للإنترنت العام مباشرة دون تحديد معدل الطلبات

استكشاف الأخطاء وإصلاحها

  • ظهور خطأ 400 Bad Request عند الدخول عبر النطاق — أضف نطاقك لمتغير `READECK_ALLOWED_HOSTS` في ملف Compose
  • إضافة المتصفح تفشل في الاتصال — تأكد من عمل السيرفر عبر HTTPS وصحة صلاحيات مفتاح API
  • الصور لا تظهر في المقال المؤرشف — تأكد من قدرة السيرفر على الاتصال بالإنترنت الخارجي لتنزيل الصور
  • ظهور خطأ HTTP 500 في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs readeck -f`
  • خطأ قفل قاعدة البيانات (Database locked) — تأكد من دعم نظام الملفات لقفل SQLite وتجنب التخزين الشبكي NFS

البدائل

تطبيق Wallabag المكتوب بـ PHP. تطبيق Shiori لإدارة الروابط بلغة Go. تطبيق Linkding البسيط لحفظ الإشارات المرجعية. منصة Pocket التجارية السحابية.

متى لا تستخدمه

تجنب استخدام Readeck إذا كنت تبحث عن قارئ خلاصات أخبار RSS لمتابعة مئات المواقع الإخبارية لحظياً (حيث صُممت تطبيقات مثل FreshRSS أو Miniflux لمتابعة الخلاصات). وإذا كنت تحتاج لويكي توثيق ومحرر مستندات مشترك لفرق العمل، فإن BookStack أو Outline مخصصة لإدارة المعرفة.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما الفرق بين تطبيق Readeck وتطبيق Wallabag؟

يعتمد تطبيق Wallabag على لغة PHP وقاعدة بيانات MySQL ويحتوي على ميزات إضافية معقدة. بينما يتميز Readeck بأنه تطبيق مدمج وخفيف جداً مكتوب بلغة Go ويستهلك قدراً ضئيلاً من الذاكرة مع سرعة فائقة وتصميم عصري.

هل يمكنني تصدير المقالات المؤرشفة لأجهزة القراءة الإلكترونية (Kindle أو Kobo)؟

نعم! يتضمن Readeck ميزة تصدير أصيلة بصيغة ePub. حيث يمكنك تصدير مقال بمفرده أو قائمة مقالات كاملة ككتاب إلكتروني ونقله مباشرة لجهاز Kindle أو Kobo.

هل يقوم Readeck بحفظ الصور محلياً على السيرفر؟

نعم! عند أرشفة أي مقال، يقوم Readeck بتنزيل وحفظ كافة الصور المدمجة محلياً داخل مجلد `./data`، مما يضمن بقاء المقال كاملاً حتى لو حُذفت الصور من الموقع الأصلي.

هل تتوفر إضافات لمتصفحات الويب لتطبيق Readeck؟

نعم! يوفر Readeck إضافات رسمية لمتصفحي Mozilla Firefox وGoogle Chrome لحفظ المقالات بنقرة زر واحدة من شريط المتصفح.

كم يستهلك Readeck من الذاكرة العشوائية (RAM)؟

كُتِب Readeck بلغة Go وهو فائق الخفة، حيث يستهلك عادة ما بين 30 إلى 60 ميجابايت فقط من الذاكرة العشوائية داخل Docker.