الانتقال إلى المحتوى الرئيسي

الطبيب (Doctor)

يأتي Overleaf Toolkit مع سكربت doctor مفيد للمساعدة في تصحيح الأخطاء. شغّل bin/doctor وسيطبع السكربت معلومات حول بيئة الجهاز المضيف، وإعداداتك، والتبعيات التي يحتاجها Toolkit. ويمكن لهذه المخرجات أيضًا أن تساعدنا في تشخيص مشكلات تثبيتات Ayakaleaf Pro الخاصة بك.
يمكن لمستخدمي Overleaf Pro فتح مشكلة (issue) على GitHub.من الجيد تضمين مخرجات السكربت bin/doctor في رسالتك.

استشارة الطبيب

شغّل سكربت doctor:
Run doctor
سترى مخرجات مشابهة للمثال أدناه.

معلومات الجهاز المضيف

يحتوي القسم Host Information على معلومات حول الجهاز الذي يشغّل Toolkit (على سبيل المثال، توزيعة Linux وإصدارها).

التبعيات

يسرد القسم Dependencies الأدوات اللازمة لعمل Toolkit. إذا كانت الأداة موجودة فستُدرج بالحالة status: present مع معلومات الإصدار. وإذا كانت مفقودة فستُدرج بالحالة status: MISSING! وسيُضاف تحذير في أسفل مخرجات doctor.
إذا كانت أي من التبعيات مفقودة، فمن شبه المؤكد أن Toolkit لن يعمل.

الإعدادات

يحتوي القسم Configuration على معلومات حول الملفات الموجودة في المجلد config/. بالنسبة للملف config/overleaf.rc، يطبع doctor بعض القيم الأساسية. وستُدرج الملفات المفقودة بالحالة status: MISSING! وسيُضاف تحذير في أسفل مخرجات doctor.
ملاحظات حول المثال أعلاه:
  • قد لا يكون تعيين OVERLEAF_DATA_PATH إلى /tmp/overleaf موقعًا آمنًا للبيانات المهمة.
  • تعني MONGO_ENABLED: false أن Toolkit لن يوفّر MongoDB خاصًا به؛ تأكد من أن MONGO_URL يشير إلى MongoDB مُدار خارجيًا إذا لزم الأمر.
  • الملف config/variables.env مفقود في المثال.

التحذيرات

يلخّص القسم Warnings المشكلات التي اكتشفها سكربت doctor. وإذا لم تكن هناك مشكلات، فسيشير هذا القسم إلى ذلك.

أسئلة وأجوبة

الإجابة: لا، الرسائل الثلاث كلها للعلم فقط. يطبع bin/doctor تقريرًا فحسب، ولا يوقف bin/up.
  • logged in to quay.io: false والتحذير Server Pro enabled, but not logged in to quay.io repository: يأتي هذا الفحص من Toolkit الرسمي، حيث تكون صورة Server Pro على سجل quay.io خاص. ومع SERVER_PRO=true، يسحب Toolkit الصورة ghcr.io/ayaka-notes/overleaf-pro، وهي عامة، لذا لا حاجة إلى تسجيل الدخول. تجاهل هذا التحذير.
  • grep: /root/.docker/config.json: No such file or directory (أو مجلد منزلي آخر): يبحث فحص quay.io عن quay.io في ذلك الملف. لا يكتب Docker هذا الملف إلا عندما تكون لديه إعدادات لحفظها، مثلًا بعد docker login، لذا فهو غير موجود على كثير من الخوادم. وهو غير مطلوب.
  • perl: warning: Setting locale failed: لا يستخدم Toolkit الأمر perl إلا هنا، في bin/doctor، لطباعة إصداره، ويُصدر Perl تحذيرًا عندما يشير LANG أو LC_ALL إلى إعداد محلي (locale) غير مثبّت على المضيف. ومع ذلك يُطبع الإصدار. لإخفاء التحذير، اضبط هذه المتغيرات على إعداد محلي مُدرج في ناتج locale -a، مثل C.UTF-8.
أما التحذيرات مثل Docker daemon is not running أو docker not found أو Docker Compose not found أو وجود ملف مفقود في config/ فتحتاج إلى إصلاح: إذ لا يمكن لـ Toolkit البدء بدونها.
آخر تعديل في ٢ نوفمبر ٢٠٢٦