اضبط مؤقت الخمول في Collabora لعرض المستندات النشطة
قم بضبط عتبة عدم النشاط لكل عرض في coolwsd وميزها عن تعتيم علامات التبويب الخلفية، وإلغاء تحميل المستندات، والحفظ التلقائي، وانتهاء صلاحية تسجيل الدخول.
لتغيير مدة بقاء عرض 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 ثانية (ساعة واحدة) |
استخدم الإعداد الأول عندما يرغب المستخدمون في إبقاء نافذة التحرير النشطة مفتوحة لفترة أطول أثناء القراءة أو الإيقاف المؤقت. استخدم الإعداد الثاني فقط إذا خفتت علامات التبويب الخلفية بسرعة كبيرة. أما الإعداد الثالث فهو خاص بالتنظيف من جانب الخادم بعد انتهاء عرض المستند؛ تغييره لا يؤثر على سلوك عدم النشاط للنافذة التي تبقى مفتوحة. تتحكم إعدادات الحفظ التلقائي والحفظ أثناء الخمول في وقت حفظ المحتوى المُعدَّل، وليس في مدة بقاء النافذة نشطة.

اختر مدة زمنية تناسب سير عملك، ثم حوّلها إلى ثوانٍ: 20 دقيقة تساوي 1200، و30 دقيقة تساوي 1800، و45 دقيقة تساوي 2700. يستخدم المثال أدناه 30 دقيقة؛ وهو مجرد مثال، وليس توصية عامة. القيم الأطول تُبقي العروض الخاملة نشطة لفترة أطول، وقد تُبقي عمليات المستندات وتحديثاتها نشطة لفترة أطول أيضًا.
قبل التعديل، حدد طريقة تثبيت Collabora. قد يعرض كل من Docker CODE، وحزمة Linux، ونشر Helm، ومزود الاستضافة، الإعدادات بطرق مختلفة. لذا، أنشئ نسخة احتياطية من الإعدادات الحالية أو احفظ نسخة من ملف Compose. إذا كانت إحدى التكاملات تدير الخادم نيابةً عنك، فاستخدم آلية الإعدادات المدعومة من قِبلها بدلاً من تعديل نظام الملفات المؤقت للحاوية.
أضف الخيار إلى extra_paramsالقيمة الحالية لخدمة Collabora:
services:
collabora:
environment:
extra_params: "--o:per_view.idle_timeout_secs=1800"إذا كانت extra_paramsالخيارات موجودة بالفعل، فأضف هذا الخيار إلى القيمة نفسها بدلاً من تعريف المفتاح مرتين. احتفظ بإعدادات SSL والوكيل والمضيف الحالية. تمرر صورة Docker --o:الخيارات إلى coolwsd; يشرح التوثيق الرسمي لـ CODE Docker طريقة التكوين هذه.

عدّل الملف النشط 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كما لو كان التكوين قيد التشغيل. قد يختلف مسار الملف الصحيح ومالك التكوين باختلاف الحزمة والنشر.

قم بتطبيق الإعداد عن طريق إعادة تشغيل خدمة Collabora أو إعادة إنشائها. بالنسبة لخدمة Compose نموذجية تحمل الاسم collabora، قم بتشغيل الأمر التالي:
docker compose up -d --force-recreate collaboraاستبدل اسم الخدمة بالاسم الموجود في ملف Compose الخاص بك. في حالة تثبيت حزمة مُدارة بواسطة systemd، أعد تشغيل الخدمة بعد تعديل إعداداتها النشطة، على سبيل المثال sudo systemctl restart coolwsd. أعد فتح المستند في علامة تبويب جديدة في المتصفح حتى يستخدم الاختبار عرضًا جديدًا.
out_of_focus_timeout_secs، إذا كان ذلك مهمًا لسير العمل.بعد إعادة التشغيل، تسجل بعض الإصدارات قائمة بقيم التكوين غير الافتراضية. إذا أظهر سجل بدء التشغيل ذلك، فابحث عن per_view.idle_timeout_secs: 1800. إذا استمر السلوك مطابقًا للقيمة القديمة، فتأكد من تعديل الملف أو خدمة Compose المستخدمة من قِبل العملية قيد التشغيل، ومن تطبيق التغيير، ومن عدم وجود خيار بيئي أو خيار سطر أوامر يتجاوز ملف XML.

إذا اختفى المستند بعد فترة طويلة دون فتحه، per_document.idle_timeout_secsفقم بمراجعته. إذا كان المستخدمون يُسجّلون الخروج، فتحقق من سياسة المصادقة أو الجلسة الخاصة بالمنصة المضيفة. هذه طبقات مختلفة ولا تخضع لسيطرة النظام per_view.idle_timeout_secs. لا تُقلّل مدة اختفاء المستند لمجرد تسريع عملية التعتيم.
للاطلاع على أسماء الإعدادات الحالية والإعدادات الافتراضية، راجع قالب تكوين Collabora Online . أما بالنسبة لطريقة Docker extra_params، فراجع وثائق صورة CODE Docker . تحقق من السلوك الدقيق مقارنةً بالإصدار والحزمة التي تستخدمها، لأن الإعدادات الافتراضية وطريقة تسليم التكوين قد تختلف.
قم بضبط عتبة عدم النشاط لكل عرض في coolwsd وميزها عن تعتيم علامات التبويب الخلفية، وإلغاء تحميل المستندات، والحفظ التلقائي، وانتهاء صلاحية تسجيل الدخول.
أوقف عمليات التحقق المجدولة لتحديثات التعليمات البرمجية، وراجع الخدمات البعيدة الاختيارية، واستخدم عناصر التحكم في الشبكة الصادرة دون تعطيل تحرير المستندات.
قم بتمكين تحرير المستندات بشكل آمن في Seafile عن طريق تكوين عنوان URL لاكتشاف Collabora و HTTPS والوصول إلى WOPI لنشرك.
اختبر حافظة النظام، واضبط أذونات المتصفح، وحدد متى يحتاج تكامل Collabora المضمن إلى تغيير سياسة iframe.
قم بتثبيت ملفات الخطوط في Docker ولوحة نظام Collabora بحيث تظهر الخطوط المخصصة في المحرر ويتم عرضها بشكل صحيح في المستندات.
قم بعمل نسخة احتياطية من ملف coolwsd.xml ومصادر النشر الخاصة به، واستعدها بأمان، وتحقق من الكود قبل أن يعود المستخدمون إلى التحرير.
قم بالسماح بمصدر Nextcloud المحدد أو مصدر WOPI آخر في CODE، ثم تحقق من قائمة السماح للمضيف النشط وقم بتمييزها عن تقييد عنوان IP المصدر الخاص بـ Nextcloud.
قم بتتبع اتصالات متصفح Collabora و WOPI و WebSocket لمعرفة سبب عدم فتح المستند، ثم قم بتطبيق الإصلاح الذي يتوافق مع إعداد Nextcloud الخاص بك.
قم بنشر نسخ Collabora CODE باستخدام Helm، واحتفظ بكل مستند على وحدة واحدة من خلال تقارب WOPI، وتحقق من الدخول، ووضع العقدة، وتحرير Nextcloud.
تتبع عملية المصافحة الفاشلة من المتصفح إلى coolwsd، ثم قم بمطابقة مسار الوكيل العكسي مع إصدار Collabora الخاص بك، بما في ذلك تغيير Apache CODE 26.04.