🟢 تثبيت Collabora Online — حزمة مكتبية ذاتية الاستضافة لـ Nextcloud

انشر Collabora Online (CODE) على Ubuntu بـ Docker — حزمة مكتبية مبنية على LibreOffice تُحرّر المستندات والجداول والعروض التقديمية مباشرة في المتصفح، متكاملة مع Nextcloud أو ownCloud، على المنفذ 9980.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر Collabora Online (CODE) على المنفذ 9980 بكلمة مرور مسؤول مُولَّدة. إنه محرك التحرير؛ توجّه Nextcloud أو ownCloud إليه لفتح المستندات في المتصفح.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/collabora/collabora-ubuntu.sh
chmod +x collabora-ubuntu.sh
./collabora-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/collabora/collabora-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x collabora-ubuntu.sh

3 تشغيل المُثبّت

./collabora-ubuntu.sh

4 ربطه بـ Nextcloud

https://your-nextcloud-domain

المنافذ المستخدمة

المنفذالغرض
9980Collabora Online (CODE) web endpoint, admin console, and WOPI discovery

نظرة عامة

Collabora Online، الذي يُنشر عادةً كنسخة CODE (Collabora Online Development Edition)، هي حزمة مكتبية ذاتية الاستضافة مبنية على محرك عرض LibreOffice تتيح لك عرض وتحرير مستندات متوافقة مع Word وExcel وPowerPoint مباشرة في متصفح الويب، مع تعاون متعدد المستخدمين فوري. إنها ليست تطبيق تخزين ملفات مستقلاً — إنها محرك تحرير يتكامل مع تطبيق مضيف مثل Nextcloud أو ownCloud أو Seafile عبر بروتوكول WOPI (واجهة منصة التطبيقات المفتوحة على الويب). التطبيق المضيف يخزّن الملفات ويدير المستخدمين؛ وتعرض Collabora محرر المستند الحي عندما يفتح أحد ملفاً.

لماذا تستخدمه

توجد Collabora Online كي تتمكن منصات التخزين السحابي ذاتية الاستضافة مثل Nextcloud من تقديم تحرير مستندات حقيقي داخل المتصفح بدلاً من إجبار المستخدمين على تنزيل الملفات وتحريرها محلياً وإعادة رفعها. إنها مبنية على نفس محرك LibreOffice الذي يشغّل الحزمة المكتبية مفتوحة المصدر الشهيرة، مما يمنحها توافقاً قوياً مع .docx وxlsx. وpptx. وصيغ OpenDocument الأصلية. مقارنة بالاعتماد على Google Docs أو Microsoft 365 للتحرير التعاوني، تُبقي Collabora المستندات بالكامل على بنيتك التحتية الخاصة، وهو أمر مهم للمؤسسات ذات متطلبات إقامة البيانات أو الخصوصية أو الامتثال.

متى تحتاجه

  • تُشغّل بالفعل Nextcloud أو ownCloud وتريد تحريراً حقيقياً للمستندات والجداول والعروض داخل المتصفح بدلاً من دورة تنزيل-تحرير-إعادة رفع
  • تحتاج تحريراً تعاونياً فورياً متعدد المستخدمين على المستندات دون إرسال الملفات لـ Google Docs أو Microsoft 365
  • لدى مؤسستك متطلبات إقامة بيانات أو امتثال تستبعد تحرير المستندات على خدمة سحابية طرف ثالث
  • تريد استبدال ميزات التحرير السحابي لحزمة مكتبية تجارية ببديل ذاتي الاستضافة ومفتوح المصدر
  • تحتاج معاينة وتحرير خفيف لمستندات بصيغة Office من المتصفح دون تثبيت LibreOffice أو Microsoft Office محلياً

