عندما يستهلك Collabora Online فجأةً معظم موارد المعالج في الخادم، فإن أهم خطوة أولى هي عدم إعادة تشغيله بشكل متكرر أو فرض حد منخفض جدًا على موارد المعالج فورًا. يجب أولًا تحديد ما إذا كان الحمل ناتجًا عن عمل عادي على المستندات، أو جلسة معالجة مستندات واحدة غير طبيعية، أو كثرة العمليات المتوازية، أو جلسة خاملة لا يتم تنظيفها، أو خلل خاص بالإصدار. قد يختلف اسم العملية coolwsdفي الإصدارات الحالية loolwsdوالإصدارات القديمة.
سيناريو توضيحي: تخيل خادمًا بثمانية معالجات افتراضية (vCPU) يعمل عليه Collabora Online خلف Nextcloud. يبدو أن عددًا قليلًا من المستخدمين يقومون بتحرير المستندات، لكن حاوية Collabora تستهلك ما بين 250% و350% من موارد المعالج لعدة دقائق. هذا مثال افتراضي يُستخدم في هذا الدليل، وليس قياسًا معياريًا أو تقريرًا من بيئة تشغيل حقيقية.
اعتبارًا من أكتوبر 2026، كان الإصدار المستقر الحالي من Collabora هو 26.04، وتشير ملاحظات الإصدار الرسمية إلى أن Collabora Online 26.04.3.3 قد صدر في 14 سبتمبر 2026. وتستخدم قوالب التكوين الحالية هذا coolwsdالاسم. لا تزال أدوات ترحيل Collabora توثق /etc/loolwsd/loolwsd.xmlالمسار الأقدم لعمليات التثبيت من الإصدار 6.4 أو ما قبله، ولهذا السبب قد يواجه المسؤولون كلا الاسمين.
ابدأ من مستوى نظام التشغيل أو الحاوية. coolwsdلا يعني الرقم المرتفع بجانبه بالضرورة أن البرنامج الخفي المنسق يقوم بكل عمليات معالجة المستندات المكلفة. يُشغّل Collabora أيضًا عمليات kit/forkit لجلسات المستندات، لذا ستحتاج إلى شجرة العمليات واستخدام وحدة المعالجة المركزية لكل عملية قبل تغيير الإعدادات.
ps -eo pid,ppid,pcpu,pmem,etime,cmd --sort=-pcpu | head -n 25
top -H -p $(pgrep -d, -f 'coolwsd|loolwsd|coolkit|loolkit|forkit')بالنسبة لـ Docker، تحقق أيضًا من الحاوية ككل:
docker stats --no-stream
في السيناريو التوضيحي، لنفترض أن الحاوية تستهلك ما يقارب 300% من وحدة المعالجة المركزية، وأن عملية واحدة من عمليات مجموعة الأدوات تتصدر قائمة العمليات باستمرار. هذا يشير إلى جلسة مستند نشطة محددة، وليس إلى افتراض عام بأن الخادم بأكمله مُثقل.
يُتيح Collabora Online الوصول إلى مقاييس متوافقة مع Prometheus /cool/getMetrics. ويشير دليل SDK الحالي إلى أن هذه النقطة الطرفية قادرة على الإبلاغ عن استخدام وحدة المعالجة المركزية والذاكرة، وعمليات Kit قيد التشغيل، والعروض، وبيانات استخدام الخادم الأخرى. وتستخدم نفس آلية المصادقة المستخدمة في لوحة تحكم المسؤول، ما لم يتم تكوين المقاييس صراحةً للسماح بالوصول غير المصادق عليه.
لا تُعرّض نقطة نهاية المقاييس للعموم لمجرد تبسيط عملية استكشاف الأخطاء وإصلاحها. يتضمن تكوين Helm الرسمي أمثلةً لحظر /cool/getMetricsعناوين URL الإدارية عند نقطة الدخول. استخدم مسارًا داخليًا موثقًا كلما أمكن ذلك.
ابحث عن علاقة بين استخدام وحدة المعالجة المركزية (CPU) والمستندات أو طرق العرض النشطة. إذا ارتفع استخدام وحدة المعالجة المركزية وانخفض مع عمليات التحرير المشروعة، فقد يكون لديك مشكلة في السعة أو التزامن. أما إذا ظل استخدام وحدة المعالجة المركزية مرتفعًا دون وجود أي عمل تفاعلي، فابحث عن الجلسات القديمة، أو مستند به مشكلة، أو عمليات متكررة في الخلفية، أو مشكلة في البرنامج.
لتثبيت حزمة مُدارة بواسطة systemd:
journalctl -u coolwsd --since "15 minutes ago" --no-pager
journalctl -u coolwsd -fبالنسبة لـ Docker:
docker logs collabora --since 15m
docker logs -f collaboraإذا كان لخدمتك أو حاويتك اسم مختلف، فاستبدله. ابحث عن عمليات تحميل المستندات المتكررة، أو إنشاء مجموعات الأدوات المتكررة، أو عمليات الحفظ الفاشلة، أو الأعطال، أو حلقات إعادة الاتصال، أو ظهور مفتاح المستند نفسه مرارًا وتكرارًا. قد يكون ارتفاع استهلاك وحدة المعالجة المركزية لفترة وجيزة أثناء فتح المستند أو إعادة حسابه أو عرضه أو تحويله أو تصديره أمرًا طبيعيًا. أما علامة التحذير الأقوى فهي استمرار ارتفاع استهلاك وحدة المعالجة المركزية دون إحراز أي تقدم مفيد أو تكرار نفس الخطأ.
ارجع إلى الخادم الافتراضي. إذا كانت إحدى عمليات مجموعة الأدوات تستهلك موارد كثيرة، فأغلق المستند المشتبه به أو اعزله، وراقب ما إذا كان استهلاك وحدة المعالجة المركزية ينخفض. ثم افتح الملف نفسه خلال فترة هدوء مع مراقبة قائمة العمليات ومؤشرات الأداء. كرر العملية مع مستند اختبار بسيط.
تُعد هذه المقارنة أكثر فائدة من إعادة تشغيل الخدمة بأكملها على الفور:
تُحدد وثائق نموذج تكوين Collabora الحالي per_document.max_concurrencyالحد الأقصى لعدد الخيوط المستخدمة أثناء معالجة المستند. القيمة الافتراضية للنموذج هي 4. على جهاز ذي سعة تخزينية محدودة، أو عندما يستحوذ مستند واحد معقد على معظم موارد الجهاز، فإن تقليل هذه القيمة يُحسّن من إمكانية التنبؤ باستخدام وحدة المعالجة المركزية.
على سبيل المثال، يمكنك اختبار قيمة 2:
<per_document>
<max_concurrency>2</max_concurrency>
</per_document>
لا تقم بنسخ الرقم 2 بشكل أعمى. إذا كان المستخدمون يتعاملون بشكل روتيني مع جداول بيانات أو عروض تقديمية كبيرة، وكان الخادم مزودًا بعدد كافٍ من النوى، فقد يؤدي استخدام قيمة أقل إلى إبطاء العمل. غيّر إعدادًا واحدًا، وأعد إنتاج نفس عبء العمل، وقارن بين استخدام وحدة المعالجة المركزية، وسرعة الاستجابة، ووقت الإنجاز.
يتضمن القالب الحالي coolwsd.xmlمنطقًا لتنظيف المستندات الخاملة التي تستهلك موارد النظام. عند كتابة هذا التقرير، يُظهر القالب فاصلًا زمنيًا لفحص التنظيف يبلغ 10000 مللي ثانية، وفترة سلوك غير طبيعي مدتها 60 ثانية، وعتبة خمول مدتها 300 ثانية، وعتبة استخدام وحدة المعالجة المركزية بنسبة 85% ليصبح المستند مرشحًا للتنظيف. كما يتضمن مهلة خمول لكل مستند تبلغ 3600 ثانية.
يتضمن القالب نفسه مهلات زمنية لكل عرض. تُظهر القيم الحالية 300 ثانية قبل أن يتم تعتيم عرض المتصفح غير النشط وإيقاف التحديثات، و900 ثانية قبل التعامل مع العرض غير النشط بنفس الطريقة. لا تُعادل هذه المهلات الزمنية للعرض إلغاء تحميل جلسة المستند بالكامل فورًا.
تجنب خفض عتبة وحدة المعالجة المركزية إلى مستوى منخفض للغاية لمجرد تحسين مظهر الرسم البياني. تهدف عملية التنظيف إلى رصد المستندات التالفة أو الخاملة التي تستهلك موارد النظام، وليس إلى إنهاء عمليات التحرير النشطة العادية كلما أصبحت مكلفة حسابيًا.
قم بعمل نسخة احتياطية من الإعدادات النشطة أولاً. عادةً ما تستخدم عمليات تثبيت الحزم ملفات التكوين /etc/coolwsd/coolwsd.xml. قد تُمرر عمليات نشر Docker خيارات كمتغيرات بيئية أو كتجاوزات في سطر الأوامر، أو قد تقوم بتحميل ملف تكوين داخل الحاوية. تأكد من المصدر النشط فعليًا قبل إجراء أي تعديلات.
لتثبيت الحزمة:
sudo cp /etc/coolwsd/coolwsd.xml /etc/coolwsd/coolwsd.xml.before-cpu-tuning
sudo systemctl restart coolwsd
systemctl status coolwsd --no-pagerبالنسبة لحاوية Docker:
docker restart collabora
docker ps --filter name=collabora
إذا أدى إعادة التشغيل وحدها إلى إصلاح وحدة المعالجة المركزية مؤقتًا، ولكن المشكلة تعود باستمرار، فهذه معلومات تشخيصية وليست حلاً دائمًا. استمر في المحاولة حتى تتمكن من تحديد نوع الحمل أو الحالة التي تسبب تكرار المشكلة.
استخدم نفس المستند، ونفس عدد المستخدمين تقريبًا، ونفس تسلسل العمليات. قِس الأداء لعدة دقائق بدلًا من مقارنة لحظة واحدة. في هذا السيناريو التوضيحي، يُعتبر الأداء ناجحًا إذا لم يعد الخادم مُثقلًا أثناء تكرار عبء العمل، مع استمرار عمليات فتح المستند وتحريره وحفظه والتعاون عليه بسلاسة.
| ملاحظة | الخطوة التالية المحتملة |
|---|---|
| تبقى وثيقة واحدة أو مجموعة أدوات ساخنة | قم بإعادة إنتاج المشكلة باستخدام هذا الملف، واحتفظ بالسجلات، واختبرها على الإصدار المصغر المستقر الحالي. |
| يتتبع المعالج عدد المستخدمين النشطين | قم بمراجعة السعة والتزامن وحجم النشر بدلاً من التعامل مع الحمل على أنه تسريب. |
| يظل استهلاك وحدة المعالجة المركزية مرتفعًا بعد مغادرة المستخدمين. | افحص المستندات الخاملة، وسلوك التنظيف، والمهام المتكررة في الخلفية، والمجموعات اليتيمة أو التي يتم إعادة تشغيلها. |
| بدأ سبايك العمل فورًا بعد الترقية | سجل الإصدارات الدقيقة وتحقق من ملاحظات الإصدار الحالية والمشاكل المعروفة قبل تغيير العديد من قيم الضبط. |
| يؤدي خفض قيمة max_concurrency إلى تقليل استهلاك وحدة المعالجة المركزية، لكن عملية التحرير تصبح أبطأ. | قم بزيادته تدريجياً أو أضف سعة وحدة المعالجة المركزية؛ الإعداد هو حل وسط وليس حلاً شاملاً. |
إذا بدأ هذا السلوك مع إصدار معين من Collabora، وكان بالإمكان إعادة إنتاجه باستخدام ملف أو عملية محددة، فقد يؤدي ضبط الإعدادات إلى إخفاء عيب برمجي فقط. توصي Collabora باستخدام أحدث إصدار من الفرع المستقر الحالي. اعتبارًا من 7 أكتوبر 2026، تُشير صفحة ملاحظات الإصدار الرسمية 26.04 إلى أن الإصدار 26.04.3.3 هو أحدث إصدار من Collabora Online مُدرج هناك.
بالنسبة لمستخدمي CODE، تذكروا أن Collabora تصف إصدار التطوير بأنه مناسب للفرق الصغيرة، والاستخدام المنزلي، والتطوير، وتجربة الوظائف الجديدة، مع التأكيد على أنه غير مخصص لبيئات الإنتاج. لذا، قد يكون من الأنسب الانتقال إلى منتج Collabora Online المدعوم في حال حدوث مشكلة في بيئة الإنتاج، بدلاً من الاستمرار في محاولة ضبط سلوك إصدار التطوير.
coolwsdالرقم المرتفع يثبت وجود تسرب للذاكرة أو حلقة لا نهائية.coolwsdعملية قديمة loolwsdأو عملية مجموعة أدوات فرعية/مجموعة أدوات فرعية.per_document.max_concurrencyفقط ما إذا كان أحد المستندات يستخدم الكثير من وحدة المعالجة المركزية المتوازية.تستند تفاصيل التكوين في هذا الدليل إلى قالب المصدر الحالي لـ Collabora Online: قالب تكوين Collabora Online coolwsd.xml . يوثق دليل SDK الرسمي التسجيل، وضوابط الأداء، ونقطة نهاية المقاييس المتوافقة مع Prometheus: دليل Collabora Online SDK . للتحقق من الإصدار، استخدم ملاحظات إصدار Collabora Online 26.04 من الشركة المصنعة . للاطلاع على الاستخدام المقصود لإصدار التطوير، راجع إعلان إصدار CODE 26.04 الرسمي .
الهدف العملي ليس إجبار Collabora Online على استخدام أقل قدر ممكن من وحدة المعالجة المركزية، بل جعل استهلاك وحدة المعالجة المركزية قابلاً للتفسير ومتناسباً مع العمل المفيد، مع الحفاظ على أداء مقبول للتحرير والتعاون.
قم بتوصيل محرري سطح المكتب ONLYOFFICE بخادم ownCloud الخاص بك، وقم بتسجيل الدخول، وافتح ملفات السحابة، وقم بإدارة الاتصال، وقم باستكشاف أخطاء الإعداد الشائعة وإصلاحها.
قم باستكشاف أخطاء استخدام وحدة المعالجة المركزية العالية في Collabora Online وإصلاحها من خلال تحديد عمليات مجموعة الأدوات المشغولة، والتحقق من المقاييس والسجلات، وضبط التزامن والتنظيف، والتحقق من الإصلاحات بأمان.
تعرف على كيفية تخصيص العلامة التجارية لـ ONLYOFFICE Docs بشعار رأس الصفحة وألوان الواجهة، بما في ذلك حدود الترخيص، وإعداد JSON الخاص بالسمات، ومسارات Docker، والاختبار.
قم بإصلاح النصوص التي يصعب قراءتها في LibreOffice Calc عن طريق التحقق من سمة التطبيق، وخط الخلية وألوان التعبئة، والأنماط، والتنسيق الشرطي - ثم تحقق من مخرجات الطباعة.
قم بإزالة تحذير قفل المستخدم غير المعروف من LibreOffice بأمان. تحقق من الجلسات النشطة، واحمِ نسخة، وأزل القفل القديم الذي تم التحقق منه فقط، واختبر المستند.
أصلح النصوص العربية أو العبرية التي تتدفق أو تتماشى أو تختلط مع الإنجليزية بشكل غير صحيح في برنامج LibreOffice Writer. فعّل تخطيط النص المعقد، وحدد اتجاه الفقرة، وتحقق من النتيجة.
تعلم VLOOKUP و XLOOKUP في LibreOffice Calc، بما في ذلك التطابقات التامة، والبحث الأيسر، ونتائج عدم العثور، والبحث العكسي، وبدائل INDEX/MATCH، والأخطاء الشائعة.
قم باستكشاف أخطاء التحقق من صحة إثبات WOPI في Collabora Online وإصلاحها عن طريق التحقق من مفاتيح الاكتشاف، وتدوير المفاتيح، وعناوين URL للوكيل، والطوابع الزمنية، وقوائم السماح للمضيف.
قم بتمكين ميزة تتبع التغييرات للجميع في مستند ONLYOFFICE، واحتفظ بها نشطة بعد إعادة فتحه، وافهم حدود الإعداد الافتراضي العام.
قارن بين إعدادات Collabora Online الخاصة بكل عرض، وعدم التركيز، وخمول المستند، والحفظ التلقائي، ومهلات الوكيل، ثم اختر الإعدادات المناسبة لعملية النشر الخاصة بك وتحقق منها.
