📝 تثبيت Overleaf Community Edition — محرر أبحاث LaTeX التشاركي على Docker

نشر منصة Overleaf Community Edition (المعروفة سابقاً بـ ShareLaTeX) على Ubuntu باستخدام Docker — محرر ومترجم أبحاث LaTeX السحابي التشاركي في الوقت الفعلي مع معاينة PDF ودعم TeX Live.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Overleaf على المنفذ 8214 مع قاعدة بيانات MongoDB وذاكرة Redis وحفظ دائم للمشاريع.
عرض على GitHub

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

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

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

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

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

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

chmod +x overleaf-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز حاويات MongoDB 6 وRedis وتهيئة ميزة النسخ المتماثل (rs0) في MongoDB، وتشغيل حاوية ShareLaTeX على المنفذ 8214.

sudo bash overleaf-ubuntu.sh

4 إعداد لوحة Launchpad

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

http://<your-server-ip>:8214/launchpad

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

المنفذالغرض
8214Web UI (host → container 80) — create admin at /launchpad
internalMongoDB (replica set rs0) + Redis (not published)
TeX LiveBundled — first boot is slow

نظرة عامة

تعد Overleaf Community Edition (المعروفة سابقاً باسم ShareLaTeX) منصة تحرير وتجميع مستندات وأبحاث LaTeX السحابية التشاركية الرائدة عالمياً مفتوحة المصدر. تعمل المنصة على المنفذ 8214 مدعومة بقاعدة بيانات MongoDB وذاكرة Redis، وتتيح للباحثين الأكاديميين والطلاب والفرق الهندسية كتابة الأوراق العلمية والمعادلات الرياضية المعقدة والكتب والعروض التقديمية في الوقت الفعلي. وتوفر شاشة مزدوجة للكود ومعاينة فورية لملف PDF، وترجمة فورية باستخدام TeX Live المدمج، والتحرير الجماعي المتزامن داخل بنيتك التحتية الخاصة.

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

تفرض النسخة السحابية التجارية Overleaf.com رسوماً باهظة للاشتراكات الشهرية وتخزن الأبحاث العلمية وبراءات الاختراع السرية على خوادم خارجية قبل نشرها. تمنح الاستضافة الذاتية لـ Overleaf الجامعات والمختبرات والمراكز البحثية السيادة الكاملة على مسودات الأبحاث، مع عدد غير محدود من الباحثين والمشاريع، وسرعة ترجمة فائقة على الشبكة المحلية دون أي تكاليف تراخيص.

متى تحتاجه

  • يحتاج فريقك البحثي أو مختبرك الجامعي إلى محرر LaTeX تشاركي يعمل لحظياً على سيرفر داخلي خاص
  • تلتزم بحماية الملكية الفكرية والسرية التامة للأوراق الأكاديمية وبراءات الاختراع والتقارير الفنية قبل النشر
  • ترغب في عدد غير محدود من المشاريع والمشاركين دون دفع اشتراكات شهرية لكل مستخدم
  • تحتاج إلى ترجمة ملفات PDF السريعة داخل المتصفح دون إلزام الموظفين بتثبيت حزم TeX Live العملاقة محلياً
  • تبحث عن محرر LaTeX موحد يمكن الوصول إليه من أي جهاز ومتصفح (ويندوز، ماك، لينكس، أجهزة لوحية)

