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:

   config/overleaf.rc

   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 الخاص بـ Toolkit	127.0.0.1	80	https://<your-domain>

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

   تتجاوز المنافذ التي ينشرها Docker جدران الحماية على المضيف مثل ufw وfirewalld. مع 0.0.0.0، يمكن الوصول إلى النسخة من كل شبكة متصل بها الخادم. على الخوادم السحابية، تحتاج أيضًا إلى السماح بالمنفذ في مجموعة الأمان (security group) لدى المزوّد. استخدم HTTPS قبل كشف النسخة على الإنترنت، راجع وكيل TLS.

   يمكنك البدء بالإعداد الافتراضي وفتح النسخة على 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 لجميع رسائل البريد الإلكتروني الصادرة.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	عنوان البريد الإلكتروني الذي يمكن للمستخدمين من خلاله التواصل مع الشخص المسؤول عن تشغيل الموقع.	[e-mail]

   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 أي رسائل بريد إلكتروني، ويمكنك أن تعطي المستخدمين الجدد رابط التفعيل بنفسك، راجع قسم الأسئلة والأجوبة في الوصول العام.

   اضبط أيضًا OVERLEAF_SESSION_SECRET على قيمة مولَّدة باستخدام openssl rand -hex 32. بدونه، يؤدي كل تشغيل لـ bin/up يعيد إنشاء الحاوية، وكل ترقية، إلى تسجيل خروج جميع المستخدمين. راجع قسم الأسئلة والأجوبة في متغيرات البيئة.

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

4. إعداد Sandbox Compile

   بعد ذلك، قم بإعداد TeX Live Full من أجل sandboxed-compiles.md. افتح config/variables.env وحدّث متغيرات البيئة التالية:

   config/variables.env

   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. تشغيل نسختك

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

   Start the instance

   bin/up
   

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

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

   Start without attaching to logs

   bin/start
   

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

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

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

Show the published port

bin/docker-compose port sharelatex 80

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

بحسب إعدادات شبكتك ومكان استضافة نسخة Overleaf، قد تحتاج إلى إجراء تغييرات إضافية على الإعدادات. راجع إعدادات Toolkit لمزيد من التفاصيل: toolkit-settings.md