> ## 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.

# 5. تخصيص نسختك

### تخصيص نسختك

قبل تشغيل نسخة Overleaf الخاصة بك لأول مرة، حدّث ملفي إعداد بمعلوماتك المخصصة:

| الملف | يقرؤه | ما يُضبط فيه |
| - | - | - |
| `config/overleaf.rc` | سكربتات Toolkit، مثل `bin/up` | طريقة تشغيل الحاويات: `OVERLEAF_LISTEN_IP` و`OVERLEAF_PORT` و`SERVER_PRO` ومسارات البيانات |
| `config/variables.env` | التطبيق داخل الحاوية | سلوك Overleaf: `OVERLEAF_SITE_URL` والبريد الإلكتروني وصور TeX Live |

**1. تحرير ملف المتغيرات**

افتح `config/variables.env` في محرر النصوص المفضل لديك وحدّث متغيرات البيئة أدناه بالقيم المطلوبة.

**2. عنوان الاستماع والمنفذ**

افتراضيًا، ينشر Toolkit واجهة الويب على `127.0.0.1:80`، لذا لا يمكن فتحها إلا من متصفح على الخادم نفسه. وتحصل أجهزة الكمبيوتر الأخرى على خطأ "connection refused" أو "server not found". لتغيير ذلك، عدّل `config/overleaf.rc`:

```bash title="config/overleaf.rc" theme={null}
OVERLEAF_LISTEN_IP=0.0.0.0
OVERLEAF_PORT=8080
```

`OVERLEAF_LISTEN_IP` هو عنوان IP للمضيف الذي ترتبط به الحاوية، و`OVERLEAF_PORT` هو منفذ المضيف. ويشكّلان معًا ربط منافذ Docker بالصيغة `OVERLEAF_LISTEN_IP:OVERLEAF_PORT:80`. اختر القيم التي تناسب إعدادك:

| الإعداد | `OVERLEAF_LISTEN_IP` | `OVERLEAF_PORT` | الفتح في المتصفح |
| - | - | - | - |
| على هذا الجهاز فقط (الافتراضي) | `127.0.0.1` | `80` | `http://localhost` |
| تتصل أجهزة الكمبيوتر الأخرى على الشبكة المحلية أو الإنترنت مباشرةً | `0.0.0.0`، أو أحد عناوين IP للخادم | `80`، أو أي منفذ متاح | `http://<server-ip>:<port>` |
| خلف وكيل عكسي خاص بك (NGINX أو Caddy أو Cloudflare Tunnel) على المضيف نفسه | `127.0.0.1` | أي منفذ متاح | عنوان URL الخاص بالوكيل |
| خلف [وكيل TLS](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/tls-proxy.md) الخاص بـ Toolkit | `127.0.0.1` | `80` | `https://<your-domain>` |

إذا كان المنفذ `80` مستخدمًا بالفعل على المضيف، على سبيل المثال من قِبل خادم ويب آخر، فاضبط `OVERLEAF_PORT` على منفذ متاح مثل `8080`. وإلا فسيفشل `bin/up` مع الخطأ `bind: address already in use`.

> [!WARNING]
>
> تتجاوز المنافذ التي ينشرها Docker جدران الحماية على المضيف مثل `ufw` و`firewalld`. مع `0.0.0.0`، يمكن الوصول إلى النسخة من كل شبكة متصل بها الخادم. على الخوادم السحابية، تحتاج أيضًا إلى السماح بالمنفذ في مجموعة الأمان (security group) لدى المزوّد. استخدم HTTPS قبل كشف النسخة على الإنترنت، راجع [وكيل TLS](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/tls-proxy.md).

يمكنك البدء بالإعداد الافتراضي وفتح النسخة على `localhost` أولًا. وللسماح بالوصول من أجهزة كمبيوتر أخرى لاحقًا، غيّر هذين المتغيرين في `config/overleaf.rc` و`OVERLEAF_SITE_URL` في `config/variables.env`، ثم شغّل `bin/up` مجددًا لإعادة إنشاء الحاويات.

**3. متغيرات البيئة المطلوبة**

حدّث المتغيرات التالية في `config/variables.env`:

