إعدادات Toolkit - Ayakaleaf Pro

تصف هذه الصفحة متغيرات البيئة المدعومة في ملف config/overleaf.rc لعمليات النشر باستخدام Toolkit. يتكون ملف config/overleaf.rc من تعريفات متغيرات بالصيغة NAME=value. تُعامَل الأسطر التي تبدأ بـ # كتعليقات.

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

الحاويات

`sharelatex`

الاسم	الوصف
`PROJECT_NAME`	يضبط قيمة الخيار `--project-name` المُمرَّر إلى `docker-compose`. يفيد ذلك عند تشغيل عدة نسخ من Overleaf على مضيف واحد، إذ يمكن أن يكون لكل نسخة اسم مشروع مختلف. - القيمة الافتراضية: `overleaf`
`OVERLEAF_IMAGE_NAME`	صورة Docker المستخدمة في حاوية تطبيق Server Pro/CE. هذا هو اسم صورة Docker فقط؛ أما وسم صورة Docker فيُؤخذ من `config/version`. - القيمة الافتراضية: - Server Pro: `ghcr.io/ayaka-notes/overleaf-pro` - Community Edition: `sharelatex/sharelatex`
`SERVER_PRO`	عند ضبطه على `true`، يوجّه Toolkit لاستخدام صورة Server Pro (`ghcr.io/ayaka-notes/overleaf-pro`) بدلًا من صورة Server CE الافتراضية (`sharelatex/sharelatex`). - القيمة الافتراضية: `false`
`GIT_BRIDGE_ENABLED`	اضبطه على `true` لتفعيل ميزة git-bridge (في Server Pro فقط). لمزيد من المعلومات راجع وثائق المستخدم https://www.overleaf.com/learn/how-to/Git_integration. - القيمة الافتراضية: `false`
`GIT_BRIDGE_IMAGE`	صورة Docker المستخدمة في حاوية git-bridge (في Server Pro فقط). هذا هو اسم صورة Docker فقط؛ أما وسم صورة Docker فيُؤخذ من `config/version`. - القيمة الافتراضية: `ghcr.io/ayaka-notes/overleaf-pro/git-bridge`
`GIT_BRIDGE_DATA_PATH`	يضبط مسار المجلد الذي سيُركَّب داخل حاوية `git-bridge` (في Server Pro فقط)، ويُستخدم لتخزين مستودعات git. يمكن أن يكون مسارًا كاملًا (يبدأ بـ `/`)، أو مسارًا نسبيًا إلى المجلد الأساسي لـ Toolkit.
`GIT_BRIDGE_LOG_LEVEL`	يكوّن مستوى التسجيل لحاوية `git-bridge`. المستويات المتاحة: `TRACE`، `DEBUG`، `INFO`، `WARN`، `ERROR`. - القيمة الافتراضية: `INFO`
`SIBLING_CONTAINERS_ENABLED`	عند ضبطه على `true`، يوجّه Toolkit لاستخدام تقنية الحاويات الشقيقة (Sibling Containers) لترجمة المشاريع في بيئات معزولة منفصلة، باستخدام حاوية Docker مستقلة لكل مشروع. راجع وثائق <server-pro-only-configuration/sandboxed-compiles> لمزيد من المعلومات. - يتطلب: `SERVER_PRO=true` - القيمة الافتراضية: `true`
`SIBLING_CONTAINERS_PULL`	عند ضبطه على `true`، يوجّه Toolkit لسحب جميع صور TeX Live المحددة باستخدام `ALL_TEX_LIVE_DOCKER_IMAGES` في ملف config/variables.env تلقائيًا عند استخدام الأمر `bin/up`. - القيمة الافتراضية: `true`
`DOCKER_SOCKET_PATH`	يضبط مسار مقبس Docker على الجهاز المضيف (الجهاز الذي يشغّل Toolkit). عندما تكون قيمة `SIBLING_CONTAINERS_ENABLED` هي `true`، سيُركَّب المقبس داخل الحاوية للسماح لخدمة الترجمة بإنشاء حاويات Docker جديدة على المضيف. - يتطلب: `SIBLING_CONTAINERS_ENABLED=true` - القيمة الافتراضية: `/var/run/docker.sock`
`OVERLEAF_DATA_PATH`	يضبط مسار المجلد الذي سيُركَّب داخل حاوية `sharelatex` الرئيسية، ويُستخدم لتخزين بيانات الترجمة. يمكن أن يكون مسارًا كاملًا (يبدأ بـ `/`)، أو مسارًا نسبيًا إلى المجلد الأساسي لـ Toolkit. - القيمة الافتراضية: `data/overleaf`
`OVERLEAF_LISTEN_IP`	يضبط عنوان (عناوين) IP للمضيف التي ستربط بها الحاوية. على سبيل المثال، إذا ضُبط على `0.0.0.0`، فستكون واجهة الويب متاحة على أي عنوان IP للمضيف. للوصول المباشر إلى الحاوية، يجب ضبط قيمة `OVERLEAF_LISTEN_IP` على عنوان IP العام الخاص بك. عادةً ما يتسبب ضبط `OVERLEAF_LISTEN_IP` على `0.0.0.0` أو على عنوان IP الخارجي للمضيف في حدوث أخطاء عند استخدامه مع . - القيمة الافتراضية: `127.0.0.1`
`OVERLEAF_PORT`	يضبط منفذ المضيف الذي ستربط به الحاوية. على سبيل المثال، إذا ضُبط على `8099` وضُبط `OVERLEAF_LISTEN_IP` على `127.0.0.1`، فستكون واجهة الويب متاحة على `http://localhost:8099`. - القيمة الافتراضية: `80`
`OVERLEAF_LOG_PATH`	يضبط مسار المجلد الذي سيُركَّب داخل حاوية `sharelatex` الرئيسية، ويُستخدم لإتاحة سجلات التطبيق على مضيف Docker. يمكن أن يكون مسارًا كاملًا (يبدأ بـ `/`)، أو مسارًا نسبيًا إلى المجلد الأساسي لـ Toolkit. احذف إدخال التكوين لتعطيل التركيب (bind-mount). عند عدم ضبطه، ستُتجاهَل السجلات عند إعادة إنشاء الحاوية. راجع للحصول على معلومات حول التسجيل. - القيمة الافتراضية: غير مضبوط

