متغيرات البيئة

تصف هذه الصفحة متغيرات البيئة المدعومة في الملف config/variables.env لعمليات النشر عبر Toolkit.

يتكون الملف config/variables.env من تعريفات متغيرات بالصيغة NAME=value؛ وتُعامَل الأسطر التي تبدأ بـ # على أنها تعليقات.

من الضروري إعادة إنشاء حاويات Docker بعد تغيير أي شيء في overleaf.rc أو variables.env عبر تشغيل bin/up.

​

جميع الإصدارات

متغيرات البيئة هذه متوافقة مع Server CE وServer Pro، وتوفر مسار ترحيل سهلًا بين هذين الإصدارين المحليين. ويمكن استخدامها أيضًا مع عمليات النشر عبر Toolkit وعبر Docker Compose على حد سواء.

في السابق، كانت متغيرات البيئة هذه تحمل البادئة SHARELATEX_ بدلًا من OVERLEAF_.

الاسم	الوصف
OVERLEAF_SITE_URL	العنوان الذي يتاح عليه مثيل Overleaf الخاص بك للعموم. ويُستخدم في الروابط العامة وعند الاتصال عبر websockets، لذا يجب ضبطه بشكل صحيح!
OVERLEAF_ADMIN_EMAIL	عنوان البريد الإلكتروني الذي يمكن للمستخدمين من خلاله التواصل مع الشخص الذي يدير الموقع.
OVERLEAF_APP_NAME	الاسم المعروض عند الإشارة إلى التطبيق قيد التشغيل. القيمة الافتراضية هي ‘Overleaf (Community Edition)’.
OVERLEAF_MONGO_URL وMONGO_URL	عنوان URL لقاعدة بيانات Mongo المراد استخدامها.
OVERLEAF_REDIS_HOST وREDIS_HOST	اسم المضيف لمثيل Redis المراد استخدامه. وكلاهما مطلوب (راجع ملاحظات الإصدار).
OVERLEAF_REDIS_PORT وREDIS_PORT	منفذ مثيل Redis المراد استخدامه. وكلاهما مطلوب (راجع ملاحظات الإصدار).
OVERLEAF_REDIS_PASS وREDIS_PASSWORD	كلمة المرور المستخدمة عند الاتصال بـ Redis (إن وُجدت). ويجب ضبط كلا متغيري البيئة. راجع تفعيل المصادقة بكلمة مرور لمزيد من المعلومات.
OVERLEAF_REDIS_TLS	إذا ضُبط على true، يسمح بالاتصال بمثيل Redis يتطلب TLS. ملاحظة: لا يُدعم mTLS حاليًا.
OVERLEAF_NAV_TITLE	يضبط عنوان علامة التبويب للتطبيق.
OVERLEAF_HEADER_IMAGE_URL_LIGHT وOVERLEAF_HEADER_IMAGE_URL_DARK	عناوين URL لشعارات الترويسة المخصصة للسمتين الفاتحة والداكنة (أُضيفت في 6.3.0). وتعود كل سمة إلى OVERLEAF_HEADER_IMAGE_URL عندما لا يكون متغيرها الخاص مضبوطًا. راجع Branding.
OVERLEAF_LINKED_URL_OUTBOUND_PROXY	عنوان URL لوكيل HTTP(S) يُستخدم لجلب الملفات المرتبطة الخارجية وموارد ZIP أو TeX الخارجية عبر واجهة Open in Overleaf API. متاح بدءًا من إعادة إصدار Ayakaleaf Pro 6.3.0 (3 أكتوبر 2026). اتركه دون ضبط للاتصال مباشرةً. مثال: OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128. راجع Outbound Proxy للاطلاع على الإعداد وقيود الوصول إلى الشبكة.
OVERLEAF_INVITE_TOKEN_SECRET	مطلوب. سلسلة عشوائية تُستخدم لتأمين رموز مشاركة المشاريع (أُضيف في Server Pro 6.2.0). الحد الأدنى لعدد المحارف: 16
OVERLEAF_SESSION_SECRET	سلسلة عشوائية تُستخدم لتأمين الرموز؛ وفي حال موازنة الحمل يجب ضبطها على الرمز نفسه في جميع الأجهزة. وإذا كان يُشغَّل مثيل واحد فقط، فلا حاجة لأن يضبطها المستخدم.
OVERLEAF_COOKIE_SESSION_LENGTH	يتيح لك تجاوز مدة انتهاء صلاحية ملف تعريف ارتباط الجلسة الافتراضية البالغة 5 أيام. ويجب أن تكون القيمة البديلة بالمللي ثانية. مثال: لجعل الجلسة تدوم ساعة واحدة، اضبط COOKIE_SESSION_LENGTH=3600000. (أُضيف في Server Pro 4.2)
OVERLEAF_TRUSTED_PROXY_IPS	إذا لم يُضبط، فقيمته الافتراضية loopback. وإذا ضبطته يدويًا، فعليك، بالإضافة إلى عناوين IP الموثوقة لديك، تضمين loopback (أو 127.0.0.1)، الذي يمنح الثقة لمثيل nginx العامل داخل الحاوية sharelatex. ولا تُقبل إلا عناوين IP ونطاقات CIDR: لا تضف أسماء مضيفين مثل localhost، وإلا فسيفشل Overleaf في البدء ويعيد 502 Bad Gateway. إذا كنت تستخدم شبكة فرعية من 172.16.0.0/12 (الشبكة الفرعية الافتراضية لشبكات Docker) لشبكتك العادية، فيُرجى ضبط OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network> في config/variables.env. حيث <network> هي قيمة IPAM -> Config -> Subnet في docker inspect overleaf_default، مثل OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16. والغرض من ذلك منع انتحال ترويسات X-Forwarded. إذا كنت تستخدم وكيل TLS خارجيًا (أي لا تديره Overleaf Toolkit)، فيُرجى التأكد من ضبط OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy>، مثل OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37.
OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS	إذا ضُبط على true، فسيقصر دعوات المشاريع على عناوين البريد الإلكتروني المطابقة لحسابات مستخدمين موجودة.
OVERLEAF_ALLOW_PUBLIC_ACCESS	إذا ضُبط على true، فسيسمح للمستخدمين غير المصادَق عليهم بعرض الموقع. والقيمة الافتراضية false، مما يعني أن المستخدمين غير المصادَق عليهم سيُعاد توجيههم دون قيد أو شرط إلى صفحة تسجيل الدخول عند محاولتهم عرض أي جزء من الموقع. لاحظ أن ضبط هذا الخيار لا يعطّل المصادقة أو الأمان بأي شكل. وهذا الخيار ضروري إذا كان مستخدموك ينوون جعل مشاريعهم عامة والسماح لمستخدمين غير مصادَق عليهم بعرضها.
OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING	إذا ضُبط على true، فسيسمح للمستخدمين المجهولين بعرض المشاريع المشاركة عبر ميزة المشاركة بالرابط وتحريرها.
OVERLEAF_DISABLE_LINK_SHARING	يعطّل ميزة المشاركة بالرابط.
EMAIL_CONFIRMATION_DISABLED	عند ضبطه على true لن تُعرض اللافتة التي تطلب تأكيد البريد الإلكتروني.
ADDITIONAL_TEXT_EXTENSIONS	مصفوفة من السلاسل النصية لتهيئة امتدادات إضافية للملفات القابلة للتحرير.
DEFAULT_LATEX_COMPILER	يُستخدم لضبط المترجم الافتراضي الذي تستخدمه المشاريع الجديدة. (أُضيف في Server Pro 6.2.0). الخيارات: pdflatex أو latex أو xelatex أو lualatex
OVERLEAF_STATUS_PAGE_URL	عنوان URL مخصص لصفحة الحالة (أُضيف في Server Pro 3.4.0)، مثل status.example.com.
OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS	اضبطه على 'false' لمنع تهيئة المشاريع الجديدة بسجل المشروع الكامل (Full Project History) (أُضيف في Server Pro 3.5.0).
OVERLEAF_FPH_DISPLAY_NEW_PROJECTS	اضبطه على 'false' لمنع المشاريع الجديدة من عرض سجل المشروع الكامل بدلًا من السجل القديم (أُضيف في Server Pro 3.5.0).
ENABLE_CRON_RESOURCE_DELETION	اضبط متغير البيئة هذا على true لتفعيل التنظيف التلقائي للمشاريع والمستخدمين المحذوفين بعد 90 يومًا.
OVERLEAF_USER_HARD_DELETION_DELAY	يُستخدم لتعديل مهلة انتهاء صلاحية المستخدمين المحذوفين. ويُضبط بالمللي ثانية. القيمة الافتراضية: 90 يومًا
OVERLEAF_PROJECT_HARD_DELETION_DELAY	يُستخدم لتعديل مهلة انتهاء صلاحية المشاريع المحذوفة. ويُضبط بالمللي ثانية. القيمة الافتراضية: 90 يومًا
MAX_UPLOAD_SIZE	يتحكم في الحد الأقصى لحجم عملية رفع واحدة، بالميغابايت. والقيمة الافتراضية 50. تنبيه: هذا المتغير مجرد رقم خام، دون وحدة (MB) أو أي تغليف. ويقتصر الحجم الإجمالي غير المضغوط لملف .zip المرفوع على 6 × هذه القيمة (300 MB افتراضيًا).
COMPILE_SIZE_LIMIT	يتحكم في الحد الأقصى لحجم جسم الطلب بالبايت. وهو مجموع أحجام جميع ملفات المستندات داخل المشروع (main.tex وreferences.bib (إن لم يكن مرتبطًا) وغيرها)، والتي يجب إرسالها في طلب الترجمة الأولي إلى خدمة CLSI.
COMPILE_TIMEOUT	المدة الزمنية بالثواني المسموح بها لإكمال عملية الترجمة. لمزيد من المعلومات، راجع تحديث مهلة ترجمة المشروع.
MAX_RECONNECT_GRACEFULLY_INTERVAL_MS	مهلة قابلة للتهيئة بين إعادة الاتصال السلسة للمحرر، وحفظ البيانات، وإيقاف تشغيل الحاوية، للحد من خطر فقدان البيانات.
SECCOMP_PROFILE	اضبط متغير البيئة هذا على مسار في الجهاز المضيف لـ Docker يشير إلى ملف تعريف SECCOMP. ويمكنك تنزيل نسخة من ملف التعريف من هنا. وهو مطلوب حاليًا لعمليات النشر عبر Podman عند استخدام الترجمة المعزولة.
OVERLEAF_DISABLE_CHAT	إذا ضُبط على true، يعطّل ميزة المحادثة داخل المشروع.
OVERLEAF_LOGIN_SUPPORT_TEXT	عند ضبطه، يمكن استخدامه لعرض معلومات الدعم أسفل زر تسجيل الدخول. ويظهر النص في شاشة تسجيل الدخول، ويمكن استخدامه لتوجيه المستخدمين إلى الدعم الداخلي أو تقديم إرشادات تتعلق بتسجيل الدخول وإنشاء الحسابات وما إلى ذلك.
ALLOW_MONGO_ADMIN_CHECK_FAILURES	إذا ضُبط على true، يسمح بفشل فحوصات بدء تشغيل MongoDB دون أن يمنع ذلك بدء النشر. وقد يكون ذلك مطلوبًا إذا كنت تستخدم قاعدة بيانات MongoDB لا يملك فيها مستخدم قاعدة البيانات الدور clusterParameterReader. للحصول على مساعدة في إنشاء دور مخصص، راجع هنا.
V1_HISTORY_URL_FOR_GIT_BRIDGE	يتيح فصل نقطة النهاية history-v1 للحركة الداخلية (الخدمة web ← الخدمة history-v1، وكلتاهما في الحاوية sharelatex) عن الحركة الخارجية (git-bridge ← history-v1، العاملتين في حاويات منفصلة).
OVERLEAF_MAINTENANCE_MESSAGE وOVERLEAF_MAINTENANCE_MESSAGE_HTML	يُستخدمان لتخصيص عنوان صفحة الصيانة ومحتواها. ولا يمكن استخدامهما مع OVERLEAF_STATUS_PAGE_URL.

يمكن فرض قيود على كلمات مرور المستخدمين عند استخدام نظام تسجيل الدخول في Overleaf (الحسابات المحلية)، لا خيار SSO مثل LDAP. أما بالنسبة لحسابات SSO، فستُفرض سياسات كلمات المرور من قِبل مزوّد الهوية أو خدمة الدليل لديك، مما يتيح أيضًا دعم المصادقة متعددة العوامل.