حل مشكلة الشاشة السوداء أو تحميل مستند فارغ في Collabora Online

ابدأ بفحص اتصال WebSocket وإمكانية الوصول إلى الخادمين. غالبًا ما يفشل محرر Collabora Online الذي يفتح على شاشة سوداء أو صفحة بيضاء أو لوحة عمل فارغة قبل اكتمال تحميل واجهة المستخدم. إذا كانت المشكلة تؤثر على جميع الملفات، فافحص أولًا مسار المتصفح إلى Collabora، والخادم الوكيل العكسي، واتصال Nextcloud بـ Collabora. إذا فشل ملف واحد فقط، فاختبر مستندًا آخر وتحقق من أذونات هذا الملف وتنسيقه قبل تغيير إعدادات الخادم.

اتبع هذا الترتيب: افحص المتصفح، واختبر نقاط نهاية اكتشاف Collabora، واقرأ سجلات التكامل والخادم، ثم صحّح إعدادات الوكيل أو WOPI التي تشير إليها الأدلة فقط. قد يساعد إعادة ضبط ذاكرة التخزين المؤقت للمتصفح في حل مشكلة الملفات القديمة، لكنه لن يُصلح مشكلة WebSocket معطلة أو مضيف WOPI غير قابل للوصول. الصور التوضيحية للواجهة أدناه هي أمثلة تخطيطية؛ وتختلف التسميات الدقيقة ومسارات الطلبات باختلاف المتصفح، ومنصة الحوسبة السحابية، والوكيل، وإصدار Collabora.

التشخيص السريع عن طريق الأعراض

1. حدد ما إذا كانت المشكلة من جانب المتصفح أو من جانب الخادم

أولًا، افتح مستندًا ثانيًا تعرف أنه قابل للقراءة، وجرّب الملف نفسه في متصفح مختلف أو نافذة خاصة. إذا لم يفتح أحد المستندات بينما تُفتح المستندات الأخرى، فتأكد من أن المستخدم لا يزال بإمكانه تنزيله أو معاينته في منصة الملفات. قد يبدو الملف التالف، أو تنسيقه غير المدعوم، أو مشاركته منتهية الصلاحية، أو فقدان الأذونات، وكأنها مشكلة في المحرر، لكن تغيير الخادم الوكيل العكسي لن يحل مشكلة خاصة بالملف.

لإجراء فحص من جانب المتصفح، افتح أدوات المطوّرين قبل إعادة تحميل المستند الفارغ. في المتصفحات المبنية على Chromium، اضغط على مفتاحي Ctrl F12أو Ctrl+Shift+ICtrl+T، ثم اختر "الشبكة" ، وفعّل "الاحتفاظ بالسجل" ، ثم أعد التحميل. قم بتصفية النتائج حسب نوع الملف (مثل .org/10.org/2010 أو .org/2010 أو .org/2010). راجع أيضًا علامة تبويب "وحدة التحكم" بحثًا عن البرامج النصية المحظورة ws، أو تحذيرات الشهادات، أو أخطاء سياسة أمان المحتوى.coolbrowser

يشير فشل الطلب إلى /cool/…/wsمشكلة في مصافحة WebSocket أو في الخادم الوكيل. 502عادةً ما يعني هذا أن الخادم الوكيل لم يتمكن من الحصول على استجابة صالحة من المصدر؛ 404وقد يعني هذا أن المسار غير مُوجَّه؛ وقد 403يشير هذا إلى رفض المضيف أو قاعدة الوصول. تُضيِّق رموز الحالة هذه نطاق البحث، ولكن يلزم وجود سجلات الخادم الوكيل وسجلات Collabora المطابقة لتحديد السبب الدقيق. إذا كانت الطلبات الفاشلة تتعلق بملفات JavaScript أو CSS ضمن /browser، فتحقق من أن الخادم الوكيل يُعيد توجيه هذه الملفات الثابتة إلى خدمة Collabora.

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

2. تأكد من عنوان URL الخاص بـ Collabora ونقاط نهاية الاكتشاف

لدمج Nextcloud، تحقق من عنوان URL لخادم Collabora Online ضمن إعدادات إدارة Office. استخدم عنوان URL العام الذي يمكن للمتصفحات الوصول إليه، مع اسم المضيف والمنفذ الصحيحين. تشير إرشادات Nextcloud الحالية إلى ضرورة استخدام خدمات Collabora وNextcloud نفس البروتوكول؛ ويُوصى باستخدام HTTPS. قد يؤدي عدم التوافق، مثل استخدام بروتوكول HTTPS في إحدى الخدمات http://بينما يتم الوصول إلى الأخرى عبر بروتوكول HTTPS https://، إلى حظر طلبات المحتوى المختلط أو فشل عمليات الاستدعاء.

