قم بتوصيل Nextcloud بحاوية Collabora CODE ذاتية الاستضافة

لربط Nextcloud بحاوية Collabora Online Development Edition (CODE) المستضافة ذاتيًا، شغّل CODE على اسم مضيف منفصل، وقم بتأمينه ببروتوكول HTTPS، ثم أدخل عنوان URL العام الخاص به في Nextcloud Office. يجب أن تسمح حاوية CODE أيضًا لموقع Nextcloud بالوصول إليه كمضيف WOPI. في المثال أدناه، Nextcloud هو cloud.example.comوCollabora هو office.example.com؛ استبدل كلا الاسمين باسمي المضيف الحقيقيين لديك.

ما الذي يجب أن يكون جاهزاً قبل البدء؟

أنت بحاجة إلى تثبيت Nextcloud يعمل بشكل سليم، ومضيف Docker قادر على تشغيل حاوية CODE، وسجلات DNS لاسمَي مضيفَي Nextcloud وCollabora، وشهادات HTTPS صالحة لكلا الموقعين العامين. يجب أن يكون مضيف Nextcloud وخادم Collabora قادرين على الاتصال ببعضهما عبر الشبكة. يهدف خادم Collabora المخصص إلى تحسين السعة مقارنةً بخيار CODE المدمج؛ وهو لا يزال إصدارًا تجريبيًا، لذا يُرجى مراجعة شروط Collabora الحالية وإرشادات الإصدار قبل استخدامه في عمليات نشر واسعة النطاق أو بالغة الأهمية للأعمال.

يفترض هذا الشرح أن خادم وكيل عكسي يعمل على مضيف Docker ويقوم بتوجيه حركة مرور HTTPS office.example.comإلى المنفذ المحلي للحاوية. إذا كان خادم الوكيل يعمل في حاوية مختلفة أو على جهاز آخر، فلا تقم بنسخ تعيين منفذ الاسترجاع دون تغيير: استخدم شبكة Docker خاصة أو عنوان مضيف خاص يمكن لخادم الوكيل الوصول إليه، وقم بحماية الواجهة الخلفية بجدار ناري لمنع كشفها للعامة.

1. ابدأ تشغيل حاوية التعليمات البرمجية

أولًا، اسحب الصورة وشغّل حاوية. في إعدادات الاسم المستعار، استخدم المصدر العام لـ Nextcloud، بما في ذلك البروتوكول والمنفذ. لا تضع عنوان URL الخاص بـ Collabora هناك. يستخدم مثال تثبيت Docker الخاص بـ Nextcloud هذا النمط:

docker pull collabora/code
docker run -t -d -p 127.0.0.1:9980:9980 \
  -e 'aliasgroup1=https://cloud.example.com:443' \
  --restart always \
  --cap-add MKNOD \
  collabora/code

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

يتبع الأمر أعلاه مثال Docker الوارد في دليل إدارة Nextcloud 35. قبل الاستخدام في بيئة الإنتاج، راجع وثائق صورة CODE الحالية واختر سياسة تحديث الإصدار/الوسم التي تناسب عملية الصيانة لديك. يمكن تغيير مرجع الصورة الافتراضي مع نشر الإصدارات؛ لذا خطط للتحديثات، وراقب الحاوية، وأعد اختبار تحرير المستندات بعد التحديثات.

2. ضع الحاوية خلف خادم وكيل عكسي HTTPS

قم بتهيئة خادم الوكيل الحالي لديك لخدمة https://office.example.comطلبات خدمة CODE وإعادة توجيهها 127.0.0.1:9980. استخدم إعدادات خادم الوكيل العكسي الحالية من Collabora لبرنامج الوكيل الخاص بك. يجب أن يحافظ خادم الوكيل على المسارات المطلوبة وأن يدعم ترقيات WebSocket؛ إذ تعتمد جلسة متصفح المحرر عليها. يتضمن مثال Nextcloud Docker مسارات لـ /browser، /hosting/discoveryو /hosting/capabilities، و /cool، بما في ذلك نقطة نهاية WebSocket. تستخدم بعض عمليات التكامل أيضًا /loolمسار التوافق.

