Technical Anshu
Tutorials Blog
📄 إعداد OnlyOffice + Nextcloud

قم بتثبيت OnlyOffice Document Server وتوصيله بـ Nextcloud

يقوم Nextcloud الخاص بك بتخزين الملفات ولكن لا يمكنه تحرير المستندات بشكل صحيح. يعد OnlyOffice Document Server هو محرك التحرير المفقود - إليك تثبيت Docker الكامل بالإضافة إلى إعداد الموصل الذي يربط الاثنين، مع خطأ المفتاح السري الوحيد الذي يعطل معظم المحاولات الأولى.

✍️ Technical Anshu🐧 Linux Server + Docker⏱️ One sitting setup
🎥 شاهد عملية التثبيت والتكامل الكاملة في الفيديو أعلاه خطوة بخطوة

يمنحك Nextcloud وحده التخزين والمشاركة، لكن فتح ملف Word أو Excel بداخله يحتاج إلى محرر حقيقي. هذا المحرر هو OnlyOffice Document Server — وهي خدمة ثانية تستضيفها بنفسك، والتي يتحدث إليها Nextcloud من خلال تطبيق موصل صغير. يسلك هذا الدليل المسار الدقيق من الفيديو: قم بتثبيت خادم المستندات باستخدام Docker، ثم قم بتوصيله بـ Nextcloud. تحذير واحد صادق قبل أن نبدأ - يعد Document Server خدمة ثقيلة الوزن، وليس مكونًا إضافيًا صغيرًا. أعطها خادمًا مناسبًا وعنوانًا خاصًا بها، وستسير بقية هذه الصفحة بسلاسة.

Nextcloud — Settings — ONLYOFFICE (connector app)
Document Server addresshttps://office.example.com
Secret keymust match JWT_SECRET on the server
Connection check on SaveOK
Editor opens inside NextcloudDocs, Sheets, Slides
لوحة إعدادات الموصل داخل Nextcloud — القيم التوضيحية موضحة كمثال.
1

افهم أولاً القطعتين

يوجد خادمان منفصلان في هذا الإعداد، ومعظم الالتباس يأتي من الخلط بينهما. يقوم Nextcloud بتخزين ملفاتك ومستخدميك ومشاركتك - ولا يقوم أبدًا بتحرير مستند بنفسه. يعد OnlyOffice Document Server (يسمى أيضًا OnlyOffice Docs) هو محرك التحرير — فهو يعرض محرر المستندات في المتصفح، ويطبق كل ضغطة على المفتاح، ويرسل الملف النهائي مرة أخرى إلى Nextcloud للحفظ.

يعد تطبيق الموصل داخل Nextcloud بمثابة الجسر بينهما. فهو يخبر Nextcloud بمكان وجود خادم المستندات ويثبت، باستخدام مفتاح سري مشترك، أنه يُسمح للخادمين بالتحدث مع بعضهما البعض. عندما ينقر المستخدم على ملف Word أو Excel، يتم تحميل المحرر فعليًا من خادم المستندات بينما يظل الملف مخزنًا في Nextcloud.

2

قم بإعطاء خادم المستندات عنوانه الخاص

يحتاج خادم المستندات إلى عنوان الخادم أو النطاق الفرعي الخاص به، على سبيل المثال office.example.com، منفصلاً عن عنوان Nextcloud الخاص بك مثل cloud.example.com. قم بإنشاء سجل DNS أولاً واتركه يشير إلى الجهاز الذي سيقوم بتشغيل OnlyOffice. إن محاولة إخفاء كلتا الخدمتين تحت عنوان واحد باستخدام المسارات هو المكان الذي تتعطل فيه معظم عمليات التثبيت الأولى، لذا اجعل الأمر بسيطًا: اسم واحد لـ Nextcloud، واسم واحد لخادم المستندات.

3

قم بتثبيت خادم المستندات باستخدام Docker

المسار الموضح في الفيديو هو تثبيت Docker على خادم Linux، وهو أيضًا المسار الرسمي لمستندات OnlyOffice. أمر واحد يبدأ كل شيء:

  1. تأكد من تثبيت Docker وتشغيله على الخادم
  2. اختر سرًا عشوائيًا طويلًا — يصبح هذا هو المفتاح المشترك بين الخادمين
  3. قم بتشغيل الحاوية التي تحتوي على مجموعة أسرارك بشكل صريح:

sudo docker run -i -t -d -p 80:80 --restart=always -e JWT_SECRET=your-own-secret-here -v /app/onlyoffice/logs:/var/log/onlyoffice -v /app/onlyoffice/data:/var/www/onlyoffice/Data -v /app/onlyoffice/lib:/var/lib/onlyoffice onlyoffice/documentserver

إعداد JWT_SECRET بنفسك ليس زخرفة اختيارية. إذا تخطيته، تولد الحاوية سرًا عشوائيًا - ومنذ الإصدار 7.2، يتم إعادة إنشاء هذا السر عند كل عملية إعادة تشغيل، مما يؤدي إلى قطع اتصال Nextcloud بصمت بعد إعادة التشغيل الأولى. تحتفظ وحدات التخزين الثلاثة -v بالسجلات والشهادات وذاكرة التخزين المؤقت خارج الحاوية حتى لا يؤدي التحديث إلى مسحها.

4

تحقق من أن خادم المستندات نشط

