> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/ar/althyeh/overleaf-toolkit/environment-variables.md). # متغيرات البيئة تصف هذه الصفحة متغيرات البيئة المدعومة في `config/variables.env` الملف لنشر Toolkit. يجب أن يكون `config/variables.env` يتكون الملف من تعريفات متغيرات بصيغة `NAME=value`؛ وتُعامل الأسطر التي تبدأ بـ `#` على أنها تعليقات. {% hint style="info" %} من الضروري إعادة إنشاء حاويات Docker بعد تغيير أي شيء في `overleaf.rc` أو `variables.env` عن طريق تشغيل `bin/up`. {% endhint %} ### جميع الإصدارات هذه متغيرات البيئة متوافقة مع Server CE وServer Pro وتوفر مسار ترحيل سهلًا بين هذين الإصدارين المحليين. ويمكن استخدامها أيضًا مع نشرات Toolkit وDocker Compose. {% hint style="info" %} سابقًا، كانت متغيرات البيئة هذه تسبق بـ `SHARELATEX_` بدلاً من `OVERLEAF_`. {% endhint %} | الاسم | الوصف | | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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 المطلوب استخدامه. كلاهما مطلوبان (انظر [ملاحظات الإصدار](broken://pages/ee6cb0826de187f4554c094cd0c085cf8a8e8ee4#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PORT` و `REDIS_PORT` | منفذ مثيل Redis المطلوب استخدامه. كلاهما مطلوبان (انظر [ملاحظات الإصدار](broken://pages/ee6cb0826de187f4554c094cd0c085cf8a8e8ee4#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PASS` و `REDIS_PASSWORD` | كلمة المرور المستخدمة عند الاتصال بـ Redis (إن أمكن). **كلاهما** يجب تعيين متغيرات البيئة. راجع [تمكين مصادقة كلمة المرور](broken://pages/a6e59e40b6a449f6fbb4733b03ea128f8cd5797d) لمزيد من المعلومات. | | `OVERLEAF_REDIS_TLS` |

إذا تم تعيينه إلى true، فإنه يسمح بالاتصال بمثيل Redis يتطلب TLS.

ملاحظة: mTLS غير مدعوم حاليًا.

| | `OVERLEAF_NAV_TITLE` | عيّن عنوان تبويب التطبيق. | | `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, localhost أو 127.0.0.1، والذي يثق في مثيل nginx الذي يعمل داخل sharelatex الحاوية.

إذا كنت تستخدم شبكة فرعية من 172.16.0.0/12 (الشبكة الفرعية الافتراضية لشبكات Docker) لشبكتك العادية، فيرجى تعيين OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\ في config/variables.env. حيث إن \ هو 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,\، مثلًا 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`، سيسمح للمستخدمين المجهولين بعرض المشاريع وتحريرها المشتركة عبر [مشاركة الروابط](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` |

يُستخدم لتعيين المترجم الافتراضي المستخدم بواسطة المشاريع الجديدة. (أُضيف في 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'` لمنع المشاريع الجديدة من عرض Full Project History بدلًا من السجل القديم (أُضيف في 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) أو غلاف.

| | `COMPILE_SIZE_LIMIT` | يتحكم في الحد الأقصى لحجم نص الطلب بالبايت. وهو مجموع جميع أحجام ملفات المستندات داخل المشروع (`main.tex`, `references.bib` (إذا لم يكن مرتبطًا) إلخ)، التي يجب إرسالها في طلب التجميع الأولي إلى خدمة CLSI. | | `COMPILE_TIMEOUT` | المدة الزمنية المسموح بها بالثواني لإكمال التجميع. لمزيد من المعلومات راجع [تحديث مهلة تجميع المشروع](broken://pages/4436c4f9fdc6473e7df3b4d9264df21a638c4bfc#updating-project-compile-timeout). | | `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | مهلة قابلة للتهيئة بين إعادة اتصال المحرر بسلاسة، وتفريغ البيانات، وإيقاف تشغيل الحاوية للتخفيف من خطر فقدان البيانات. | | `SECCOMP_PROFILE` |

عيّن متغير البيئة هذا إلى مسار على المضيف الجهاز الذي يشير إلى ملف تعريف SECCOMP. يمكنك تنزيل نسخة من الملف التعريفي هنا.

مطلوب حاليًا لنشرات Podman عند استخدام التجميعات المعزولة (Sandboxed Compiles).

| | `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` service → `history-v1` service، كلاهما في `sharelatex` الحاوية) وحركة المرور الخارجية (`git-bridge` → `history-v1`، تعمل في حاويات منفصلة). | | `OVERLEAF_MAINTENANCE_MESSAGE` و `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | يُستخدم لتخصيص عنوان ومحتوى صفحة الصيانة. لا يمكن استخدامه مع `OVERLEAF_STATUS_PAGE_URL`. | {% hint style="info" %} من الممكن فرض قيود على كلمات المرور للمستخدمين عند استخدام نظام تسجيل الدخول في Overleaf (الحسابات المحلية)، وليس خيار SSO مثل LDAP. بالنسبة لحسابات SSO، ستُفرض سياسات كلمات المرور بواسطة موفر الهوية أو خدمة الدليل الخاصة بك، مع السماح أيضًا بدعم المصادقة متعددة العوامل. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/on-premises/ar/althyeh/overleaf-toolkit/environment-variables.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.