من يحتاجه

  • مديرو Nextcloud وownCloud الذين يريدون إضافة تحرير مستندات داخل المتصفح لتخزين ملفاتهم ذاتي الاستضافة الموجود
  • المؤسسات ذات متطلبات خصوصية البيانات أو التنظيمية التي تحظر إرسال المستندات لخدمات Google أو Microsoft السحابية
  • الفرق والشركات الصغيرة التي تستضيف بالفعل تخزين الملفات ذاتياً وتريد حزمة مكتبية متكاملة بدلاً من اشتراك سحابي منفصل
  • المؤسسات التعليمية التي تُشغّل نسخة Nextcloud خاصة بها وتحتاج تحرير مستندات تعاونياً للطلاب والموظفين
  • الأفراد والمؤسسات المهتمة بالخصوصية الذين يريدون تحكماً كاملاً بمكان معالجة وتخزين مستنداتهم
  • الجهات الحكومية والمنظمات غير الحكومية ذات متطلبات السيادة حول مكان تحرير وتخزين المستندات المكتبية
  • عشاق الاستضافة الذاتية الذين يبنون منظومة سحابة خاصة كاملة ويريدون تحريراً بطراز Google Docs دون حساب Google

حالات الاستخدام الشائعة

  • تحرير مستندات Word وExcel وPowerPoint مباشرة في المتصفح من داخل Nextcloud أو ownCloud
  • التعاون مع الزملاء على مستند بشكل فوري، برؤية مؤشرات وتعديلات بعضهم البعض حياً، دون تبادل الملفات بالبريد الإلكتروني
  • معاينة مستندات مكتبية مشتركة عبر مشاركة ملفات ذاتية الاستضافة دون الحاجة لبرنامج مكتبي مثبّت
  • توفير قدرة تحرير المستندات لقاعدة معرفة داخلية أو ويكي يخزّن الملفات في Nextcloud
  • استبدال التحرير التعاوني في Google Workspace أو Microsoft 365 للمؤسسات المُلزَمة بإبقاء البيانات محلياً
  • منح الفرق البعيدة أو الميدانية وصولاً عبر المتصفح لتحرير مستندات مشتركة دون حزمة مكتبية سطح مكتب كاملة على كل جهاز

الميزات الرئيسية

  • تحرير تعاوني فوري مع رؤية عدة مستخدمين لمؤشرات وتعديلات حية في نفس المستند
  • مبنية على محرك عرض LibreOffice، مما يمنحها توافقاً قوياً مع صيغ .docx وxlsx. وpptx. وodt. وods. وodp.
  • تكامل بروتوكول WOPI مع Nextcloud وownCloud وتطبيقات مضيفة متوافقة أخرى
  • محرر عبر المتصفح لا يتطلب تثبيت برنامج مكتبي للمستخدمين النهائيين الذين يعرضون أو يحرّرون المستندات
  • تحرير المستندات والجداول والعروض التقديمية في حزمة موحدة واحدة، بما يوازي تغطية تطبيقات LibreOffice
  • لوحة تحكم للمسؤول لمراقبة جلسات المستندات النشطة وعدد الاتصالات
  • تعمل بالكامل على بنيتك التحتية الخاصة دون إرسال بيانات مستندات لخدمة سحابية طرف ثالث

كيفية الاستخدام بعد التثبيت

  • ادخل للوحة تحكم المسؤول على https://your-server-ip:9980 (أو عبر وكيلك العكسي) باستخدام بيانات اعتماد المسؤول المُولَّدة من سكريبت التثبيت
  • اضبط متغير البيئة aliasgroup على العنوان الدقيق لنسخة Nextcloud أو ownCloud لديك حتى تكون مخوّلة بالاتصال
  • في Nextcloud، ثبّت تطبيق 'Nextcloud Office' (أو 'Collabora Online') من متجر التطبيقات ووجّهه لعنوان سيرفر Collabora الخاص بك
  • اختبر التحرير بفتح أي ملف .docx أو .xlsx أو .pptx من مستعرض ملفات Nextcloud — يجب أن يفتح في المحرر داخل المتصفح
  • ضع Collabora خلف وكيل عكسي بشهادة TLS صالحة قبل ربطها بنسخة Nextcloud إنتاجية
  • راقب عدد المستندات والاتصالات المتزامنة إذا كنت تستخدم نسخة CODE المجانية، لأنها تفرض حدود استخدام

