ربط Nextcloud بـ CODE Docker: الإعداد والمفاضلات

قم بربط Nextcloud بـ Collabora CODE عن طريق تشغيل الصورة الرسمية collabora/code، وتقييد منفذها على المضيف، وتوجيه نطاق فرعي للمكتب عبر HTTPS من خلال خادم وكيل عكسي يدعم WebSocket، ثم تعيين عنوان URL العام هذا في تكامل Nextcloud مع Collabora. يستغرق الأمر عشر دقائق فقط إذا كان Docker وDNS وTLS والخادم الوكيل جاهزين.

اختر خدمة المكتب المناسبة أولاً. اعتبارًا من أكتوبر 2026، ميّزت Nextcloud بين Nextcloud Office المدعوم من Euro-Office وCollabora Online. CODE هو إصدار التطوير من Collabora Online، لذا استخدم تكامل Collabora، وليس موصل Euro-Office. تطبيق CODE المدمج هو الأسرع للاستخدام الشخصي، لكن Nextcloud تصفه بأنه أبطأ ويفتقر إلى قابلية التوسع المتقدمة. يُعدّ استخدام حاوية منفصلة أسهل في الإدارة بشكل مستقل، ولكنه يتطلب موارد إضافية للوكيل والتحديث. يناسب CODE الاستخدام المنزلي والاختبار؛ اختر نشر Collabora Online المدعوم عندما تحتاج الشركة إلى دعم الإنتاج.

قبل أن تبدأ: المسار الذي يستغرق عشر دقائق

يجب توفير عنوان HTTPS فعال لـ Nextcloud، واسم مضيف مكتب منفصل مع بروتوكول TLS صالح، وإمكانية الوصول إلى Docker على مضيف CODE. يجب توجيه اسم مضيف المكتب إلى خادم وكيل عكسي قادر على توجيه الطلبات إلى الحاوية. يجب أن يتمكن كل من متصفحات المستخدمين وخادم Nextcloud من الوصول إلى عنوان URL الخاص بالمكتب.

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

1. ابدأ تشغيل حاوية Code Docker

استبدل اسم مضيف Nextcloud التجريبي باسم مضيف HTTPS الذي يستخدمه المستخدمون لتسجيل الدخول. aliasgroup1يقيّد هذا الإعداد مضيف WOPI (خدمة الملفات التي تُزوّد ​​المحرر بالمستندات) المسموح له بالاتصال. لا تستخدم رمزًا عامًا (*) لمجرد إخفاء اتصال فاشل.

docker pull collabora/code

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

يُبقي الربط 127.0.0.1المنفذ خاصًا بينما يمكن لخادم وكيل على نفس المضيف الوصول إليه. إذا كان خادم الوكيل الخاص بك في مكان آخر، فاسمح فقط لهذا الخادم الوكيل الموثوق بالاتصال بالمنفذ 9980.

تأكد من بدء تشغيل الحاوية وأن نقطة اكتشافها تستجيب محليًا:

docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery

-kيتجاوز التحقق من صحة الشهادة فقط لهذا الفحص المحلي الموقع ذاتيًا؛ فهو لا يصلح شهادة عامة غير صالحة.

2. ضع اسم مضيف المكتب العام خلف بروتوكول HTTPS

استخدم خادم https://office.example.comوكيل عكسي بشهادة صالحة، ووجّه الطلبات إلى CODE. تغطي إرشادات الوكيل من Collabora موارد المحرر، واكتشاف/إمكانيات الوصول، /cool/وإعادة توجيه WebSocket. بدون ترقيات WebSocket، قد يتم تحميل الصفحة بينما يتعطل المحرر.

استخدم الإعدادات المُعدّة مسبقًا لبرنامج البروكسي الخاص بك. إذا كان البرنامج يُنهي اتصال TLS قبل وصول التعليمات البرمجية (CODE)، فاتبع إعدادات TLS الموثقة للخادم الخلفي؛ ولا تُعطّل عمليات التحقق من الشهادات بشكل عام.

3. قم بربط تكامل Collabora في Nextcloud

في Nextcloud، فعّل أو ثبّت تطبيق التكامل Collabora المتاح لإصدارك. ثم افتح لوحة إدارة Office وأدخل عنوان URL العام لـ Collabora https://office.example.com. تُشير الأدلة الحالية إلى هذا الإعداد باسم "خادم Collabora Online"؛ وقد تختلف الصياغة وتسميات التطبيق باختلاف الإصدار، خاصةً مع إضافة Nextcloud خيار Euro-Office. اختر Collabora Online لخادم CODE هذا. لا تُدخل عنوان الحاوية فقط https://127.0.0.1:9980إلا إذا كان Nextcloud نفسه يعمل على نفس المضيف وكان هذا العنوان هو أيضًا نقطة نهاية الخدمة المُكوّنة؛ في إعداد الوكيل المُوصى به، استخدم اسم مضيف Office العام.

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

4. تحقق من التحرير، ثم اختر ما إذا كان الكود مناسبًا

افتح مستندًا تجريبيًا صغيرًا في Nextcloud وتأكد من أنه يُفتح في محرر المتصفح، ويقبل التغيير، ويحفظه، ثم يُعاد فتحه مع بقاء التغيير. اختبر ذلك من حساب مستخدم عادي ومن حساب مدير النظام. يُؤكد فحص الاكتشاف وحده استجابة CODE، ولكنه لا يُثبت أن عملية تفويض WOPI، وبروتوكول WebSockets عبر الوكيل، وعمليات حفظ المستند تعمل جميعها بشكل صحيح.

بالنسبة للخوادم الشخصية أو الفرق الصغيرة، يفصل CODE Docker المحرر عن بيئة PHP الخاصة بـ Nextcloud. كما أنك تتحكم في الخادم الوكيل، وعمليات إعادة التشغيل، وفحوصات التوافق، وتحديثات الصور. تطبيق CODE المدمج أبسط، ولكنه يتشارك الخادم المضيف ويفتقر إلى ميزات التوسع. بالنسبة للمؤسسات التي تعتمد على التحرير اليومي، يُنصح بتقييم خدمة Collabora Online المدعومة بدلاً من اعتبار CODE ضمانًا للإنتاج.

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

التحقق

يعمل الإعداد بشكل صحيح عندما يُقدّم اسم مضيف المكتب العام شهادة صالحة، وينجح فحص اتصال Nextcloud، ويُفتح مستند تجريبي ويُحفظ ويُعاد فتحه من خلال المحرر. إذا تم تحميل صفحة المكتب الرئيسية ولكن توقف التحرير، فتحقق من إعادة توجيه WebSocket. إذا أبلغ Nextcloud أن المضيف غير مسموح به، فصححه aliasgroup1ليطابق مصدر Nextcloud الفعلي. إذا استجاب CODE محليًا ولكن ليس من متصفحات المستخدمين، فتحقق من نظام أسماء النطاقات العام، وتوجيه جدار الحماية، والخادم الوكيل العكسي.

المراجع: مثال تثبيت Docker لـ Nextcloud ؛ خيارات تثبيت Nextcloud Office ؛ تكوين Nextcloud Collabora ؛ إعدادات الوكيل العكسي لـ Collabora ؛ تفاصيل صورة Docker الرسمية لـ CODE ؛ خيارات مكتب Nextcloud Hub 26 الصيفية .