📄 تثبيت ONLYOFFICE Docs — حزمة أوفيس التشاركية المستضافة ذاتياً على Docker
نشر خادم ONLYOFFICE Document Server على Ubuntu باستخدام Docker — حزمة برامج الأوفيس السحابية المتكاملة لتحرير مستندات Word وExcel وPowerPoint تشاركياً في الوقت الفعلي وربطها مع Nextcloud وSeafile.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/onlyoffice/onlyoffice-ubuntu.sh
chmod +x onlyoffice-ubuntu.sh
sudo bash onlyoffice-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/onlyoffice/onlyoffice-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x onlyoffice-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين الدائم لبيانات وسجلات خادم المستندات، وضبط مفتاح التوثيق السري JWT، وتشغيل حاوية ONLYOFFICE على المنفذ 8080.
sudo bash onlyoffice-ubuntu.sh
4 التحقق وربط المنصات
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8080 للتأكد من تشغيل خادم المستندات بنجاح. ثم اضبط إضافة ONLYOFFICE في سيرفر Nextcloud أو Seafile باستخدام نطاقك المشفر ومفتاح JWT.
http://<your-server-ip>:8080/welcome
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8080 | OnlyOffice Document Server (HTTP) |
| 443 | HTTPS (via reverse proxy) |
نظرة عامة
يعد ONLYOFFICE Docs (خادم المستندات Document Server) حزمة مكتبية سحابية متقدمة ومفتوحة المصدر تتيح تحرير المستندات التشاركي في الوقت الفعلي داخل بنيتك التحتية الخاصة. يتميز ONLYOFFICE بتوافقه التام بنسبة 100% مع صيغ Microsoft Office القياسية (.docx و.xlsx و.pptx) وصيغ OpenDocument ونماذج PDF التفاعلية، ويعمل كخدمة مصغرة على المنفذ 8080 تندمج بسلاسة عبر واجهات برمجية مع خوادم التخزين السحابي مثل Nextcloud وownCloud وSeafile وRedmine وWordPress.
لماذا تستخدمه
الاعتماد على حزم الأوفيس السحابية التجارية (مثل Microsoft 365 أو Google Docs) يعرض المستندات السرية والعقود القانونية والبيانات المالية للشركات لاطلاع خوادم الشركات الكبرى، فضلاً عن رسوم الاشتراكات الشهرية المرتفعة لكل مستخدم. تمنحك الاستضافة الذاتية لـ ONLYOFFICE السيادة المطلقة على بياناتك؛ حيث تظل الملفات مخزنة داخل خادمك السحابي الخاص، وتتم معالجة التعديلات بأمان وسرعة فائقة داخل المتصفح، مع إمكانية العمل الجماعي اللحظي على نفس الملف دون أي تسريب للبيانات.
متى تحتاجه
- تدير سحابة Nextcloud أو Seafile وتريد تحرير مستندات Word وExcel وPowerPoint مباشرة داخل المتصفح
- تحتاج مؤسستك إلى توافق تام 100% في التنسيقات والخطوط والجداول مع ملفات Microsoft Office (.docx/.xlsx/.pptx)
- تلتزم بسياسات خصوصية وأمان صارمة (GDPR/HIPAA) تفرض إبقاء كافة المستندات السرية داخل خوادم الشركة
- تحتاج إلى أدوات عمل جماعي متقدمة: التحرير التشاركي اللحظي، وتتبع التغييرات (Track Changes)، والتعليقات، والمحادثة المدمجة
- ترغب في إنشاء وتعبئة نماذج واستمارات PDF الرقمية التفاعلية دون الحاجة لتراخيص برامج تجارية
من يحتاجه
- فرق تقنية المعلومات في الشركات والمؤسسات الباحثة عن بديل خاص وآمن لحزم Google Workspace وOffice 365
- مديرو الأنظمة الذين يديرون خوادم Nextcloud وSeafile للفرق والموظفين العاملين عن بُعد
- المؤسسات القانونية والمالية والطبية التي تتعامل مع مستندات بالغة الحساسية والسرية
- الجامعات والمؤسسات التعليمية لتوفير بيئة تحرير أبحاث ومستندات تشاركية للطلاب والأساتذة
- أصحاب السيرفرات المنزلية لتوفير محررات أوفيس متكاملة ومجانية لأفراد الأسرة
حالات الاستخدام الشائعة
- كتابة وتعديل التقارير الفنية والعقود والمقترحات التشاركية في نفس اللحظة مع أعضاء الفريق داخل Nextcloud
- تحليل الجداول المالية المعقدة والميزانيات مع دعم أكثر من 400 دالة رياضية ورسوم بيانية وجداول محورية (Pivot Tables)
- تصميم وتقديم العروض التقديمية السحابية مع الحركات الانتقالية وملاحظات المحاضر
- إنشاء استمارات ونماذج PDF رقمية تفاعلية قابلة للتعبئة مع التحقق التلقائي من الحقول والتوقيع الرقمي
- مراجعة ومقارنة تعديلات العقود والمستندات باستخدام ميزة تتبع التغييرات والمقارنة المزدوجة
الميزات الرئيسية
- توافق كامل وأصلي مع ملفات Microsoft Office: دعم فائق لـ DOCX وXLSX وPPTX دون أي تشوه في الخطوط أو التنسيق
- نمطان للتحرير التشاركي: النمط السريع (Fast Mode لعرض التعديلات حرفاً بحرف) والنمط الصارم (Strict Mode لقفل الفقرات)
- حزمة مراجعة متكاملة: تتبع التغييرات، التعليقات الموضعية، مقارنة المستندات، سجل الإصدارات، وغرفة محادثة مدمجة
- منشئ ومحرر نماذج PDF رقمية متقدم لإنشاء استمارات قابلة للتعبئة والحفظ المباشر
- نظام إضافات غني: الترجمة الفورية عبر Google/DeepL، تضمين فيديوهات YouTube، محرر الصور، ومولد رموز QR
- معايير أمان مشددة: التوثيق والتحقق من الترويسات عبر رموز JWT المشفرة لمنع الوصول غير المصرح به
- تكامل مباشر وجاهز مع Nextcloud وownCloud وSeafile وMoodle وRedmine وWordPress
- نشر منظم عبر Docker مع ربط مجلدات التخزين الدائم للبيانات والخطوط المخصصة والسجلات
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8080 للتأكد من ظهور صفحة الترحيب لخادم ONLYOFFICE
- اضبط وكيلاً عكسياً مشفراً بـ HTTPS (مثل Nginx أو Caddy) مع شهادة SSL صالحة (مثل https://office.yourdomain.com)
- سجل الدخول كمسؤول في سيرفر Nextcloud، وانتقل لمتجر التطبيقات (Apps) وثبت إضافة ONLYOFFICE الرسمية
- انتقل إلى إعدادات الإدارة في Nextcloud ← قسم ONLYOFFICE وأدخل رابط خادم المستندات المشفر بـ HTTPS
- أدخل المفتاح السري JWT_SECRET (المحدد في ملف docker-compose) في خانة Secret Key في Nextcloud واضغط Save
- افتح أي ملف وورد أو إكسل أو بوربوينت داخل Nextcloud لاختبار التحرير التشاركي السلس داخل المتصفح
أفضل ممارسات الأمان
- تنبيه أمني هام: حدد دائماً مفتاح JWT_SECRET معقد وقوي في متغيرات البيئة لمنع أي مستخدم على الشبكة من إرسال طلبات تحويل غير مصرح بها
- استخدم تشفير HTTPS دائماً عبر وكيل عكسي — حيث تحظر المتصفحات الحديثة تحميل الخوادم غير المشفرة داخل مواقع Nextcloud المشفرة (Mixed Content)
- اقصر الوصول لمنفذ 8080 على الوكيل العكسي والشبكة الداخلية عبر جدار الحماية UFW
- اضبط فلاتر عناوين IP في إعدادات ONLYOFFICE لقبول طلبات التحويل القادمة فقط من عنوان IP سيرفر Nextcloud الخاص بك
- احمِ مجلد البيانات ./data بصلاحيات مناسبة على السيرفر
- حدّث صورة الحاوية onlyoffice/documentserver دورياً للحصول على التحديثات الأمنية وإصلاحات التوافق
المنافذ وإعدادات جدار الحماية
يستمع خادم ONLYOFFICE على منفذ TCP 8080 (أو 8110). في الإنتاج، يجب تهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 وربطه بـ 8080، مع إبقاء المنفذ 8080 مغلقاً في جدار الحماية الخارجي. وتأكد من قدرة سيرفر Nextcloud على الاتصال بسيرفر ONLYOFFICE عبر المنفذ المشفر 443.
النسخ الاحتياطي والصيانة
- انسخ مجلد ./data (/var/www/onlyoffice/Data) احتياطياً، والذي يحتوي على الخطوط المخصصة وملفات التراخيص والشهادات
- احتفظ بنسخة من رمز JWT_SECRET وإعدادات الوكيل العكسي
- ملاحظة: المستندات الحقيقية تُحفظ في نظام التخزين السحابي (مثل Nextcloud)؛ تأكد من أخذ نسخ احتياطية دورية لسحابة Nextcloud
- أتمت النسخ الاحتياطي لمجلد الإعدادات إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية والتأكد من فتح وتعديل المستندات بنجاح
الأخطاء الشائعة
- محاولة ربط خادم ONLYOFFICE يعمل بـ HTTP غير مشفر بموقع Nextcloud يعمل بـ HTTPS، مما يسبب حظر التحميل من المتصفح (Mixed Content Error)
- تعطيل نظام المصادقة JWT (JWT_ENABLED=false)، مما يترك خادم المستندات مكشوفاً لأي شخص على الشبكة
- عدم تطابق المفتاح السري JWT_SECRET بين ملف السيرفر وإعدادات إضافة ONLYOFFICE في Nextcloud
- تشغيل ONLYOFFICE على سيرفر بذاكرة أقل من 2 جيجابايت، مما يسبب انهيار خادم التحويل عند فتح الملفات الكبيرة
- عدم ربط مجلد التخزين الدائم ./data، مما يؤدي لفقدان الخطوط المخصصة والتكوينات عند تحديث الحاوية
استكشاف الأخطاء وإصلاحها
- ظهور خطأ 'Error when trying to connect' في Nextcloud — تأكد من صحة إعدادات الوكيل العكسي وتطابق رمز JWT_SECRET في السيرفر وNextcloud
- فشل حفظ التعديلات في المستند — تأكد من قدرة كل من سيرفر Nextcloud وسيرفر ONLYOFFICE على الوصول لبعضهما عبر الشبكة والـ DNS
- الخطوط العربية أو المخصصة لا تظهر — ضع خطوطك (ملفات .ttf) في مجلد /root/docker/onlyoffice/data/fonts ونفذ: docker exec onlyoffice documentserver-generate-all-fonts.sh
- استهلاك معالج مرتفع — راجع عدد عمال التحويل وتأكد من توفر نواتين للمعالج على الأقل
- فشل بدء الحاوية — افحص سجلات الحاوية بالأمر: docker logs onlyoffice -f لمعرفة تفاصيل أخطاء التشغيل
البدائل
حزمة Collabora Online (المعتمدة على نواة LibreOffice) هي البديل مفتوح المصدر الأساسي، وتتميز بتوافقها الأصلي مع صيغ ODF واستهلاك أقل للذاكرة. حزمة Nextcloud Office هي التوزيعة المدمجة لـ Collabora داخل Nextcloud. حزم Microsoft 365 وGoogle Docs بدائل سحابية تجارية مغلقة. منصة CryptPad توفر تحريراً تشاركياً مشفراً بالكامل من طرف لطرف.
متى لا تستخدمه
تجنب استخدام ONLYOFFICE إذا كانت مؤسستك تعمل حصرياً بصيغ OpenDocument (.odt/.ods) وتفضل الواجهة الكلاسيكية لـ LibreOffice (حيث تعد Collabora Online أنسب لهذه الاستخدامات). وإذا كنت تحتاج فقط لتحرير نصوص وملاحظات بسيطة بـ Markdown دون الحاجة لحسابات إكسل معقدة، فإن تطبيقات مثل CryptPad أو Nextcloud Text أخف بكثير.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين ONLYOFFICE وCollabora Online؟
يقوم ONLYOFFICE بمعالجة المستندات داخل المتصفح عبر HTML5 Canvas مع توافق كامل 100% مع صيغ Microsoft Office (.docx و.xlsx). بينما يقوم Collabora بمعالجة الملفات على السيرفر باستخدام نواة LibreOffice وهو أنسب لصيغ OpenDocument (.odt و.ods).
لماذا يعد المفتاح السري JWT Secret ضرورياً في ONLYOFFICE؟
يعمل مفتاح JWT كرمز تشفير مشترك بين Nextcloud وONLYOFFICE. ويضمن أن الطلبات المعتمدة القادمة فقط من سيرفر Nextcloud الخاص بك هي التي تستطيع فتح وتحرير وحفظ الملفات، مما يمنع الغرباء من استغلال الخادم.
هل يتطلب ONLYOFFICE شهادة HTTPS للربط مع Nextcloud؟
نعم، تحظر المتصفحات الحديثة تحميل إطارات العمل غير المشفرة (HTTP) داخل مواقع مشفرة (HTTPS). يجب وضع ONLYOFFICE خلف وكيل عكسي مع شهادة SSL ليعمل التحرير داخل Nextcloud بسلاسة.
هل يمكن لعدة مستخدمين تحرير نفس الملف في نفس الوقت؟
نعم، يدعم ONLYOFFICE التحرير التشاركي اللحظي بنمطين: 'النمط السريع' يعرض تعديلات الزملاء فورياً حرفاً بحرف، بينما 'النمط الصارم' يقفل الفقرة التي يعدلها المستخدم حتى يضغط على حفظ.
كم يستهلك ONLYOFFICE من الذاكرة العشوائية (RAM)؟
يستهلك خادم مستندات ONLYOFFICE (الذي يشمل محركات Node.js وقاعدة بيانات PostgreSQL وRabbitMQ) ما بين 1.2 إلى 2.5 جيجابايت من الذاكرة العشوائية اعتماداً على عدد المستندات المفتوحة في نفس الوقت.
