اضبط مؤقت الخمول في Collabora لعرض المستندات النشطة

لتغيير مدة بقاء عرض Collabora مفتوحًا غير نشط قبل أن يخفت ويتوقف عن تلقي التحديثات، اضبط الإعدادات per_view.idle_timeout_secs. يضبط القالب الحالي coolwsd.xmlهذا المؤقت على مستوى العرض على 900 ثانية (15 دقيقة)؛ على سبيل المثال، اضبطه على 1800 ثانية لمدة 30 دقيقة. هذا ليس مؤقت تسجيل الخروج أو مهلة إلغاء تحميل المستند غير النشط.

اعرف أي مؤقت تقوم بتغييره

العرض هو عرض المتصفح المفتوح لمستند ما من قِبل مستخدم واحد. في خادمcoolwsd الويب الذي يُشغّل Collabora Online، يُحدد هذا per_viewالإعداد idle_timeout_secsعدد الثواني التي تسبق تعتيم عرض المستخدم غير النشط وتوقف التحديثات، حتى مع بقاء علامة تبويب المتصفح مُفعّلة. يُحدد القالب الأصلي حاليًا قيمة افتراضية تبلغ 900 ثانية. قد تُغيّر حزمتك أو خدمتك المُدارة هذه القيمة، لذا يُرجى التحقق من الإعدادات المُستخدمة فعليًا في نظامك.

الإعدادما يصبح خاملاًالقالب الافتراضي الحالي للمنبع
per_view.idle_timeout_secsنشاط المستخدم في عرض مُركّز900 ثانية (15 دقيقة)
per_view.out_of_focus_timeout_secsعرض المتصفح بعد فقدان علامة التبويب الخاصة به للتركيز300 ثانية (5 دقائق)
per_document.idle_timeout_secsمستند بدون أي طرق عرض نشطة قبل التفريغ3600 ثانية (ساعة واحدة)

استخدم الإعداد الأول عندما يرغب المستخدمون في إبقاء نافذة التحرير النشطة مفتوحة لفترة أطول أثناء القراءة أو الإيقاف المؤقت. استخدم الإعداد الثاني فقط إذا خفتت علامات التبويب الخلفية بسرعة كبيرة. أما الإعداد الثالث فهو خاص بالتنظيف من جانب الخادم بعد انتهاء عرض المستند؛ تغييره لا يؤثر على سلوك عدم النشاط للنافذة التي تبقى مفتوحة. تتحكم إعدادات الحفظ التلقائي والحفظ أثناء الخمول في وقت حفظ المحتوى المُعدَّل، وليس في مدة بقاء النافذة نشطة.

محرر XML توضيحي يعرض per_view مع ضبط out_of_focus_timeout_secs على 300 و idle_timeout_secs على 900.
يتعامل المؤقتان لكل عرض مع أنواع مختلفة من عدم النشاط: علامة تبويب غير مركزة ومستخدم غير نشط في علامة تبويب مركزة.

اختر مهلة زمنية وقم بإعداد التكوين

اختر مدة زمنية تناسب سير عملك، ثم حوّلها إلى ثوانٍ: 20 دقيقة تساوي 1200، و30 دقيقة تساوي 1800، و45 دقيقة تساوي 2700. يستخدم المثال أدناه 30 دقيقة؛ وهو مجرد مثال، وليس توصية عامة. القيم الأطول تُبقي العروض الخاملة نشطة لفترة أطول، وقد تُبقي عمليات المستندات وتحديثاتها نشطة لفترة أطول أيضًا.

قبل التعديل، حدد طريقة تثبيت Collabora. قد يعرض كل من Docker CODE، وحزمة Linux، ونشر Helm، ومزود الاستضافة، الإعدادات بطرق مختلفة. لذا، أنشئ نسخة احتياطية من الإعدادات الحالية أو احفظ نسخة من ملف Compose. إذا كانت إحدى التكاملات تدير الخادم نيابةً عنك، فاستخدم آلية الإعدادات المدعومة من قِبلها بدلاً من تعديل نظام الملفات المؤقت للحاوية.

اضبط مهلة الخمول لكل عرض

كود Docker باستخدام Compose

أضف الخيار إلى extra_paramsالقيمة الحالية لخدمة Collabora:

services:
  collabora:
    environment:
      extra_params: "--o:per_view.idle_timeout_secs=1800"

إذا كانت extra_paramsالخيارات موجودة بالفعل، فأضف هذا الخيار إلى القيمة نفسها بدلاً من تعريف المفتاح مرتين. احتفظ بإعدادات SSL والوكيل والمضيف الحالية. تمرر صورة Docker --o:الخيارات إلى coolwsd; يشرح التوثيق الرسمي لـ CODE Docker طريقة التكوين هذه.

