الانتقال إلى المحتوى الرئيسي
إذا كنت تستخدم إصدارًا أقدم، فيُرجى استخدام sharelatex بدلًا من overleaf في أسماء المسارات.
تركيب نظام ملفات NFS داخل حاوية Overleaf ممكن تقنيًا، لكنه غير موصى به وقد يؤدي إلى أنواع مختلفة من أخطاء الأداء.من الأخطاء الشائعة التي تظهر أثناء الترجمة:
ننصح بشكل خاص بعدم استخدام أنظمة ملفات مدعومة بـ NFS للبيانات المؤقتة، مثل المجلدات المستخدمة لبيانات الترجمة. نوصي باستخدام قرص مؤقت محلي (scratch disk)، ويُفضَّل أن يكون SSD محليًا للمجلدات التالية.بالنسبة للإعدادات القائمة على docker-compose، نقترح ببساطة تجاوز التركيب (bind-mount) من NFS، مما يتجنب تغيير المسارات في التطبيق. فيما يلي مقتطف من تكوين docker-compose يستخدم قرصًا مؤقتًا مركّبًا على /scratch:
docker-compose excerpt
لا حاجة إلى ترحيل أي ملفات موجودة من NFS إلى موقعها الجديد بعد التحديث. يمكن لمترجم LaTeX إعادة إنشاء جميع الملفات عند تشغيل ترجمة كاملة مرة أخرى.لمزيد من التفاصيل راجع: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
إذا كنت تشغّل Overleaf على Windows أو macOS، فقد تفشل خدمة mongo في إعادة التشغيل، مع ظهور الخطأ:
Example error
قد يحدث هذا عندما تكون بيانات MongoDB مركّبة (bind-mounted) من نظام ملفات لا يوفّر الدلالات التي يتطلبها، مثل مجلد مركّب من Windows. بالنسبة إلى Windows باستخدام WSL 2، أبقِ Toolkit داخل المجلد الرئيسي لـ Linux في Ubuntu واستخدم عمليات الربط الافتراضية (bind mounts). راجع عمليات التحقق من MongoDB في دليل المنصة.بالنسبة إلى تثبيت جديد يحتاج إلى تخزين يديره Docker، يستخدم التجاوز التالي وحدات تخزين مسمّاة (named volumes) (راجع إرشادات التخزين لصورة MongoDB). في تثبيت قائم، لا يؤدي تغيير عمليات التركيب إلى ترحيل البيانات: خذ نسخة احتياطية من قاعدة البيانات/ذاكرة التخزين المؤقت واستعدها قبل التبديل، وإلا فسترى الخدمة وحدات تخزين فارغة. أضف هذا إلى config/docker-compose.override.yml، مع دمجه مع أي إعدادات موجودة:
config/docker-compose.override.yml
لمزيد من المعلومات راجع: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
استخدم الأمر docker logs redis لعرض نسخة من السجلات.إذا رأيت السطر Fatal: Can't initialize Background Jobs، فستبدو المخرجات الكاملة مشابهة لما يلي:
Redis log example
قد يكون ذلك مرتبطًا بإصدار Docker المستخدم حاليًا. يُفترض أن يؤدي التحديث إلى إصدار >= 20.10.10 إلى حل هذه المشكلة.لمزيد من المعلومات، راجع المشكلة المسجّلة في مشروع Redis الأصلي: https://github.com/redis/redis/issues/12362المرجع: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
في بعض الأحيان، قد تُنشأ صور المعاينة/الصور المصغّرة التي يولّدها Ayakaleaf Pro باتجاه خاطئ، وتتطلب تدخلًا يدويًا لتصحيحها. تُخزَّن هذه الصور في /var/lib/overleaf/data/template_files/.نوصي بأخذ نسخة احتياطية من هذا المجلد قبل إجراء أي تغييرات.ستحتاج إلى اتباع الخطوات أدناه لكل قالب متأثر:ابحث عن معرّف القالب: انتقل إلى معرض القوالب في نسختك (/templates/all)، وافتح قالبًا متأثرًا، وانسخ المعرّف من عنوان URL (على سبيل المثال: https://your-instance-url/templates/6645d346c224815e9460a695). شغّل أمر التصحيح: شغّل الأمر التالي من مضيف Docker (استبدل معرّف القالب بالمعرّف الذي نسخته وعدّل المسار إذا لزم الأمر): docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”المرجع: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
الأمر \write18 معطّل افتراضيًا في Community Edition لأن جميع عمليات الترجمة تجري داخل حاوية sharelatex نفسها؛ وهذا هو الإعداد الافتراضي الأكثر أمانًا.إذا كنت ترغب في تفعيله لـ pdflatex، فأنشئ ملف latexmkrc في جذر مشروعك بالمحتوى التالي:
latexmkrc
ثم حاول إعادة الترجمة.المرجع: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
تعني هذه الأخطاء أن الحاوية mongo تتعطل وتُعاد تشغيلها باستمرار. يشغّل bin/up قاعدة MongoDB ثم ينفّذ أمرًا داخلها، فيفشل الأمر أثناء إعادة تشغيل الحاوية. ويُظهر bin/docker-compose ps الخدمة mongo بالحالة Restarting.لمعرفة السبب الفعلي، اقرأ سجل MongoDB:
الأسباب الشائعة هي:
  • لا يدعم المعالج تعليمات AVX. يتطلب MongoDB 5.0 وما بعده تعليمات AVX على x86-64، ويُظهر السجل MongoDB 5.0+ requires a CPU with AVX support. في الأجهزة الافتراضية، اضبط نوع المعالج على host حتى تُمرَّر تعليمات AVX.
  • نواة Linux من 6.19 إلى 7.0.13. يرفض MongoDB العمل على هذه الأنوية. راجع متطلبات البرمجيات لمعرفة الحل البديل.
  • أُنشئت البيانات بإصدار أقدم من MongoDB. لا يستطيع MongoDB 8.0 فتح بيانات الإصدار 4.4 أو 5.0 مباشرةً. قم بالترقية إصدارًا رئيسيًا واحدًا في كل مرة، راجع تحديث MongoDB.
هذا سلوك متوقع مع Ayakaleaf Pro ويمكنك تجاهله. تُطبع هذه الرسالة عندما لا تكون قيمة OVERLEAF_IS_SERVER_PRO هي true، وهذا هو الحال في صورة Ayakaleaf Pro. لا يحتاج Ayakaleaf Pro إلى هذا المتغير، لذا اتركه دون ضبط.
قبل أن يبدأ Overleaf، تُجري الحاوية فحوصات بدء التشغيل وتخرج عند فشل أحدها. يشغّلها Toolkit مع restart: always، لذا يعيد Docker تشغيلها ويفشل الفحص نفسه مرة أخرى. يذكر ناتج بدء التشغيل اسم الفحص الذي فشل:
الأسباب الشائعة هي:
  • Missing required secrets: اضبط OVERLEAF_INVITE_TOKEN_SECRET في config/variables.env، راجع متغيرات البيئة.
  • ShareLaTeX to Overleaf rebranding: لا تزال الإعدادات تستخدم متغيرات أو مسارات SHARELATEX_؛ أعد تسميتها كما توضح الرسالة.
  • خطأ بعد Checking can connect to mongo and redis: لا يستطيع Overleaf الوصول إلى MongoDB أو Redis. تحقق من bin/logs mongo و bin/logs redis.
بعد إصلاح السبب، شغّل bin/up -d.
في كل بدء تشغيل، تشغّل الحاوية سكربتات بدء التشغيل الخاصة بها واحدًا تلو الآخر، ويذكر السجل كل واحد منها بالصيغة *** Running /etc/my_init.d/<script>.... لا يكون لدى 910_initiate_doc_version_recovery عمل يؤديه إلا في النسخ التي شغّلت Overleaf 5.0.1 في وقت ما. وفي أي نسخة أخرى يطبع No recovery of doc versions needed. ويستمر بدء التشغيل. كما يُكتب مخرجه في data/history/doc-version-recovery.log داخل OVERLEAF_DATA_PATH.يكشف رمز الخروج ونهاية bin/docker-compose logs --tail=100 sharelatex ما حدث:
  • رمز الخروج 2، وينتهي السجل بـ *** Init system aborted.: أُوقفت الحاوية، على سبيل المثال بواسطة bin/stop أو docker stop أو Ctrl+C على bin/up. السكربت المذكور في آخر سطر Running هو فقط السكربت الذي كان قيد التشغيل في تلك اللحظة، ولم يفشل. ابدأ الحاوية مجددًا باستخدام bin/up -d ودع بدء التشغيل يكتمل.
  • رمز الخروج 1، ويعرض السجل *** /etc/my_init.d/<script> failed with status <n>: فشل ذلك السكربت، ويوجد خطؤه في الأسطر التي تسبقه مباشرة. إذا فشل 910_initiate_doc_version_recovery مع Detected unflushed changes while recovering doc versions، فهذا يعني أن النسخة شغّلت 5.0.1 وما زالت لديها تعديلات لم تُفرَّغ (unflushed)؛ اتبع الدليل الرسمي Doc version recovery.
تظهر هذه الصفحة عندما يكون حسابك مسجّل الدخول لكنه غير مسموح له بفتح الصفحة، مثل صفحة إدارة يفتحها حساب ليس مسؤولًا، أو مشروع غير مُشارَك معك.لفتح صفحات الإدارة، سجّل الدخول بحساب مسؤول. يمكن لمسؤول حالي جعل حساب آخر مسؤولًا، أو يمكنك إنشاء حساب باستخدام الأمر create-user --admin، راجع إدارة المستخدمين. في بيئة التطوير (develop/)، تحتاج صفحات الإدارة أيضًا إلى ADMIN_PRIVILEGE_AVAILABLE=true في develop/dev.env؛ وصورة Ayakaleaf Pro تضبطه بالفعل.
آخر تعديل في ٨ نوفمبر ٢٠٢٦