Skip to main content

ميزة “From External URL”

لتفعيل ميزة “From External URL”، يجب أن يتضمن المتغير ENABLED_LINKED_FILE_TYPES النوع url:
سيؤدي ذلك إلى توسيع كل من قائمة Add Files والقائمة المنسدلة Insert Figure في شريط الأدوات: تتيح لك قائمة Add Files إضافة ملف إلى مشروعك باستخدام عنوان URL الخاص به، بينما تتيح لك القائمة المنسدلة Insert Figure إدراج صورة في مستندك مباشرةً من عنوان URL الخاص بها.

ملاحظة أمنية

عندما يضيف المستخدمون رابطًا إلى ملف خارجي في مشاريعهم، يُجلب الملف نيابةً عن الخادم المثبَّت عليه Overleaf. إذا كان خادم Overleaf مستضافًا داخل شبكة خاصة تحتوي أيضًا على خوادم HTTP داخلية (مخصصة للاستخدام الداخلي فقط)، فقد يتمكن مستخدم لديه صلاحية الوصول إلى Overleaf من الوصول إلى بيانات هذه الخدمات الداخلية. لمنع ذلك، يجب ألا تشير الروابط إلى الملفات الخارجية إلى خوادم تنتمي عناوين IP الخاصة بها إلى أي من نطاقات الشبكة المقيّدة. وهي:
  • 127.0.0.0/8 (الاسترجاع loopback)
  • 169.254.0.0/16 (الربط المحلي link-local)
  • 10.0.0.0/8 (شبكة خاصة)
  • 172.16.0.0/12 (شبكة خاصة)
  • 192.168.0.0/16 (شبكة خاصة)
بالإضافة إلى ذلك، أُضيف متغير البيئة التالي:
  • OVERLEAF_LINKED_URL_BLOCKED_NETWORKS
    • قائمة مفصولة بمسافات بيضاء من الشبكات بصيغة CIDR يُمنع جلب الموارد الخارجية منها. عادةً، ينبغي أن تتضمن هذه القائمة الشبكة الداخلية للمؤسسة.
      • مثال: OVERLEAF_LINKED_URL_BLOCKED_NETWORKS=123.123.0.0/16 124.124.124.0/24
ومع ذلك، في كثير من المؤسسات، قد تستضيف الخوادم الموجودة داخل الشبكة الداخلية أيضًا بيانات ينبغي أن تكون متاحة للعموم. وللسماح بالوصول إلى موارد محددة حتى لو كانت الشبكة بأكملها محظورة، يتوفر متغير البيئة التالي:
  • OVERLEAF_LINKED_URL_ALLOWED_RESOURCES
    • تعبير نمطي (regular expression) يحدد موارد الويب المسموح بجلب الملفات الخارجية منها. إذا طابق عنوان URL هذا التعبير النمطي، يُمنح الوصول إليه حتى لو كانت شبكته محظورة في غير ذلك.
      • مثال: للسماح بعناوين URL مثل https://www.example.com/~john/pictures/frog.jpg وhttp://www.example.com/public/whatever/lit.bib: OVERLEAF_LINKED_URL_ALLOWED_RESOURCES=^https?://www\.example\.com/(?:~[^/]+|public)(?:/.*)?
      • مثال: لرفض عناوين URL مثل http://www.example.com/private/whatever/file، مع السماح بجميع الموارد الأخرى غير الموجودة في الشجرة الفرعية private: OVERLEAF_LINKED_URL_ALLOWED_RESOURCES=^https?://www\.example\.com/(?!private)(?:.*)

الوكيل الصادر (Outbound Proxy)

بدءًا من الإصدار v6.3.0 المُعاد إصداره (3 أكتوبر 2026)، يمكنك إعداد وكيل HTTP(S) صادر إذا كان الخادم يحتاج إليه للوصول إلى الإنترنت. ينطبق هذا أيضًا على موارد ZIP وTeX الخارجية التي تُجلب عبر Open in Overleaf API. اضبط المتغير التالي:
  • OVERLEAF_LINKED_URL_OUTBOUND_PROXY
    • عنوان URL لوكيل HTTP(S) يُستخدم لجميع طلبات الملفات الخارجية. اتركه دون تعيين للاتصال مباشرةً.
      • مثال: OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128
    • عند تعيين الوكيل، يتولى الوكيل تحليل أسماء المضيفين وليس خادم Overleaf، لذا فإن OVERLEAF_LINKED_URL_BLOCKED_NETWORKS والنطاقات المقيّدة أعلاه لا تنطبق إلا على عناوين URL التي تحتوي على عنوان IP. يجب أن يحظر الوكيل الوصول إلى شبكاتك الداخلية.
آخر تعديل في ٥ أكتوبر ٢٠٢٦