من يحتاجه

  • أساتذة الجامعات والباحثون وطلاب الدراسات العليا لكتابة الأوراق العلمية للمجلات والمؤتمرات
  • مهندسو ومطورو البرمجيات لكتابة التوثيق الفني والنماذج الرياضية المعقدة والأوراق البيضاء (Whitepapers)
  • مؤلفو الكتب والناشرون التقنيون لتنسيق المخطوطات والكتب والمراجع الأكاديمية (BibTeX/Biber)
  • مديرو تقنية المعلومات في الجامعات والمؤسسات التعليمية لتوفير بيئة كتابة أكاديمية مركزية
  • أصحاب السيرفرات المنزلية لتوفير محرر LaTeX نظيف ومستقل للمشاريع الشخصية

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

  • كتابة الأبحاث لمجلات IEEE وACM وNature تشاركياً مع تتبع مؤشرات ومواقع مؤلفي البحث لحظياً
  • كتابة رسائل الماجستير والدكتوراه مع إدارة الفصول والمراجع والفهارس آلياً
  • تصميم عروض تقديمية احترافية عبر قوالب Beamer مع الرسوميات المتجهية والمعادلات
  • ترجمة البراهين الرياضية المعقدة والتراكيب الكيميائية باستخدام حزم TeX المخصصة
  • توفير بيئة عمل موحدة للطلاب في المقررات الجامعية لتسليم الواجبات بصيغة LaTeX

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

  • تحرير تشاركي لحظي: يعمل عدة مؤلفين على نفس المستند في نفس الوقت مع مؤشرات ملونة لكل باحث
  • ترجمة فورية لملفات PDF مدعومة بحزمة TeX Live المدمجة مع شاشة معاينة مقسومة
  • إدارة مشاريع غنية: مشاريع متعددة الملفات، تنظيم المجلدات، رفع الصور والمخططات، وربط ملفات BibTeX
  • مفحص أخطاء وتحذيرات LaTeX مدمج مع ميزة الانتقال المباشر لسطر الخطأ لتصحيحه
  • دعم محركات الترجمة القياسية: pdfLaTeX وXeLaTeX وLuaLaTeX ومحركات المراجع BibTeX/Biber
  • لوحة Launchpad الإدارية على مسار `/launchpad` لإدارة المستخدمين وإعدادات السيرفر وحالة النظام
  • تخزين موثوق في قاعدة بيانات MongoDB 6 مع ميزة التكرار المتماثل لضمان سلامة المستندات
  • نشر منظم عبر Docker Compose يربط مجلدات `./data` و`./mongo` و`./redis` لحفظ البيانات بشكل دائم

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8214/launchpad لبدء معالج الإعداد الإداري
  • أنشئ حساب المشرف العام بالبريد الإلكتروني وكلمة مرور قوية
  • اضبط عنوان الموقع العام (مثل https://overleaf.yourdomain.com) وإعدادات البريد من قسم Site Settings
  • سجل الدخول وأنشئ مشروعك الأول: انقر على 'New Project' ← 'Blank Project' أو ارفع قالباً مضغوطاً
  • اختبر ترجمة المستند بالنقر على زر 'Recompile' الأخضر في شريط الأدوات
  • ضع Overleaf خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL لتأمين الاتصال في الإنتاج
  • يمكنك ترقية حزم TeX Live بالكامل بالأمر `tlmgr install scheme-full` داخل الحاوية إذا احتجت لحزم نادرة

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

  • أكمل إعداد المشرف في صفحة `/launchpad` فور تشغيل الحاوية لمنع أي شخص آخر من أخذ ملكية السيرفر
  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي لحماية مسودات الأبحاث والملفات وكلمات المرور أثناء النقل
  • لا تكشف منافذ MongoDB (27017) أو Redis (6379) للإنترنت العام نهائياً؛ واجعلها معزولة داخل Docker
  • اضبط إعدادات البريد الإلكتروني SMTP لتمكين استعادة كلمات المرور وإرسال دعوات المشاريع بأمان
  • احمِ مجلدات `./data` و`./mongo` و`./redis` بصلاحيات مناسبة على السيرفر
  • حدّث صورة الحاوية sharelatex/sharelatex دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

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

يقدم تطبيق Overleaf Community Edition واجهته عبر منفذ TCP 8214 (المحول من 80 الداخلي). في الإنتاج، يجب تهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 وربطه بـ 8214، مع إبقاء المنفذ 8214 مغلقاً في جدار الحماية الخارجي وفتح المنفذين القياسيين 80 و443 لاستقبال الباحثين.

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

  • انسخ مجلد `./mongo` احتياطياً، والذي يحتوي على قاعدة بيانات MongoDB بجميع حسابات المستخدمين والمشاريع وتاريخ المستندات
  • انسخ مجلد `./data` (/var/lib/overleaf) لحفظ ملفات المشاريع المرفوعة والصور وملفات PDF المترجمة
  • استخرج نسخة احتياطية دورية لقاعدة البيانات عبر mongodump: `docker exec overleaf-mongo mongodump --out /data/db/backup`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلدات البيانات بحاوية تجريبية والتأكد من فتح وترجمة المشاريع العلمية بنجاح

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

  • نسيان تهيئة ميزة النسخ المتماثل (rs0) في MongoDB، مما يسبب انهيار حاوية Overleaf المتكرر عند بدء التشغيل
  • تشغيل Overleaf على سيرفر بذاكرة أقل من 3 جيجابايت (تتطلب عمليات تجميع LaTeX وقاعدة MongoDB 3 إلى 4 جيجابايت RAM على الأقل)
  • نسيان تحديث حزم TeX Live عند محاولة ترجمة ملفات تعتمد على حزم `.sty` إضافية غير افتراضية
  • عدم ربط مجلدات التخزين الدائم `./data` و`./mongo`، مما يؤدي لفقدان المشاريع بالكامل عند تحديث الحاوية
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر دون وكيل عكسي آمن

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

  • استغراق الإقلاع الأول عدة دقائق — يقوم Overleaf بتهيئة الجداول وقواعد البيانات لأول مرة؛ انتظر وافحص السجلات عبر `docker logs overleaf -f`
  • خطأ نقص حزم LaTeX (Package not found) — افتح الطرفية داخل الحاوية بالأمر `docker exec -it overleaf tlmgr install <اسم_الحزمة>`
  • معاينة PDF لا تظهر — تأكد من دعم المتصفح لـ WebWorker ومكتبة PDF.js، وافحص رامات السيرفر بالأمر `free -m`
  • صفحة /launchpad لا تفتح — تأكد من صحة تشغيل الحاوية وافتح الرابط المباشر `http://ip-سيرفرك:8214/launchpad`
  • فشل الاتصال بقاعدة MongoDB — افحص سجلات MongoDB بالأمر `docker logs overleaf-mongo -f` للتأكد من تفعيل وضع `rs0`

البدائل

موقع Overleaf.com هو النسخة التجارية السحابية المدفوعة. منصة CodiMD / HedgeDoc محرر نصوص Markdown تشاركي يدعم معادلات MathJax. محررات TeXstudio وVS Code (مع إضافة LaTeX Workshop) برامج مكتبية شخصية ممتازة. لغة Typst بديل حديث وسريع جداً لـ LaTeX بصياغة أبسط.

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

تجنب استخدام Overleaf إذا كنت تحتاج فقط لمحرر نصوص Markdown بسيط لتدوين الملاحظات أو كتابة توثيق سريع دون الحاجة لتنسيقات الأبحاث المعقدة (محررات مثل HedgeDoc أو Obsidian أخف بكثير). وإذا كنت تعمل بمفردك على حاسوبك الشخصي دون الحاجة لمشاركة الفريق، فإن VS Code مع إضافة LaTeX Workshop يوفر بيئة محلية ممتازة بدون سيرفر.

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

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

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

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

ما الفرق بين Overleaf Community Edition وموقع Overleaf.com؟

نسخة Overleaf Community Edition هي النسخة المجانية مفتوحة المصدر التي تستضيفها ذاتياً وتحتوي على محرر ومترجم LaTeX التشاركي الأساسي. بينما يحتوي موقع Overleaf.com التجاري على ميزات مدفوعة إضافية مثل ربط Git وتتبع التغييرات المتقدم وسيرفرات ترجمة فائقة السرعة.

كيف أقوم بتثبيت حزم LaTeX الناقصة؟

يمكنك تثبيت أي حزمة ناقصة بسهولة من سطر الأوامر داخل الحاوية باستخدام مدير الحزم TeX Live: `docker exec -it overleaf tlmgr install <اسم_الحزمة>`، أو تثبيت حزمة TeX Live الكاملة عبر `tlmgr install scheme-full`.

لماذا يتطلب Overleaf قاعدتي MongoDB وRedis؟

تخزن MongoDB كافة ملفات المشاريع وحسابات المستخدمين وتاريخ المستندات. بينما تعمل Redis كذاكرة وسيطة فائقة السرعة وموزع رسائل لمزامنة ضغطات المفاتيح بين الباحثين في نفس اللحظة.

هل يمكن لعدة باحثين تحرير نفس المستند في نفس الوقت؟

نعم! يدعم Overleaf التحرير التشاركي المتزامن في الوقت الفعلي؛ حيث يرى جميع الباحثين مؤشرات بعضهم الملونة والتعديلات اللحظية كما في Google Docs.

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

يتطلب Overleaf (الذي يشمل خدمات Node.js وMongoDB وRedis ومترجمات TeX Live) 3 جيجابايت RAM كحد أدنى، ويوصى بـ 4 إلى 8 جيجابايت لتشغيل عمليات الترجمة المتزامنة لعدة مستخدمين بكفاءة.