أفضل ممارسات الأمان

  • لا تكشف المنفذ 9980 مباشرة عبر HTTP عادي أبداً — أنهِ TLS دائماً عند وكيل عكسي أمام Collabora، لأن محتوى المستندات ينتقل عبر هذا الاتصال
  • اضبط aliasgroup بدقة على عنوان Nextcloud/ownCloud الخاص بك — هذا شرط وظيفي وحد أمني في آنٍ واحد يمنع تطبيقات غير مصرح بها من تضمين المحرر
  • غيّر كلمة مرور المسؤول المُولَّدة للوحة تحكم Collabora فوراً وخزّنها بأمان
  • قيّد الوصول للوحة تحكم المسؤول (عادةً على مسار أو منفذ منفصل) على عناوين IP موثوقة فقط، لأنها تكشف معلومات الجلسات والاتصالات
  • حدّث صورة Collabora Online / CODE Docker بانتظام، لأنها تعالج محتوى مستندات قد يكون غير موثوق وتستفيد من تصحيحات الأمان الفورية
  • استخدم HTTPS من طرف لطرف بين المتصفح والوكيل العكسي وNextcloud وCollabora — الإعدادات المختلطة بين HTTP/HTTPS تُسبّب عادةً مشكلات أمنية ووظيفية
  • قيّد أي مستخدمين أو مجموعات في Nextcloud يمكنهم الوصول لتحرير المستندات إذا احتاجت مؤسستك تحكماً دقيقاً بمن يستخدم Collabora

المنافذ وإعدادات جدار الحماية

تستمع Collabora Online (CODE) على منفذ المضيف 9980 لنقطة نهاية الويب ولوحة تحكم المسؤول واكتشاف WOPI — يُعطَّل SSL عمداً داخل الحاوية افتراضياً لأن Collabora مصممة لتقف خلف وكيل عكسي يُنهي TLS نيابة عنها. لا تكشف المنفذ 9980 مباشرة للإنترنت عبر HTTP عادي أبداً، لأن محتوى المستندات وجلسات التحرير ستنتقل دون تشفير. ضع Nginx Proxy Manager أو Caddy أو وكيلاً عكسياً مشابهاً أمامها بشهادة صالحة، وقيّد الوصول المباشر للمنفذ 9980 بجدار ناري بحيث يصل إليه الوكيل العكسي فقط.

النسخ الاحتياطي والصيانة

  • Collabora نفسها عديمة الحالة ولا تحمل بيانات مستندات دائمة — المستندات التي تحرّرها تعيش في Nextcloud أو ownCloud، فانسخها احتياطياً كأولويتك الأساسية
  • انسخ احتياطياً إعدادات Collabora (إعدادات aliasgroup، بيانات اعتماد المسؤول، وأي إعدادات مخصصة) حتى تتمكن من إعادة نشر محرك التحرير مطابقاً بعد أي عطل
  • وثّق إعدادات aliasgroup والتكامل الدقيقة المستخدمة لربط Collabora بتطبيقك المضيف، لأن إعداد ذلك بشكل خاطئ عند الاستعادة يُعطّل الاتصال بصمت
  • اختبر أن تحرير المستندات لا يزال يعمل من طرف لطرف بعد استعادة كل من Nextcloud وCollabora من النسخ الاحتياطية، لا مجرد أن كل خدمة تبدأ التشغيل
  • إذا كنت تُشغّل نسخة Collabora Online المدفوعة، انسخ ملفات الترخيص أو إعدادات التفعيل احتياطياً بشكل منفصل عن إعداد CODE مفتوح المصدر