محرر XML توضيحي يُظهر قيمة per_view idle_timeout_secs التي تغيرت من 900 إلى 1800 بينما تظل قيمة out_of_focus_timeout_secs عند 300.
للحصول على عتبة خمول لعرض التركيز لمدة 30 دقيقة، قم بتغيير قيمة العرض لكل عرض إلى 1800 ثانية واترك مؤقت التركيز على علامة التبويب المنفصل دون تغيير.

حزمة لينكس أو تكوين XML مثبت

عدّل الملف النشط coolwsd.xmlوغيّر القيمة داخل <per_view>القسم الموجود فيه. احتفظ بالإعدادات المحيطة وأي خصائص في ملفك.

<per_view>
  <out_of_focus_timeout_secs>300</out_of_focus_timeout_secs>
  <idle_timeout_secs>1800</idle_timeout_secs>
</per_view>

لا تقم بلصق <per_view>كتلة ثانية أو تعديل قالب المصدر coolwsd.xml.inكما لو كان التكوين قيد التشغيل. قد يختلف مسار الملف الصحيح ومالك التكوين باختلاف الحزمة والنشر.

محرر YAML التوضيحي لـ Docker Compose يُظهر تعيين extra_params إلى --o:per_view.idle_timeout_secs=1800 ضمن بيئة خدمة collabora.
يقوم مثال CODE Docker بتمرير قيمة العرض لكل خدمة من خلال إعداد extra_params الحالي للخدمة.

قم بتطبيق الإعداد عن طريق إعادة تشغيل خدمة Collabora أو إعادة إنشائها. بالنسبة لخدمة Compose نموذجية تحمل الاسم collabora، قم بتشغيل الأمر التالي:

docker compose up -d --force-recreate collabora

استبدل اسم الخدمة بالاسم الموجود في ملف Compose الخاص بك. في حالة تثبيت حزمة مُدارة بواسطة systemd، أعد تشغيل الخدمة بعد تعديل إعداداتها النشطة، على سبيل المثال sudo systemctl restart coolwsd. أعد فتح المستند في علامة تبويب جديدة في المتصفح حتى يستخدم الاختبار عرضًا جديدًا.

تحقق من السلوك وقم باستكشاف الأخطاء وإصلاحها.

  1. افتح مستند اختبار منخفض المخاطر في علامة تبويب متصفح مركزة ولاحظ الوقت. تجنب استخدام نسخة معدلة من الإنتاج غير محفوظة كاختبار مهلة زمنية.
  2. اترك العرض دون تغيير للفترة الزمنية المحددة. بعد مرور 1800 ثانية، تحقق مما إذا كان العرض يخفت ويتوقف عن تلقي التحديثات وفقًا لإعدادات العرض. لا تفسر هذه الحالة المرئية على أنها دليل على تسجيل خروج المستخدم أو إلغاء تحميل المستند.
  3. ارجع إلى المستند وتأكد من أن السلوك مقبول في بيئة النشر الخاصة بك. ثم اختبر حالة علامة التبويب الخلفية المنفصلة عن طريق التبديل إلى صفحة أخرى لفترة أطول من out_of_focus_timeout_secs، إذا كان ذلك مهمًا لسير العمل.

بعد إعادة التشغيل، تسجل بعض الإصدارات قائمة بقيم التكوين غير الافتراضية. إذا أظهر سجل بدء التشغيل ذلك، فابحث عن per_view.idle_timeout_secs: 1800. إذا استمر السلوك مطابقًا للقيمة القديمة، فتأكد من تعديل الملف أو خدمة Compose المستخدمة من قِبل العملية قيد التشغيل، ومن تطبيق التغيير، ومن عدم وجود خيار بيئي أو خيار سطر أوامر يتجاوز ملف XML.

مستند توضيحي للمتصفح وملاحظة توضح عملية التحقق المتوقعة من وضع الخمول لمدة 30 دقيقة.
استخدم عرض اختبار جديد وانتظر الفترة الزمنية المحددة؛ توضح هذه اللوحة عملية الفحص، وليس نتيجة تم قياسها.

إذا اختفى المستند بعد فترة طويلة دون فتحه، per_document.idle_timeout_secsفقم بمراجعته. إذا كان المستخدمون يُسجّلون الخروج، فتحقق من سياسة المصادقة أو الجلسة الخاصة بالمنصة المضيفة. هذه طبقات مختلفة ولا تخضع لسيطرة النظام per_view.idle_timeout_secs. لا تُقلّل مدة اختفاء المستند لمجرد تسريع عملية التعتيم.