| الاسم | الوصف | مثال |
| - | - | - |
| `OVERLEAF_SITE_URL` | العنوان الذي تتوفر عليه نسخة Overleaf الخاصة بك للعامة. يُستخدم هذا في الروابط العامة وعند الاتصال عبر websockets، لذا **يجب إعداده بشكل صحيح**! | `https://overleaf.lilliput.com` |
| `OVERLEAF_EMAIL_FROM_ADDRESS` | سيُستخدم عنوان البريد الإلكتروني هذا كعنوان المرسل `from` لجميع رسائل البريد الإلكتروني الصادرة. | `no-reply@lilliput.com` |
| `OVERLEAF_ADMIN_EMAIL` | عنوان البريد الإلكتروني الذي يمكن للمستخدمين من خلاله التواصل مع الشخص المسؤول عن تشغيل الموقع. | `it-services@lilliput.com` |

`OVERLEAF_SITE_URL` هو العنوان الذي يكتبه المستخدمون في متصفحهم، وليس عنوان الاستماع. أدرج المنفذ عندما لا يكون `80` (HTTP) أو `443` (HTTPS)، على سبيل المثال `http://192.168.1.20:8080`. لا تستخدم `http://0.0.0.0`. إذا لم يتطابق `OVERLEAF_SITE_URL` مع العنوان في المتصفح، يفشل المحرر في الاتصال، وتشير الروابط في رسائل البريد الإلكتروني وعناوين استدعاء OAuth إلى المكان الخطأ.

في حال عدم وجود خادم بريد، اترك `OVERLEAF_EMAIL_FROM_ADDRESS` دون تعيين: عندها لا يرسل Overleaf أي رسائل بريد إلكتروني، ويمكنك أن تعطي المستخدمين الجدد رابط التفعيل بنفسك، راجع قسم الأسئلة والأجوبة في [الوصول العام](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/authentication/public-access.md).

اضبط أيضًا `OVERLEAF_SESSION_SECRET` على قيمة مولَّدة باستخدام `openssl rand -hex 32`. بدونه، يؤدي كل تشغيل لـ `bin/up` يعيد إنشاء الحاوية، وكل ترقية، إلى تسجيل خروج جميع المستخدمين. راجع قسم الأسئلة والأجوبة في [متغيرات البيئة](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/environment-variables.md).

بعد تحديث متغيرات البيئة هذه، احفظ الملف واخرج.

**4. إعداد Sandbox Compile**

بعد ذلك، قم بإعداد TeX Live Full من أجل [sandboxed-compiles.md](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/sandboxed-compiles.md "mention"). افتح `config/variables.env` وحدّث متغيرات البيئة التالية:

```dotenv title="config/variables.env" wrap theme={null}
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
```

**5. تشغيل نسختك**

لتشغيل نسختك، نفّذ:

```text title="Start the instance" theme={null}
bin/up
```

سيقوم هذا الأمر بتنزيل الصور المطلوبة بما فيها texlive، وإنشاء الحاويات (باستخدام تخصيصاتك)، وتشغيل النسخة. ويُفترض أن ترى مخرجات السجلات من حاويات Docker المختلفة.

لتشغيلها مرة أخرى لاحقًا (دون الارتباط بمخرجات السجلات)، نفّذ:

```text title="Start without attaching to logs" theme={null}
bin/start
```

> [!NOTE]
>
> تستخدم Toolkit الأمر `docker compose` لإدارة حاويات Overleaf في Docker. وتوفر Toolkit مجموعة من السكربتات التي تغلّف `docker compose` وتتولى معظم التفاصيل نيابةً عنك.

إذا سار كل شيء على ما يرام، فيُفترض أن تتمكن من عرض صفحة تسجيل الدخول لنسخة Overleaf الجديدة بالانتقال إلى [http://127.0.0.1/](http://127.0.0.1/) أو [http://localhost/](http://localhost/) في متصفحك. إذا غيّرت `OVERLEAF_LISTEN_IP` أو `OVERLEAF_PORT`، فافتح العنوان المذكور في الجدول ضمن خطوة **عنوان الاستماع والمنفذ** بدلًا من ذلك، على سبيل المثال `http://<server-ip>:8080`.

للتحقق من العنوان والمنفذ اللذين نُشرت عليهما واجهة الويب، شغّل:

```text title="Show the published port" theme={null}
bin/docker-compose port sharelatex 80
```

تُظهر المخرجات، مثل `0.0.0.0:8080`، عنوان IP للمضيف والمنفذ المستخدمين. إذا أظهرت `127.0.0.1`، فلا يمكن الوصول إلى النسخة إلا من الخادم نفسه.

> [!WARNING]
>
> بحسب إعدادات شبكتك ومكان استضافة نسخة Overleaf، قد تحتاج إلى إجراء تغييرات إضافية على الإعدادات. راجع إعدادات Toolkit لمزيد من التفاصيل: [toolkit-settings.md](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/toolkit-settings.md "mention")


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