من متصفح على جهاز العميل المتأثر، افتح https://office.example.com/hosting/discoveryملف https://office.example.com/hosting/capabilities`.column.org/app ...

ثم قم بالاختبار من مضيف Nextcloud، لأن اختبار المتصفح وحده لا يثبت أن الخوادم يمكنها التواصل مع بعضها البعض:

curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/discovery
curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/capabilities

استبدل office.example.comاسم مضيف Collabora المُكوّن. يُعدّ نجاح استجابة HTTP مؤشرًا مفيدًا للتحقق من إمكانية الوصول، بينما يتطلب حلّ مشكلات انتهاء المهلة، أو فشل نظام أسماء النطاقات (DNS)، أو خطأ TLS، أو استجابة 5xx، معالجةً على مستوى الشبكة، أو الشهادة، أو نظام أسماء النطاقات (DNS)، أو الخادم الوكيل. بالنسبة للتركيبات التي يجب أن يتصل فيها خادم Collabora بـ Nextcloud، اختبر أيضًا عنوان URL لحالة Nextcloud من مضيف Collabora.

curl -fsS https://cloud.example.com/status.php

استخدم اسم مضيف Nextcloud الفعلي الخاص بك. يمكن لعمليات تثبيت CODE المدمجة استخدام عنوان URL لوكيل داخلي بدلاً من اسم مضيف Collabora عام منفصل، لذا اتبع التعليمات الخاصة بهذا التثبيت بدلاً من تطبيق مثال الخادم المستقل حرفيًا.

3. تحقق من مسار WebSocket والوكيل العكسي

يُقدّم Collabora موارد المتصفح وجلسات المستندات عبر مسارات متعددة. يجب على الخادم الوكيل العكسي إعادة توجيه المسارات المتوقعة من الإصدار المُثبّت، بما في ذلك موارد المُحرّر، ونقاط نهاية الاكتشاف والقدرات، ومسار WebSocket الخاص بالمستندات. تستخدم وثائق Collabora الحالية المسار `/usr/local/websocket` /cool/…/ws؛ وقد تحتوي عمليات النشر القديمة على إعدادات /loolللمسارات القديمة. تُشير وثائق ترحيل Nextcloud تحديدًا إلى تغييرات المسار السابقة من ` loleaflet/usr /local/websocket` إلى browser`/usr/local/websocket` ومن `/usr/local/websocket` إلى `/usr/local/ loolwebsocket` cool.

في إعدادات الخادم الوكيل، تأكد من مطابقة موقع WebSocket قبل تطبيق القواعد العامة، وأن الخادم الوكيل يُعيد توجيه رؤوس الترقية المطلوبة لبرنامج الخادم الوكيل، وأن المصدر يشير إلى خدمة Collabora ومنفذها الفعليين. تأكد أيضًا من أن الخادم الوكيل يحتفظ بمعلومات المضيف والبروتوكول المتوقعة، ويسمح ببقاء الاتصالات طويلة الأمد مفتوحة. إذا انتهى بروتوكول TLS عند الخادم الوكيل، فتأكد من أن إعدادات إنهاء SSL في Collabora تتوافق مع هذا التصميم.

يُظهر مقتطف الشفرة المختصر أعلاه نوع رؤوس WebSocket التي قد يحتاجها خادم وكيل من نوع Nginx؛ وهو ليس تكوينًا كاملاً للوكيل. لا تقم بلصقه بمفرده أو دمج توجيهات من إصدارات مختلفة. قارن تكوينك الكامل مع دليل Collabora الرسمي للوكيل العكسي الخاص بإصدار الوكيل وCollabora الذي تستخدمه. بعد تعديل ملف الوكيل، تحقق من صحة صيغته باستخدام أمر configuration-test الخاص بالخادم قبل إعادة تحميله.

4. تحقق من صحة مضيف WOPI وسجلات الخادم

يستخدم Collabora واجهة WOPI (واجهة منصة تطبيقات الويب المفتوحة) لطلب مستند من خدمة تخزين متصلة مثل Nextcloud. يجب أن يقبل خادم Collabora مضيف WOPI، ويجب أن يكون خادم التخزين قادرًا على الوصول إلى خدمة Collabora. في Nextcloud، تحقق من إعدادات Office وقائمة السماح لطلبات WOPI. أضف عنوان خادم Collabora المتوقع فقط؛ لا تعطل التحقق من المضيف أو تسمح لمضيفين عشوائيين بإخفاء شاشة فارغة.