`mongo`

الاسم	الوصف
`MONGO_ENABLED`	عند ضبطه على `true`، يوجّه Toolkit لإنشاء حاوية MongoDB لاستضافة قاعدة البيانات. عند ضبطه على `false`، لن تُنشأ هذه الحاوية، وسيستخدم النظام بدلًا من ذلك قاعدة بيانات MongoDB المحددة بواسطة `MONGO_URL`. - القيمة الافتراضية: `true`
`MONGO_URL`	يحدد عنوان URL للاتصال بـ MongoDB الذي يُستخدم عندما تكون قيمة `MONGO_ENABLED` هي `false`. - القيمة الافتراضية: غير مضبوط
`MONGO_DATA_PATH`	يضبط مسار المجلد الذي سيُركَّب داخل حاوية `mongo`، ويُستخدم لتخزين قاعدة بيانات MongoDB. يمكن أن يكون مسارًا كاملًا (يبدأ بـ `/`)، أو مسارًا نسبيًا إلى المجلد الأساسي لـ toolkit. يؤثر هذا الخيار فقط على حاوية `mongo` المحلية التي تُنشأ عندما تكون قيمة `MONGO_ENABLED` هي `true`. - القيمة الافتراضية: `data/mongo`
`MONGO_IMAGE`	صورة Docker المستخدمة في حاوية MongoDB. هذا هو اسم صورة Docker فقط؛ أما وسم صورة Docker فيجب وضعه في `MONGO_VERSION` (انظر أدناه). - القيمة الافتراضية: `mongo`
`MONGO_VERSION`	إصدار MongoDB المستخدم في حاوية MongoDB. يجب أن تبدأ القيمة برقم الإصدار الرئيسي لـ MongoDB متبوعًا بنقطة، مثل `6.0` أو `6.0-with-suffix`. - القيمة الافتراضية: `6.0`

`redis`

