> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/ar/aliadadat/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_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` | مصفوفة من السلاسل النصية لتكوين امتدادات إضافية للملفات القابلة للتحرير. | | `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` |

اضبط متغير البيئة هذا على مسار على جهاز Docker المضيف الذي يشير إلى ملف تعريف 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://overleaf-pro.ayaka.space/on-premises/ar/aliadadat/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.