اقرأ سجلات النظام لحظة حدوث المشكلة. بالنسبة لنشر Docker، يوثّق دليل استكشاف الأخطاء وإصلاحها الخاص بـ Nextcloud كيفية التحقق من سجل الحاوية؛ استخدم اسم الحاوية الفعلي أو معرّفها.

docker logs --tail 100 collabora

في حالة التثبيت القائم على الحزم، تعتمد أسماء الخدمات ووجهات السجلات على نظام التشغيل وإصدار الحزمة. ومن الفحوصات الشائعة لنظام systemd ما يلي:

sudo journalctl -u coolwsd -n 100 --no-pager

ابحث عن طابع زمني مطابق وأخطاء تتعلق بمضيف WOPI غير مصرح به، أو CheckFileInfoطلب فاشل، أو تحقق TLS، أو مساحة تخزين غير متاحة، أو اتصال WebSocket فاشل. عادةً ما تعني رسالة "لا يوجد مضيف WOPI مقبول مطابق" أن اسم مضيف التخزين المُكوّن للتكامل لا يتطابق مع المضيف المسموح به من قِبل Collabora. صحّح اسم المضيف أو إدخال قائمة السماح بدلاً من إضافة نطاقات غير ذات صلة.

راجع أيضًا سجل منصة الملفات لنفس وقت الطلب. إذا تعذر على Collabora الوصول إلى Nextcloud، فتحقق من تحليل نظام أسماء النطاقات (DNS) من مضيف Collabora، وقواعد جدار الحماية، والمسار العام أو الداخلي، وما إذا كانت الخدمة تحاول الوصول إلى نفسها عبر اسم مضيف يختلف تحليله داخل شبكة الحاوية. يوصي دليل استكشاف أخطاء Nextcloud وإصلاحها بالتحقق من الاتصال في كلا الاتجاهين واستخدام سجلات الخادم لتحديد الجانب المعطل.

5. أعد اختبار المستند وقم بإجراء التغييرات المستهدفة فقط

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

• يعمل الاكتشاف، لكن WebSocket يفشل: التركيز على مسار WebSocket الخاص بالوكيل، ومعالجة الترقية، وعنوان المصدر، ومهلة الاتصال.
• يمكن للمتصفح الوصول إلى Collabora، لكن Nextcloud لا يمكنه ذلك: اختبار DNS، وجدار الحماية، وثقة TLS، والتوجيه من مضيف Nextcloud.
• أبلغت Collabora عن مضيف WOPI غير مصرح به: قارن اسم مضيف التخزين الدقيق في إعدادات التكامل مع قائمة مضيف WOPI المسموح بها.
• لا تفشل إلا عمليات التثبيت القديمة بعد الترقية: قارن مسارات الوكيل مع وثائق الإصدار المثبتة وقم بتحديث المسارات القديمة /loolأو /loleafletالمسارات عند الحاجة.
• يفشل ملف واحد فقط بعد اجتياز فحوصات الاتصال: تحقق من الوصول إلى الملف واختبر نسخة أو تنسيقًا مدعومًا مختلفًا قبل تغيير الإعدادات العامة.

كيف يبدو الإصلاح الناجح

لا يقتصر الحصول على نتيجة موثوقة على ظهور شريط أدوات المحرر فحسب، بل يجب أن يتم عرض محتوى المستند بشكل صحيح، دون وجود أي طلبات فاشلة مستمرة من المحرر أو WebSocket، وأن يتم حفظ تعديل تجريبي غير ضار ويبقى بعد إعادة تحميل الصفحة. إذا استمرت المشكلة، احتفظ بمقتطف قصير من سجل الشبكة/وحدة التحكم في المتصفح بعد تنقيحه، بالإضافة إلى سجلات Nextcloud والوكيل وCollabora المطابقة. قد تحتوي السجلات على أسماء المضيفين أو أسماء المستخدمين أو معرّفات الملفات أو الرموز المميزة، لذا احذف القيم الحساسة قبل مشاركتها.

للاطلاع على الخطوات الخاصة بالنشر الحالي، يُرجى مراجعة دليل استكشاف أخطاء Nextcloud Office وإصلاحها ، ومرجع تكوين Nextcloud Office ، وملاحظات ترحيل Collabora . قد تختلف عمليات التحقق الدقيقة لـ ownCloud، أو مضيف WOPI آخر، أو خدمة CODE مدمجة، أو منصة حاويات، عن أمثلة Nextcloud.