ابدأ بالتأكد من أن المتصفح وNextcloud وCollabora جميعها قادرة على الوصول إلى عناوين URL الصحيحة للخادم عبر نفس بروتوكول HTTP أو HTTPS. في Nextcloud، اختبر نقاط نهاية Collabora /hosting/capabilities؛ /hosting/discoveryإذا استجابت هذه النقاط ولكن لا تزال المستندات تفشل، فتحقق من مسار WebSocket الخاص بالخادم الوكيل العكسي وقائمة السماح لـ WOPI.
رسالة "حسنًا، هذا مُحرج" هي رسالة عامة تُشير إلى فشل فتح المستند، وليست تشخيصًا بحد ذاتها. قد يكون السبب عنوان URL غير قابل للوصول، أو عدم تطابق في بروتوكول TLS أو DNS، أو خادم وكيل يُعطّل ترقيات WebSocket، أو مُضيف WOPI لا يثق به Collabora أو Nextcloud. تستخدم الفحوصات أدناه مثالًا نموذجيًا مع Nextcloud على https://cloud.example.comوCollabora على https://office.example.com؛ استبدل كلا الاسمين بأسماء المضيفين الفعلية لديك.
من متصفح على نفس الشبكة التي يستخدمها المستخدم، افتح عناوين URL التالية، مع تغيير اسم مضيف Collabora:
https://office.example.com/hosting/capabilitieshttps://office.example.com/hosting/discoveryينبغي أن تُعيد هذه العملية بيانات نقطة نهاية Collabora بدلاً من تحذير شهادة المتصفح، أو صفحة خطأ 404، أو خطأ الخادم الوكيل العكسي. عادةً ما تُعيد نقطة نهاية الاكتشاف بيانات XML. يمكنك أيضًا إجراء الاختبار من مضيف Nextcloud أو حاوية التطبيق الخاصة به.
curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discoveryيشير فشل الاتصال من المتصفح إلى وجود مشكلة في نظام أسماء النطاقات (DNS) العام أو المحلي، أو جدار الحماية، أو الشهادة، أو توجيه الخادم الوكيل. أما نجاح الاتصال من المتصفح مع فشل الاتصال من سطر أوامر Nextcloud فيعني اختلاف مسار الخادم؛ إذ يحتاج كل من متصفح المستخدم وخادم Nextcloud إلى مسار اتصال خاص بهما للوصول إلى Collabora. يوصي دليل إدارة Nextcloud الحالي باختبار كلا نقطتي النهاية من كلا الموقعين والتأكد من إمكانية وصول Collabora إلى Nextcloud عبر بروتوكول HTTP(S).
في Nextcloud، افتح الإعدادات ← الإدارة ← المكتب ، وتأكد من أن حقل خادم Collabora Online يحتوي على عنوان URL العام أو الذي يمكن الوصول إليه لـ Collabora. استخدم هذا الخيار https://إذا كانت الخدمة مُهيأة لبروتوكول HTTPS. تشير وثائق Nextcloud إلى أن عنوان URL المُهيأ يجب أن يستخدم نفس البروتوكول المستخدم في تثبيت Collabora، وتوصي باستخدام HTTPS.
والآن، تحقق من مسار الإرجاع. من مضيف Collabora أو الحاوية، اطلب نقطة نهاية حالة Nextcloud:
curl -fsS https://cloud.example.com/status.phpيجب أن يكون الوصول إلى الاستجابة متاحًا من Collabora، وليس فقط من جهاز الكمبيوتر المحمول. إذا كان أي من الخادمين يعمل في Docker، فاختبره من الحاوية أو مساحة اسم الشبكة ذات الصلة: قد لا يتم حل اسم المضيف الذي يعمل على المضيف داخل الحاوية. بالنسبة لخادم CODE المدمج، يجب أن يكون Nextcloud قادرًا على الوصول إلى نفسه باستخدام نفس اسم المضيف الذي يستخدمه المستخدمون في المتصفح. إذا كان تقسيم نظام أسماء النطاقات (DNS) أو حل الاسم المحلي يمنع ذلك، فقم بتصحيح نظام أسماء النطاقات أو تعيين المضيف بدلاً من إدخال localhostاسم خدمة بعيدة.
إذا تم تحميل رابط الاكتشاف ولكن إطار المحرر ظل فارغًا، أو يدور، أو انقطع الاتصال، فافحص الخادم الوكيل أمام Collabora. يستخدم التحرير اتصال WebSocket مستمرًا: يجب على الخادم الوكيل توجيه /cool/…/wsنقطة نهاية Collabora الحالية إلى خدمة Collabora وتمرير رؤوس ترقية HTTP/1.1. راجع مثال الخادم الوكيل الحالي لـ Collabora لبرنامج الخادم الوكيل وإصداره؛ لا تلصق تكوينًا قديمًا دون تغيير.
قد لا تزال بعض الإصدارات القديمة تستخدم مسارات مثل /lool. توضح إرشادات ترحيل Collabora التغيير من loolإلى coolومن loleafletإلى browser. قد يُعيد الخادم الوكيل المُتبقّي على المسارات القديمة رمز الخطأ 404 حتى عند فتح النطاق الأساسي. بعد تعديل ملف الخادم الوكيل، تحقق من صحة صيغته باستخدام أمر الاختبار الخاص بالخادم، ثم أعد تحميله، ثم أعد اختبار عنوان URL للاكتشاف وافتح مستندًا.
تحقق من سجلات الوصول والأخطاء في نفس وقت محاولة الوصول الفاشلة. يشير الخطأ 404 /browserإلى /coolمشكلة في توجيه المسار؛ بينما يشير فشل ترقية WebSocket إلى عدم وجود معالجة ترقية أو انتهاء مهلة الاتصال؛ أما الخطأ 502 فيعني عادةً أن الخادم الوكيل لا يستطيع الوصول إلى خادم Collabora الرئيسي. هذه مجرد مؤشرات وليست تشخيصات نهائية، لذا قارنها بسجل Collabora الخاص.
بروتوكول WOPI (واجهة منصة تطبيقات الويب المفتوحة) هو البروتوكول الذي يستخدمه كل من Nextcloud وCollabora لتبادل طلبات الوصول إلى المستندات. إذا أظهر سجل Collabora رسالة "لم يتم العثور على مضيفين WOPI مقبولين" أو مضيف WOPI غير مصرح به، فتأكد من أن Collabora مُهيأة للوثوق باسم مضيف Nextcloud، وليس باسم مضيف Collabora الخاص بها. باستخدام صورة Docker، افحص إعدادات بدء تشغيل الحاوية وسجلاتها.
docker ps
docker logs --tail=100 CONTAINER_NAMEاستبدل CONTAINER_NAMEالاسم الفعلي لحاوية Collabora. لتثبيت حزمة أصلية، افحص سجل الخدمة باستخدام الأمر ` sudo journalctl -u coolwsd --since "15 minutes ago". اتبع تعليمات تكوين مضيف WOPI لطريقة التثبيت الخاصة بك؛ تجنب استخدام قواعد السماح العامة ذات الأحرف البديلة.
يوجد أيضًا في Nextcloud Office قائمة سماح منفصلة لبروتوكول WOPI. تُقيّد هذه القائمة عناوين IP لخوادم Collabora التي يُسمح لها بطلب الملفات من Nextcloud. أضف عنوان IP المصدر الذي يراه Nextcloud فعليًا لـ Collabora، والذي قد يختلف عند استخدام شبكة Docker أو خادم وكيل عكسي. لا تُدخل 0.0.0.0أو تُعطّل هذا التقييد لمجرد إخفاء خطأ ما: يُوصي Nextcloud بتقييد طلبات WOPI بعناوين خوادم Collabora المتوقعة.
أعد الاختبار من متصفح المستخدم ومن خادم Nextcloud: يجب أن تستجيب نقاط نهاية الاكتشاف والقدرات، وأن يصل Nextcloud إلى عنوان URL المُكوّن لـ Collabora، وأن يصل Collabora إلى نقطة نهاية حالة Nextcloud. ثم افتح مستند اختبار صغير. إذا استمر الفشل، فسجّل الطابع الزمني، وإجراء المستند المتأثر، وحالة HTTP أو WebSocket في سجل الوكيل، وإدخالات سجل Nextcloud وCollabora المطابقة. تساعد هذه الأدلة في التمييز بين فشل مسار الشبكة ومشكلة ترخيص WOPI.
قم بالسماح بمصدر Nextcloud المحدد أو مصدر WOPI آخر في CODE، ثم تحقق من قائمة السماح للمضيف النشط وقم بتمييزها عن تقييد عنوان IP المصدر الخاص بـ Nextcloud.
قم بتتبع اتصالات متصفح Collabora و WOPI و WebSocket لمعرفة سبب عدم فتح المستند، ثم قم بتطبيق الإصلاح الذي يتوافق مع إعداد Nextcloud الخاص بك.
قم بنشر نسخ Collabora CODE باستخدام Helm، واحتفظ بكل مستند على وحدة واحدة من خلال تقارب WOPI، وتحقق من الدخول، ووضع العقدة، وتحرير Nextcloud.
تتبع عملية المصافحة الفاشلة من المتصفح إلى coolwsd، ثم قم بمطابقة مسار الوكيل العكسي مع إصدار Collabora الخاص بك، بما في ذلك تغيير Apache CODE 26.04.
تتبع حالات فشل إثبات Collabora WOPI إلى مفاتيح غير متطابقة، أو بيانات اكتشاف قديمة، أو انحراف الساعة، أو تغييرات عنوان URL للوكيل - دون إضعاف التحقق.
أعد ضبط تكبير/تصغير المتصفح، واختبر جلسة نظيفة، وحدد متى تحتاج قائمة الحجم المشوهة إلى تحديث خادم Collabora.
قم بنشر Collabora CODE باستخدام Docker، وقم بتوصيله بشكل آمن بـ Nextcloud Office، وتحقق من تحرير المستندات باستخدام فحوصات WOPI العملية وفحوصات البروكسي.
قم برفع coolwsd مؤقتًا إلى وضع التصحيح، والتقط عملية فتح فاشلة واحدة، واستخدم تسلسل السجل لفصل مشكلات WebSocket وWOPI والوكيل والحاوية.
قم بتكوين تسجيل دخول مسؤول Collabora Online لـ Docker أو Linux، وأعد تشغيل الخدمة الصحيحة، وتحقق من كلمة المرور الجديدة دون الكشف عنها.
تأكد من معرفة ما إذا كان حمل وحدة المعالجة المركزية ناتجًا عن المستندات النشطة أو عمليات العامل الخاملة أو سعة الخادم قبل تغيير إعدادات Collabora أو إعادة تشغيل الخدمة.