الاسم	الوصف
`REDIS_ENABLED`	عند ضبطه على `true`، يوجّه Toolkit لإنشاء حاوية Redis لاستضافة قاعدة بيانات redis. عند ضبطه على `false`، لن تُنشأ هذه الحاوية، وسيستخدم النظام بدلًا من ذلك قاعدة بيانات Redis المحددة بواسطة `REDIS_HOST` و`REDIS_PORT`. - القيمة الافتراضية: `true`
`REDIS_HOST`	يحدد مضيف Redis الذي يُستخدم عندما تكون قيمة `REDIS_ENABLED` هي `false`. - القيمة الافتراضية: غير مضبوط
`REDIS_PORT`	يحدد منفذ Redis الذي يُستخدم عندما تكون قيمة `REDIS_ENABLED` هي `false`. - القيمة الافتراضية: غير مضبوط
`REDIS_DATA_PATH`	يضبط مسار المجلد الذي سيُركَّب داخل حاوية `redis`، ويُستخدم لتخزين قاعدة بيانات Redis. يمكن أن يكون مسارًا كاملًا (يبدأ بـ `/`)، أو مسارًا نسبيًا إلى المجلد الأساسي لـ Toolkit. يؤثر هذا الخيار فقط على حاوية `redis` المحلية التي تُنشأ عندما تكون قيمة `REDIS_ENABLED` هي `true`. - القيمة الافتراضية: `data/redis`
`REDIS_AOF_PERSISTENCE`	يفعّل استمرارية AOF (Append Only File) في Redis. هذا هو التكوين الموصى به لاستمرارية بيانات Redis. لمزيد من التفاصيل، راجع القسم <../../../maintenance/data-and-backups#aof-append-only-file> في <../../maintenance/data-and-backups>. - القيمة الافتراضية: `true`

`nginx`

الاسم	الوصف
`NGINX_ENABLED`	عند ضبطه على `true`، يوجّه Toolkit لإنشاء حاوية NGINX لتعمل كوكيل TLS. - القيمة الافتراضية: `false`
`NGINX_CONFIG_PATH`	مسار ملف تكوين NGINX المستخدم لوكيل TLS. - القيمة الافتراضية: `config/nginx/nginx.conf`
`NGINX_TLS_LISTEN_IP`	يضبط عنوان (عناوين) IP للمضيف التي ستربط بها حاوية وكيل TLS لبروتوكول HTTPS. على سبيل المثال، إذا ضُبط على `0.0.0.0` فستكون واجهة الويب عبر HTTPS متاحة على أي عنوان IP للمضيف. عادةً يجب ضبطه على عنوان IP الخارجي للمضيف. - القيمة الافتراضية: `127.0.1.1`
`NGINX_HTTP_LISTEN_IP`	يضبط عنوان (عناوين) IP للمضيف التي ستربط بها حاوية وكيل TLS لإعادة توجيه HTTP. على سبيل المثال، إذا ضُبط على `127.0.1.1` فستُعاد توجيه اتصالات HTTP إلى `127.0.1.1` نحو واجهة الويب عبر HTTPS. عادةً يجب ضبطه على عنوان IP الخارجي للمضيف. لا تضبطه على `0.0.0.0` لأن ذلك يتسبب عادةً في تعارض مع `OVERLEAF_LISTEN_IP`. - القيمة الافتراضية: `127.0.1.1`
`NGINX_HTTP_PORT`	يضبط منفذ المضيف الذي ستربط به حاوية وكيل TLS لبروتوكول HTTP. - القيمة الافتراضية: `80`
`TLS_PORT`	يضبط منفذ المضيف الذي ستربط به حاوية وكيل TLS لبروتوكول HTTPS. - القيمة الافتراضية: `443`
`TLS_PRIVATE_KEY_PATH`	مسار المفتاح الخاص المستخدم لوكيل TLS. - القيمة الافتراضية: `config/nginx/certs/overleaf_key.pem`
`TLS_CERTIFICATE_PATH`	مسار الشهادة العامة المستخدمة لوكيل TLS. - القيمة الافتراضية: `config/nginx/certs/overleaf_certificate.pem`

آخر تعديل في ٥ أكتوبر ٢٠٢٦