تتبع مستند Collabora فارغ إلى الطبقة المعيبة

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

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

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

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

2. ابحث عن الطلب الذي فشل قبل تغيير الإعدادات

في متصفح Chrome أو Chromium، افتح أدوات المطوّرين ( F12 أو Ctrl+Shift+I )، ثم اختر "الشبكة" ، وفعّل "الاحتفاظ بالسجل" ، وأعد تحميل الصفحة. قم بتصفية طلبات WS (WebSocket) وافحص حالات الفشل؛ يشرح مرجع شبكة أدوات مطوّري Chrome عوامل تصفية الطلبات وتفاصيل الحالة. تحقق من وحدة التحكم بحثًا عن أخطاء CSP أو الشهادات أو المحتوى المختلط أو JavaScript.

قم بتفسير الأدلة بدلاً من تطبيق وصفة عامة بديلة:

• خطأ 404 في أصول المحرر أو /browser/المسارات: تحقق مما إذا كان الخادم الوكيل العكسي يقوم بإعادة توجيه مسارات Collabora الحالية إلى المصدر الصحيح.
• في حال ظهور خطأ 502، أو انتهاء المهلة، أو إغلاق اتصال WebSocket فورًا، يُرجى التحقق من إمكانية الوصول إلى الخادم، وسجلات الخادم الوكيل، ومعالجة WebSocket، ومسار الطلب. إن إمكانية الوصول /hosting/discoveryإلى نقطة النهاية تُثبت فقط إمكانية الوصول الأساسي عبر HTTP، ولا تُثبت عمل اتصال المحرر المباشر.
• 403 أو "مضيف WOPI غير مصرح به" في السجلات: تحقق من مضيف التخزين المسمى في عنوان URL الخاص بـ WOPI مقابل مضيفي WOPI المسموح بهم في Collabora.
• خطأ في سياسة أمان المحتوى أو الشهادة: أصلح مصدر التضمين أو سلسلة الشهادات بدقة. لا تُعطّل أمان المتصفح أو تُخفّف سياسة أمان المحتوى بشكل عام لجعل الشاشة تُحمّل.

بالنسبة لطلبات WebSocket، فإن المصافحة الناجحة هي الهدف؛ وتعتمد الحالة المعروضة على إصدار HTTP ومسار الوكيل، لذلك لا تتعامل مع رقم حالة واحد متوقع على أنه عالمي.

3. قم بمطابقة الإصلاح مع الطبقة المعيبة

تحقق من كلا الاتجاهين ونظام عنوان URL

تشير إرشادات استكشاف الأخطاء وإصلاحها الحالية لـ Nextcloud Office إلى ضرورة اتصال متصفح المستخدم بالخادمين عبر HTTP(S)، حيث يجب أن يتصل Nextcloud بـ Collabora، ويجب أن يتصل Collabora بـ Nextcloud. كما تنص الإرشادات على استخدام نفس البروتوكول في كلا الخدمتين. اختبر عنوان Collabora العام من متصفحك على الرابطين التاليين: [رابط 1] https://office.example.com/hosting/discoveryو[رابط 2] https://office.example.com/hosting/capabilities. من خادم Nextcloud، استخدم الأمر التالي:

curl -fsS https://office.example.com/hosting/discovery -o /dev/null

curl -fsS https://office.example.com/hosting/capabilities -o /dev/null

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

لا تقم بإصلاح توجيه الوكيل إلا عندما تتطلب الطلبات ذلك.

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

تصحيح قوائم السماح الخاصة بـ WOPI دون فتحها

بروتوكول WOPI هو البروتوكول الذي يستخدمه Collabora لجلب المستندات وحفظها عبر منصة التخزين. عادةً ما يكون مضيف WOPI هو اسم مضيف Nextcloud أو أي مضيف تخزين آخر، وليس اسم مضيف Collabora. إذا أشارت السجلات إلى خلاف ذلك No acceptable WOPI hosts found، فأضف أو صحّح مضيف التخزين الصحيح في إعدادات مضيف WOPI الخاصة بـ Collabora، ثم تأكد من أن قائمة السماح لطلبات WOPI في منصة التخزين تتضمن عنوان خادم Collabora. توصي Nextcloud بتقييد طلبات WOPI بعناوين IP المتوقعة لـ Collabora، وتكوين Collabora ليثق بالمضيفين المتوقعين وفقًا لإرشادات تكوين Office .

إضافة مضيف موثوق به محدد أكثر أمانًا من تعطيل التحقق من المضيف أو السماح بنطاقات واسعة. سجّل الإعداد الحالي، وغيّر الإدخال ذي الصلة فقط، وأعد تشغيل الخدمات أو أعد تحميلها حسب الحاجة فقط. إذا كنت تستخدم Docker، فافحص مخرجات Collabora الأخيرة باستخدام الأمر `collabora.co.uk` docker logs --since=10m <collabora-container>؛ واستبدل العنصر النائب باسم الحاوية الحقيقي. بالنسبة لعمليات تثبيت الحزم أو Kubernetes، استخدم سجلات الخدمة أو pod الخاصة بها.

4. تحقق من المحرر، وليس فقط نقطة نهاية الصحة

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

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