> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

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

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

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

| الاسم | الوصف |
| - | - |
| `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 المراد استخدامه. وكلاهما مطلوب (راجع [ملاحظات الإصدار](/ar/on-premises/release-notes)). |
| `OVERLEAF_REDIS_PORT` و`REDIS_PORT` | منفذ مثيل Redis المراد استخدامه. وكلاهما مطلوب (راجع [ملاحظات الإصدار](/ar/on-premises/release-notes)). |
| `OVERLEAF_REDIS_PASS` و`REDIS_PASSWORD` | كلمة المرور المستخدمة عند الاتصال بـ Redis (إن وُجدت). ويجب ضبط **كلا** متغيري البيئة. راجع [تفعيل المصادقة بكلمة مرور](/ar/on-premises/configuration/overleaf-toolkit/redis#enabling-password-authentication) لمزيد من المعلومات. |
| `OVERLEAF_REDIS_TLS` | <p>إذا ضُبط على `true`، يسمح بالاتصال بمثيل Redis يتطلب TLS.<br /><br /><strong>ملاحظة:</strong> لا يُدعم mTLS حاليًا.</p> |
| `OVERLEAF_NAV_TITLE` | يضبط عنوان علامة التبويب للتطبيق. |
| `OVERLEAF_HEADER_IMAGE_URL_LIGHT` و`OVERLEAF_HEADER_IMAGE_URL_DARK` | عناوين URL لشعارات الترويسة المخصصة للسمتين الفاتحة والداكنة (أُضيفت في 6.3.0). وتعود كل سمة إلى `OVERLEAF_HEADER_IMAGE_URL` عندما لا يكون متغيرها الخاص مضبوطًا. راجع [Branding](/ar/on-premises/configuration/overleaf-toolkit/branding "mention"). |
| `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](/ar/on-premises/configuration/overleaf-toolkit/external-url#outbound-proxy "mention") للاطلاع على الإعداد وقيود الوصول إلى الشبكة. |
| `OVERLEAF_INVITE_TOKEN_SECRET` | <p><strong>مطلوب</strong>. سلسلة عشوائية تُستخدم لتأمين رموز مشاركة المشاريع (أُضيف في Server Pro 6.2.0).</p><p><strong>الحد الأدنى لعدد المحارف:</strong> 16</p> |
| `OVERLEAF_SESSION_SECRET` | سلسلة عشوائية تُستخدم لتأمين الرموز؛ وفي حال موازنة الحمل يجب ضبطها على الرمز نفسه في جميع الأجهزة. وإذا كان يُشغَّل مثيل واحد فقط، فلا حاجة لأن يضبطها المستخدم. |
| `OVERLEAF_COOKIE_SESSION_LENGTH` | يتيح لك تجاوز مدة انتهاء صلاحية ملف تعريف ارتباط الجلسة الافتراضية البالغة 5 أيام. ويجب أن تكون القيمة البديلة بالمللي ثانية. مثال: لجعل الجلسة تدوم ساعة واحدة، اضبط `COOKIE_SESSION_LENGTH=3600000`. (أُضيف في Server Pro 4.2) |
| `OVERLEAF_TRUSTED_PROXY_IPS` | <p>إذا لم يُضبط، فقيمته الافتراضية `loopback`. وإذا ضبطته يدويًا، فعليك، بالإضافة إلى عناوين IP الموثوقة لديك، تضمين `loopback` (أو `127.0.0.1`)، الذي يمنح الثقة لمثيل nginx العامل داخل الحاوية <strong>sharelatex</strong>. ولا تُقبل إلا عناوين IP ونطاقات CIDR: لا تضف أسماء مضيفين مثل `localhost`، وإلا فسيفشل Overleaf في البدء ويعيد `502 Bad Gateway`.<br /><br />إذا كنت تستخدم شبكة فرعية من `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`.<br /><br />إذا كنت تستخدم وكيل TLS خارجيًا (أي لا تديره Overleaf Toolkit)، فيُرجى التأكد من ضبط `OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy>`، مثل `OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37`.</p> |
| `OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS` | إذا ضُبط على `true`، فسيقصر دعوات المشاريع على عناوين البريد الإلكتروني المطابقة لحسابات مستخدمين موجودة. |
| `OVERLEAF_ALLOW_PUBLIC_ACCESS` | إذا ضُبط على `true`، فسيسمح للمستخدمين غير المصادَق عليهم بعرض الموقع. والقيمة الافتراضية `false`، مما يعني أن المستخدمين غير المصادَق عليهم سيُعاد توجيههم دون قيد أو شرط إلى صفحة تسجيل الدخول عند محاولتهم عرض أي جزء من الموقع. لاحظ أن ضبط هذا الخيار لا يعطّل المصادقة أو الأمان بأي شكل. وهذا الخيار ضروري إذا كان مستخدموك ينوون جعل مشاريعهم عامة والسماح لمستخدمين غير مصادَق عليهم بعرضها. |
| `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | إذا ضُبط على `true`، فسيسمح للمستخدمين المجهولين بعرض المشاريع المشاركة عبر ميزة [المشاركة بالرابط](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) وتحريرها. |
| `OVERLEAF_DISABLE_LINK_SHARING` | يعطّل ميزة [المشاركة بالرابط](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27). |
| `EMAIL_CONFIRMATION_DISABLED` | عند ضبطه على `true` لن تُعرض اللافتة التي تطلب تأكيد البريد الإلكتروني. |
| `ADDITIONAL_TEXT_EXTENSIONS` | مصفوفة من السلاسل النصية لتهيئة امتدادات إضافية للملفات القابلة للتحرير. |
| `DEFAULT_LATEX_COMPILER` | <p>يُستخدم لضبط المترجم الافتراضي الذي تستخدمه المشاريع <strong>الجديدة</strong>. (أُضيف في Server Pro 6.2.0).</p><p><strong>الخيارات:</strong> `pdflatex` أو `latex` أو `xelatex` أو `lualatex`</p> |
| `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` | <p>يُستخدم لتعديل مهلة انتهاء صلاحية المستخدمين المحذوفين. ويُضبط بالمللي ثانية.<br /><br /><strong>القيمة الافتراضية:</strong> 90 يومًا</p> |
| `OVERLEAF_PROJECT_HARD_DELETION_DELAY` | <p>يُستخدم لتعديل مهلة انتهاء صلاحية المشاريع المحذوفة. ويُضبط بالمللي ثانية.<br /><br /><strong>القيمة الافتراضية:</strong> 90 يومًا</p> |
| `MAX_UPLOAD_SIZE` | <p>يتحكم في الحد الأقصى لحجم عملية رفع واحدة، بالميغابايت. والقيمة الافتراضية `50`.<br /><br /><strong>تنبيه</strong>: هذا المتغير مجرد رقم خام، دون وحدة (MB) أو أي تغليف.<br /><br />ويقتصر الحجم الإجمالي غير المضغوط لملف `.zip` المرفوع على 6 × هذه القيمة (300 MB افتراضيًا).</p> |
| `COMPILE_SIZE_LIMIT` | يتحكم في الحد الأقصى لحجم جسم الطلب بالبايت. وهو مجموع أحجام جميع ملفات المستندات داخل المشروع (`main.tex` و`references.bib` (إن لم يكن مرتبطًا) وغيرها)، والتي يجب إرسالها في طلب الترجمة الأولي إلى خدمة CLSI. |
| `COMPILE_TIMEOUT` | المدة الزمنية بالثواني المسموح بها لإكمال عملية الترجمة. لمزيد من المعلومات، راجع [تحديث مهلة ترجمة المشروع](/ar/on-premises/user-and-project-management/project-management#updating-project-compile-timeout). |
| `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | مهلة قابلة للتهيئة بين إعادة الاتصال السلسة للمحرر، وحفظ البيانات، وإيقاف تشغيل الحاوية، للحد من خطر فقدان البيانات. |
| `SECCOMP_PROFILE` | <p>اضبط متغير البيئة هذا على مسار في الجهاز <strong>المضيف</strong> لـ Docker يشير إلى ملف تعريف SECCOMP. ويمكنك تنزيل نسخة من ملف التعريف <a href="https://raw.githubusercontent.com/overleaf/overleaf/365af778b68a7940e08282119dc4ef473e2f0044/services/clsi/seccomp/clsi-profile.json">من هنا</a>.<br /><br />وهو مطلوب حاليًا لعمليات النشر عبر Podman عند استخدام الترجمة المعزولة.</p> |
| `OVERLEAF_DISABLE_CHAT` | إذا ضُبط على `true`، يعطّل ميزة المحادثة داخل المشروع. |
| `OVERLEAF_LOGIN_SUPPORT_TEXT` | عند ضبطه، يمكن استخدامه لعرض معلومات الدعم أسفل زر تسجيل الدخول. ويظهر النص في شاشة تسجيل الدخول، ويمكن استخدامه لتوجيه المستخدمين إلى الدعم الداخلي أو تقديم إرشادات تتعلق بتسجيل الدخول وإنشاء الحسابات وما إلى ذلك. |
| `ALLOW_MONGO_ADMIN_CHECK_FAILURES` | <p>إذا ضُبط على `true`، يسمح بفشل فحوصات بدء تشغيل MongoDB دون أن يمنع ذلك بدء النشر. وقد يكون ذلك مطلوبًا إذا كنت تستخدم قاعدة بيانات MongoDB لا يملك فيها مستخدم قاعدة البيانات الدور `clusterParameterReader`.<br /><br />للحصول على مساعدة في إنشاء دور مخصص، راجع <a href="/ar/on-premises/maintenance/updating-mongodb#creating-a-custom-role">هنا</a>.</p> |
| `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`. |

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.