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 | مطلوب. سلسلة عشوائية تُستخدم لتأمين رموز مشاركة المشاريع (أُضيف في 6.2.0). الحد الأدنى لعدد المحارف: 16 |
OVERLEAF_SESSION_SECRET | موصى به. سلسلة عشوائية تُستخدم لتوقيع ملفات تعريف ارتباط الجلسة؛ وفي حال موازنة الحمل يجب ضبطها على الرمز نفسه في جميع الأجهزة. إذا لم تُضبط، يُولَّد سر عشوائي جديد في كل مرة تُنشأ فيها الحاوية، لذا فإن كل تشغيل لـ bin/up يعيد إنشاء الحاوية (على سبيل المثال بعد تغيير config/variables.env) أو أي ترقية يؤدي إلى تسجيل خروج جميع المستخدمين. ولّده مرة واحدة باستخدام openssl rand -hex 32 واحتفظ به. |
OVERLEAF_COOKIE_SESSION_LENGTH | يتيح لك تجاوز مدة انتهاء صلاحية ملف تعريف ارتباط الجلسة الافتراضية البالغة 5 أيام. ويجب أن تكون القيمة البديلة بالمللي ثانية. مثال: لجعل الجلسة تدوم ساعة واحدة، اضبط COOKIE_SESSION_LENGTH=3600000. |
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 | يُستخدم لضبط المترجم الافتراضي الذي تستخدمه المشاريع الجديدة. (أُضيف في 6.2.0). الخيارات: pdflatex أو latex أو xelatex أو lualatex |
OVERLEAF_STATUS_PAGE_URL | عنوان URL مخصص لصفحة الحالة، مثل status.example.com. |
OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS | اضبطه على 'false' لمنع تهيئة المشاريع الجديدة بسجل المشروع الكامل (Full Project History) |
OVERLEAF_FPH_DISPLAY_NEW_PROJECTS | اضبطه على 'false' لمنع المشاريع الجديدة من عرض سجل المشروع الكامل بدلًا من السجل القديم |
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_DISABLE_LOCAL_LOGIN | إذا ضُبط على true، يخفي تسجيل الدخول بالبريد الإلكتروني وكلمة المرور بحيث لا يتمكن المستخدمون من تسجيل الدخول إلا عبر LDAP أو SAML أو OIDC. لا يسري إلا عندما يفعّل EXTERNAL_AUTH واحدة منها على الأقل (أُضيف في Ayakaleaf Pro 6.3.1). |
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. |