الأخطاء الشائعة

  • ضبط aliasgroup على عنوان خاطئ (أو تركه كقيمة نائبة) — هذا هو السبب الأشيع لفشل تحميل المحرر
  • كشف المنفذ 9980 مباشرة عبر HTTP عادي بدلاً من وضع وكيل عكسي منهي لـ TLS أمامه
  • نسيان أن Collabora تحتاج تطبيقاً مضيفاً (Nextcloud أو ownCloud أو Seafile) كي تكون مفيدة — دون واحد، لا توجد قائمة ملفات ولا مكان تعيش فيه المستندات
  • خلط HTTP وHTTPS بين المتصفح وNextcloud وCollabora، مما يُسبّب أخطاء محتوى مختلط وفشل تحميل المستندات
  • عدم احتساب حدود استخدام CODE (حوالي عشرة مستندات مفتوحة وعشرين اتصالاً) والتفاجؤ عندما يفشل التحرير تحت حمل فريق متوسط
  • ترك كلمة مرور لوحة تحكم المسؤول الافتراضية دون تغيير بعد التثبيت
  • افتراض أن Collabora تُغني عن كامل وظائف LibreOffice Desktop — التنسيق المتقدم والماكرو وميزات الجداول المعقدة قد تُعرض بشكل مختلف عن التطبيق المكتبي

استكشاف الأخطاء وإصلاحها

  • خطأ "Refused to connect" عند فتح مستند — على الأرجح لا يطابق aliasgroup عنوان Nextcloud/ownCloud بالضبط؛ راجعه بحثاً عن أخطاء إملائية أو اختلاف بروتوكول (http مقابل https)
  • المستند يفتح لكن يظهر فارغاً أو يفشل التحميل — تحقق من وحدة تحكم المتصفح لتحذيرات محتوى مختلط، غالباً بسبب الوصول لـ Collabora عبر HTTP بينما يستخدم Nextcloud HTTPS أو العكس
  • تعذّر الوصول للوحة تحكم المسؤول — تحقق أن المنفذ 9980 قابل للوصول من شبكتك وأنك تستخدم بيانات اعتماد المسؤول المُولَّدة من التثبيت
  • التحرير يعمل لكن التعاون/المؤشرات الحية لا تتزامن — تحقق أن اتصالات WebSocket غير محظورة بإعداد الوكيل العكسي؛ تحتاج Collabora دعم WebSocket للتعاون الفوري
  • "Failed to load Collabora Online" في Nextcloud — تحقق أن تطبيق Collabora Online في Nextcloud يشير لعنوان السيرفر الصحيح شاملاً المنفذ والبروتوكول
  • المحرر يعمل لبعض المستخدمين لا لآخرين — تحقق أن الوكيل العكسي لا يُخزّن استجابات اكتشاف WOPI مؤقتاً، مما قد يُقدّم إعداداً قديماً لبعض العملاء
  • المستندات تفتح ببطء أو تنتهي مهلتها تحت الحمل — قد تكون وصلت لحدود اتصال الفئة المجانية CODE؛ فكّر بنسخة Collabora Online التجارية إذا كان الاستخدام المتزامن مرتفعاً باستمرار

البدائل

ONLYOFFICE Document Server أقرب منافس لـ Collabora، يقدّم توافقاً قوياً مماثلاً مع صيغ Microsoft Office بمحرك عرض مختلف وتكامل Nextcloud/ownCloud خاص به — يختار كثير من مستضيفي الخدمات الذاتيين بينهما بناءً على دقة التنسيق لمستنداتهم المحددة. Nextcloud Office هو تسمية Nextcloud الخاصة لحزمة قائمة على Collabora، فهو ليس بديلاً منفصلاً حقاً بل نسخة مُعبّأة من نفس المحرك. Google Docs وMicrosoft 365 يقدّمان تحريراً تعاونياً مصقولاً ومُداراً بالكامل لكنهما يتطلبان إرسال المستندات لسحابة طرف ثالث، مما يتعارض مع أهداف الاستضافة الذاتية وإقامة البيانات. LibreOffice Desktop (أو Microsoft Office Desktop) تبقى الأداة الصحيحة إذا لم تحتج تحريراً عبر المتصفح أو تعاونياً فورياً إطلاقاً. للتحرير ذاتي الاستضافة عبر المتصفح والمتكامل بإحكام مع Nextcloud، تبقى Collabora وONLYOFFICE الخيارين المفتوحين المهيمنين.

متى لا تستخدمه