امنح الحاوية بضع دقائق للبدء، ثم افتح http://office.example.com في المتصفح. من المفترض أن تشاهد صفحة الترحيب الخاصة بـ OnlyOffice Docs لتأكيد تشغيل الخدمات. يمكنك أيضًا التحقق من الخادم باستخدام sudo docker ps — يجب إدراج الحاوية onlyoffice/documentserver على أنها أعلى. لا تنتقل إلى Nextcloud حتى يتم تحميل هذه الصفحة؛ يؤدي الاتصال بخادم ميت إلى حدوث أخطاء مربكة لاحقًا.

5

قم بتثبيت تطبيق Connector في Nextcloud

انتقل الآن إلى Nextcloud. قم بتسجيل الدخول كمسؤول، وافتح قسم التطبيقات، وابحث عن ONLYOFFICE، ثم قم بتثبيت تطبيق الموصل الرسمي وتمكينه. هذا التطبيق مجاني ويتم نشره في متجر تطبيقات Nextcloud - ولا يوجد شيء لتحميله يدويًا.

6

أدخل العنوان والمفتاح السري

افتح الإعدادات → ONLYOFFICE في Nextcloud واملأ شيئين:

  1. عنوان خادم المستندات — العنوان من الخطوة 2، على سبيل المثال https://office.example.com
  2. المفتاح السري — نفس القيمة التي مررتها كـ JWT_SECRET تمامًا عند بدء تشغيل الحاوية. حرف واحد مختلف وتم رفض الاتصال
  3. اضغط على حفظ — يقوم الموصل باختبار الاتصال على الفور والإبلاغ عما إذا كان ناجحًا

إذا نجح الحفظ، يصبح التكامل مباشرًا. إذا فشلت، تخبرك رسالة الخطأ بالجانب الذي يجب التحقيق فيه - مشكلة في العنوان، أو عدم تطابق سري (يحتوي خطأ JWT على دليل تفصيلي خاص به مرتبط بصفحات الحالة الخاصة بنا).

7

افتح مستندًا واختبر تحريرًا حقيقيًا

انتهي باختبار حقيقي، وليس مجرد علامة خضراء. قم بتحميل ملف Word أو Excel إلى Nextcloud، وانقر فوقه، وتأكد من فتح محرر OnlyOffice. اكتب شيئًا ما، وأغلق المستند، وانتظر بضع ثوانٍ حتى تكتمل عملية الحفظ، ثم قم بتنزيل الملف للتحقق من وجود التعديل بداخله. حاول أيضًا فتح نفس المستند في ملف تعريف متصفح ثانٍ - يجب أن يُظهر التحرير المشترك كلا المؤشرين. إذا نجح كل ذلك، فسيكون مكتبك المستضاف ذاتيًا جاهزًا للفريق.

🔴 يرتكز التكامل بالكامل على سر واحد. يجب أن يكون JWT_SECRET في أمر Docker والمفتاح السري في إعدادات موصل Nextcloud متطابقين، حرفًا بحرف. عدم التطابق هو السبب الأول وراء رفض التثبيت الجديد الاتصال - وإذا سمحت للحاوية بإنشاء سر عشوائي بدلاً من تعيين سر خاص بك، فسوف ينقطع الاتصال من تلقاء نفسه عند إعادة تشغيل الخادم التالية.

🎥 شاهد الإعداد الكامل في الفيديو

يتم عرض التثبيت الكامل لـ OnlyOffice Document Server وتكامل Nextcloud مباشرة خطوة بخطوة.

▶️ Watch Full Video
❓ الأسئلة الشائعة (الأسئلة الشائعة)

هل خادم المستندات OnlyOffice مجاني للاستضافة الذاتية؟

إن الإصدار المجتمعي من OnlyOffice Docs وتطبيق موصل Nextcloud مجانيان للتثبيت والاستخدام. تم تصميم الإصدار المجاني للفرق الصغيرة وله حدود مقارنة بإصدارات Enterprise المدفوعة - تحقق من صفحة الحدود الحالية لإصدارك قبل التخطيط لعملية طرح كبيرة.

هل يمكن تشغيل OnlyOffice وNextcloud على نفس الخادم؟

نعم، يتم تشغيل العديد من الإعدادات الصغيرة على جهاز واحد، باستخدام Document Server في Docker والنطاق الفرعي الخاص به. فقط تذكر أن خادم المستندات متعطش للموارد: يحتاج الجهاز إلى ما يكفي من ذاكرة الوصول العشوائي ووحدة المعالجة المركزية الاحتياطية لكلا الخدمتين، وإلا سيكون التحرير بطيئًا للجميع.

لماذا يطلب الموصل مفتاحًا سريًا؟

يقوم السر بتسجيل الطلبات بين Nextcloud وخادم المستندات (JWT)، لذلك لا يمكن لموقع ويب عشوائي أن يطلب من خادم المستندات الخاص بك فتح الملفات أو تحويلها. يجب أن يحتفظ كلا الجانبين بنفس السر - تلك القيمة المشتركة هي ما يثبت ثقة الخادمين ببعضهما البعض.

يعتمد هذا الدليل على فيديو Anshu الفني حول تثبيت OnlyOffice Document Server مع Nextcloud • هل أنت عالق في خطوة؟ اسأل في تعليقات الفيديو — سوف تحصل على إجابة هناك 🙏