للاطلاع على أسماء الإعدادات الحالية والإعدادات الافتراضية، راجع قالب تكوين Collabora Online . أما بالنسبة لطريقة Docker extra_params، فراجع وثائق صورة CODE Docker . تحقق من السلوك الدقيق مقارنةً بالإصدار والحزمة التي تستخدمها، لأن الإعدادات الافتراضية وطريقة تسليم التكوين قد تختلف.

اترك تعليقاً

اضبط مؤقت الخمول في Collabora لعرض المستندات النشطة

اضبط مؤقت الخمول في Collabora لعرض المستندات النشطة

قم بضبط عتبة عدم النشاط لكل عرض في coolwsd وميزها عن تعتيم علامات التبويب الخلفية، وإلغاء تحميل المستندات، والحفظ التلقائي، وانتهاء صلاحية تسجيل الدخول.

تعطيل عمليات التحقق من تحديثات كود Collabora والاتصالات غير المرغوب فيها

تعطيل عمليات التحقق من تحديثات كود Collabora والاتصالات غير المرغوب فيها

أوقف عمليات التحقق المجدولة لتحديثات التعليمات البرمجية، وراجع الخدمات البعيدة الاختيارية، واستخدم عناصر التحكم في الشبكة الصادرة دون تعطيل تحرير المستندات.

قم بربط Seafile و Collabora باستخدام عنوان URL الصحيح لـ WOPI

قم بربط Seafile و Collabora باستخدام عنوان URL الصحيح لـ WOPI

قم بتمكين تحرير المستندات بشكل آمن في Seafile عن طريق تكوين عنوان URL لاكتشاف Collabora و HTTPS والوصول إلى WOPI لنشرك.

استعادة النسخ واللصق بين تطبيقات Collabora وتطبيقات سطح المكتب

استعادة النسخ واللصق بين تطبيقات Collabora وتطبيقات سطح المكتب

اختبر حافظة النظام، واضبط أذونات المتصفح، وحدد متى يحتاج تكامل Collabora المضمن إلى تغيير سياسة iframe.

توفير خطوط مخصصة في Collabora CODE Docker

توفير خطوط مخصصة في Collabora CODE Docker

قم بتثبيت ملفات الخطوط في Docker ولوحة نظام Collabora بحيث تظهر الخطوط المخصصة في المحرر ويتم عرضها بشكل صحيح في المستندات.

استعادة إعدادات Collabora CODE دون فقدان تغييرات النشر

استعادة إعدادات Collabora CODE دون فقدان تغييرات النشر

قم بعمل نسخة احتياطية من ملف coolwsd.xml ومصادر النشر الخاصة به، واستعدها بأمان، وتحقق من الكود قبل أن يعود المستخدمون إلى التحرير.

قم بإصلاح فحص مضيف WOPI الخاص بـ CODE عن طريق مطابقة أصل المضيف

قم بإصلاح فحص مضيف WOPI الخاص بـ CODE عن طريق مطابقة أصل المضيف

قم بالسماح بمصدر Nextcloud المحدد أو مصدر WOPI آخر في CODE، ثم تحقق من قائمة السماح للمضيف النشط وقم بتمييزها عن تقييد عنوان IP المصدر الخاص بـ Nextcloud.

حل مشكلة "حسنًا، هذا محرج" في Collabora

حل مشكلة "حسنًا، هذا محرج" في Collabora

قم بتتبع اتصالات متصفح Collabora و WOPI و WebSocket لمعرفة سبب عدم فتح المستند، ثم قم بتطبيق الإصلاح الذي يتوافق مع إعداد Nextcloud الخاص بك.

تشغيل Collabora عبر الإنترنت على عقد Kubernetes

تشغيل Collabora عبر الإنترنت على عقد Kubernetes

قم بنشر نسخ Collabora CODE باستخدام Helm، واحتفظ بكل مستند على وحدة واحدة من خلال تقارب WOPI، وتحقق من الدخول، ووضع العقدة، وتحرير Nextcloud.

استعادة اتصال WebSocket الخاص بـ Collabora عبر الوكيل

استعادة اتصال WebSocket الخاص بـ Collabora عبر الوكيل

تتبع عملية المصافحة الفاشلة من المتصفح إلى coolwsd، ثم قم بمطابقة مسار الوكيل العكسي مع إصدار Collabora الخاص بك، بما في ذلك تغيير Apache CODE 26.04.