لا تعتبر تحميل الصفحة الرئيسية بنجاح دليلاً على اكتمال عمل الخادم الوكيل. قد يعرض الخادم الوكيل الذي يتعامل مع طلبات HTTPS العادية ولكنه يفشل في ترقية اتصالات WebSocket إطار المحرر ثم يتركه قيد التحميل أو غير متصل. استخدم شهادة عامة صالحة لاسم مضيف Collabora. أبقِ المنفذ 9980 مغلقًا أمام الإنترنت العام عندما يكون الخادم الوكيل هو نقطة الدخول الوحيدة.

3. قم بتفعيل Nextcloud Office وأدخل عنوان URL للخادم

في Nextcloud، افتح التطبيقات وقم بتثبيت أو تفعيل Nextcloud Office ( richdocumentsالتكامل). ثم افتح إعدادات الإدارة ← Office ، واختر خيار خادم Collabora الخارجي، وأدخل عنوان URL https://office.example.com. احفظ الإعدادات. استخدم عنوان URL العام، وليس عنوان localhost:9980URL الخاص بخادم Nextcloud: يجب أن يتمكن كل من خادم Nextcloud ومتصفحات المستخدمين من الوصول إلى نفس نقطة نهاية Collabora الخارجية.

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

4. تحقق من مسار WOPI وافتح مستندًا تجريبيًا

بروتوكول WOPI هو البروتوكول الذي يستخدمه Nextcloud لمنح Collabora وصولاً مُتحكمًا به إلى المستند. في إعدادات إدارة Office الخاصة بـ Nextcloud، راجع قائمة السماح لطلبات WOPI ، وقيّد الطلبات بعناوين IP التي تصل منها خدمة Collabora إلى Nextcloud. كذلك، اضبط Collabora لقبول مضيف WOPI المقصود فقط. قد يختلف العنوان الدقيق عند استخدام الحاويات أو NAT أو خادم وكيل عكسي، لذا استخدم عنوان المصدر الذي يراه Nextcloud فعليًا في سجلاته بدلاً من التخمين.

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

ما الذي يجب عليك التحقق منه إذا لم يفتح المحرر؟

• خطأ في الاكتشاف أو الاتصال: تأكد من أن office.example.comيتم حلها من خادم Nextcloud والمتصفح، وأن شهادتها صالحة، وأن الوكيل يرسل /hosting/discoveryإلى CODE.
• تحميل لا ينتهي أو محرر غير متصل: تحقق من معالجة ترقية WebSocket في الخادم الوكيل العكسي والمسارات /cool. راجع سجلات الخادم الوكيل والحاوية بحثًا عن الطلبات المرفوضة.
• تم رفض مضيف WOPI: قارن الإعدادات aliasgroup1مع مصدر Nextcloud العام الدقيق، بما في ذلك البروتوكول والمنفذ. تحقق من قائمة السماح لـ WOPI في Nextcloud مقابل عنوان IP المصدر لـ Collabora المرئي لـ Nextcloud.
• يعمل على المضيف ولكن ليس في Nextcloud: اختبر الاتصال من خادم Nextcloud إلى عنوان URL العام لـ Collabora. لا يمكن الوصول تلقائيًا إلى اسم المضيف الداخلي للحاوية أو عنوان المضيف المحلي لمضيف Docker من جميع الحاويات الأخرى.
• تحذير بشأن الشهادة: يُرجى إصلاح سلسلة الشهادات أو عدم تطابق اسم المضيف. قد يؤدي تعطيل التحقق من الشهادة إلى إخفاء السبب وإضعاف الاتصال.

لتشخيص المشكلة، قارن إعداداتك مع مثال تثبيت Nextcloud Docker الرسمي ، ودليل إعداد Office وWOPI ، ووثائق صورة CODE Docker وخادم الوكيل العكسي من Collabora . هذه المراجع مُرقّمة وقد تتغير؛ أما الأوامر المذكورة هنا فتعكس مثال إدارة Nextcloud 35 المتاح في 10 أكتوبر 2026.