تجاوز Collabora إذا كنت لا تُشغّل بالفعل (أو تخطط لتشغيل) تطبيقاً مضيفاً متوافقاً مع WOPI مثل Nextcloud أو ownCloud — بدون واحد، لا تملك Collabora قائمة ملفات ولا شيء لتحريره، فتثبيتها وحدها يُحقّق القليل جداً. إذا كانت احتياجات تحرير المستندات لدى فريقك خفيفة ونادرة، فقد يكون إرسال الملفات كمرفقات أو استخدام عارض مستندات أخف أبسط من تشغيل سيرفر تحرير كامل. إذا احتجت باستمرار عشرات الأشخاص يحرّرون مستندات في آنٍ واحد، ستصبح حدود اتصال نسخة CODE المجانية قيداً حقيقياً — فكّر بفئة Collabora Online المدفوعة أو قيّم ترخيص ONLYOFFICE بدلاً منها. وإذا كانت دقة تنسيق Microsoft Office المثالية للمستندات المعقدة (ماكرو ثقيل، جداول محورية متقدمة) أساسية، اختبر كلاً من Collabora وONLYOFFICE على مستنداتك الفعلية قبل الالتزام، لأن محركات العرض قد تختلف في التفاصيل الدقيقة.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هي Collabora Online؟

Collabora Online حزمة مكتبية ذاتية الاستضافة مبنية على محرك LibreOffice تتيح لك تحرير المستندات والجداول والعروض التقديمية في المتصفح، مع تعاون فوري. إنها محرك تحرير لا مخزن ملفات: تتكامل مع تطبيق مضيف مثل Nextcloud أو ownCloud عبر بروتوكول WOPI، الذي يحمل الملفات والمستخدمين، بينما تعرض Collabora المحرر الحي. هذا التثبيت يُشغّل نسخة CODE المجانية على المنفذ 9980.

هل أحتاج Nextcloud لاستخدامها؟

عملياً، نعم — تحتاج Collabora تطبيقاً مضيفاً كي تكون مفيدة، غالباً Nextcloud أو ownCloud (يعمل Seafile أيضاً). المضيف يخزّن ملفاتك ويوفّر الواجهة؛ وتوفّر Collabora المحرر فقط. دون تطبيق مضيف لا يوجد مكان تعيش فيه المستندات ولا قائمة ملفات لفتحها منها، فتفعل Collabora وحدها القليل جداً.

أي منفذ تستخدم ولماذا SSL معطّل؟

تعمل على منفذ المضيف 9980، منفذها القياسي. يُعطَّل SSL عمداً داخل الحاوية لأن Collabora مصممة لتقف خلف وكيل عكسي يُنهي TLS نيابة عنها. يجب أن تضع Nginx Proxy Manager أو Caddy أو ما شابه أمامها بشهادة حقيقية ولا تكشف المنفذ 9980 مباشرة عبر HTTP عادي أبداً، لأن محتوى المستندات سينتقل دون تشفير.

ما هو aliasgroup ولماذا يهم؟

يُخبر aliasgroup Collabora بالعنوان الدقيق للتطبيق المضيف المسموح له بتضمين محررها. إنه إعداد وظيفي وحد أمني في آنٍ واحد: إذا لم يطابق العنوان عنوان Nextcloud أو ownCloud لديك، يرفض المحرر التحميل بخطأ "refused to connect". اضبطه بدقة على عنوان تطبيقك المضيف — هذا هو الشيء الأكثر شيوعاً الذي يُخطئ فيه الناس أثناء الإعداد.

ما هي حدود CODE مقارنة بالنسخة المدفوعة؟

CODE هي نسخة Collabora Online Development Edition المجانية وتحمل حدود استخدام — حوالي عشرة مستندات مفتوحة وعشرين اتصالاً في آنٍ واحد بشكل عام — مما يجعلها مناسبة للاستخدام الشخصي والفرق الصغيرة لا لمؤسسة كبيرة. تُزيل نسخة Collabora Online المدفوعة تلك الحدود وتضيف دعماً رسمياً وصيانة طويلة المدى. إذا كان لديك باستمرار محررون متزامنون كثيرون، فتلك هي النقطة للنظر في النسخة التجارية أو ONLYOFFICE.