الانتقال إلى المحتوى الرئيسي
هذه الخدمات الاختيارية غير مطلوبة لتشغيل Overleaf، لكنها تساعد كثيرًا في التطوير وتصحيح الأخطاء وفحص البيانات. كلها جزء من بيئة التطوير، لذا لا يلزم إضافة أي شيء إلى docker-compose.yml. بعد تسجيل الدخول إلى الموقع، تشير قائمة Dev tools في شريط التنقل إلى الأدوات التي يقدّمها الموقع على مساراته الخاصة.
لا تملك أي من هذه الأدوات تسجيل دخول: المستخدمون المجهولون في Grafana هم مسؤولوها، ويمكن لـ Mongo Express تغيير أي مستند. يستمع الموقع وHoppscotch وMongo Express (8081) وRedisInsight (5540) على 127.0.0.1 للمضيف فقط، فلا تستطيع الأجهزة الأخرى الوصول إليها.

Grafana

يقدّم الموقع Grafana على /grafana/ عبر webpack-dev-server، لذا لا تحتاج إلى منفذ خاص بها. يحتوي مجلدها Overleaf Develop على لوحات المعلومات التالية:

All services: حالة كل خدمة والمضيف والموارد التي تستخدمها كل خدمة

Data flow: تعديل في طريقه من document-updater عبر project-history إلى history-v1 وMongo

يجمع Prometheus بيانات /metrics من الخدمات وmongodb-exporter وredis-exporter وcadvisor وnode-exporter؛ ويرسل Alloy سجلات كل حاوية في المشروع إلى Loki، حيث تقرأها مرشحات Log search وService وLog level في لوحات المعلومات. تعيش بياناتها داخل الحاويات فقط، لذا تُفرَّغ عند إعادة إنشائها. يعمل cAdvisor بامتيازات ويقرأ / و/sys وبيانات Docker ومقبس containerd على المضيف للقراءة فقط؛ ويقرأ node-exporter المسار / على المضيف. لوحات المعلومات مُولَّدة: عدّل develop/grafana/make-dashboards وشغّله بدلًا من تعديل ملفات JSON.

Mailpit

مع MAILPIT_ENABLED=true يرسل web كل بريد إلكتروني إلى Mailpit بدلًا من خادم بريد حقيقي، ويكون تأكيد البريد الإلكتروني مفعّلًا (EMAIL_CONFIRMATION_DISABLED=false). يمكن عندها متابعة روابط التفعيل ودعوات المشاريع وإعادة تعيين كلمات المرور ورموز التأكيد من صندوق الوارد.

بريد تفعيل ودعوة مشروع ورمز تأكيد وإعادة تعيين كلمة المرور في Mailpit

لا يملك Mailpit وحدة تخزين: إعادة إنشاء حاويته تفرّغ صندوق الوارد.

Mongo Express

يعرض Mongo Express مجموعات قاعدة البيانات sharelatex، ويمكنه عرض مستنداتها وتعديلها واستيرادها وتصديرها.

مجموعات قاعدة البيانات sharelatex في Mongo Express

RedisInsight

يحفظ RedisInsight اتصالاته في develop/data/redis-insight. في المرة الأولى، اختر Connect existing database وأدخل المضيف redis والمنفذ 6379.

RedisInsight متصل بخدمة redis

إعداد Hoppscotch

تمرير طلبات API عبر الوكيل

يرسل Hoppscotch الطلبات من المتصفح، الذي لا يستطيع الوصول إلى الخدمات بأسمائها في Docker. يعمل الوكيل الخاص به، Proxyscotch، داخل شبكة Docker ويُقدَّم على /proxy من عنوان Hoppscotch. افتح http://localhost:9170، وانتقل إلى Settings → Interceptor، واختر Proxy، واضبط Proxy URL على http://localhost:9170/proxy. يبقى الإعداد محفوظًا في المتصفح.

إعداد Interceptor. لقطة الشاشة من إعداد أقدم: استخدم http://localhost:9170/proxy كقيمة لـ Proxy URL.

يمكنك الآن الاختبار باستخدام http://web:3000/status للتحقق مما إذا كانت خدمة web تعمل:

استيراد واجهات API للخدمات

يحتوي develop/hoppscotch/openapi/ على ملف OpenAPI لواجهة API الداخلية لكل خدمة. في Hoppscotch افتح Collections → Import → Import from File واختر جميع الملفات دفعة واحدة. يصبح كل ملف مجموعة تذهب طلباتها إلى عنوان Docker الخاص بالخدمة. تُعرض الملفات نفسها في قسم واجهة API للخدمات.

مشكلات CSRF

إذا استخدمت Postman أو أدوات تصحيح أخرى لإنشاء طلب post، فقد تجد أن تسجيل الدخول مرفوض، والسبب هو الخطأ 403. ويرجع ذلك إلى أن Overleaf محمي بالتحقق من csrf.
قد ترى في وحدة التحكم ما يلي:
للتعامل مع ذلك أثناء تطويرك لـ Overleaf، عليك إعداد رمز csrf الخاص بك. وإليك الشرح المفصل.
1

إضافة سكربت ما قبل الطلب

أضف الشيفرة التالية إلى Pre-Request
السكربت كما يلي:
2

إضافة ترويسات الطلب

عليك إضافة الترويسات التالية:
3

تسجيل الدخول باستخدام أدوات API

يمكنك الآن تسجيل الدخول باسم المستخدم وكلمة المرور.
إليك الاستجابة عند إدخال اسم مستخدم أو كلمة مرور خاطئة.
آخر تعديل في ٢٠ نوفمبر ٢٠٢٦