كيفية نسخ ملفات تكوين Collabora CODE احتياطيًا واستعادتها بأمان

تم إصدار Collabora Online Development Edition (CODE) 26.04.4.2 في 24 سبتمبر 2026. يُعد هذا الأمر بالغ الأهمية لتخطيط النسخ الاحتياطي، حيث أن إصدار 26.04 قد غيّر أيضًا بعض جوانب معالجة مسار الخادم الوكيل العكسي الموصى به لعناوين URL الخاصة بـ WebSocket الأحدث. إذا كنت تستعد للترقية أو الترحيل أو استعادة النظام في حالة الكوارث، فقد لا يكون نسخ ملف XML واحد احتياطيًا كافيًا لإعادة إنشاء بيئة تشغيل عاملة.

جوهر التحقق واضح: ملف تكوين خادم Collabora الرئيسي موجود /etc/coolwsd/coolwsd.xmlداخل حاوية CODE الرسمية. كما تدعم وثائق Docker الرسمية نسخ هذا الملف من الحاوية، وإعادته إليها، أو ربطه من المضيف. أما الأجزاء المتغيرة فهي كل ما يحيط به: متغيرات بيئة Docker، وربط الملفات، ومفاتيح WOPI، وإنهاء TLS، وتكوين الخادم الوكيل العكسي.

يُقدّم هذا الدليل عملية نسخ احتياطي واستعادة آمنة لكلٍ من عمليات تثبيت الحزم الأصلية وعمليات نشر Docker. وهو يفصل عمداً بين ما تؤكده وثائق Collabora وما يعتمد على عملية النشر الخاصة بك.

ما الذي يجب أن تتضمنه نسخة احتياطية من كود Collabora؟

تم التحقق: /etc/coolwsd/coolwsd.xml هذا هو ملف التكوين الرئيسي لـ Collabora Online. توثق Collabora هذا المسار مباشرةً وتصف الملف بأنه موثق ذاتيًا لخيارات الخادم المتاحة. راجع دليل Collabora Online SDK الرسمي .

يعتمد ذلك على طريقة النشر: قد يتطلب الاسترداد الكامل أيضًا إعادة ضبط الإعدادات المستخدمة لتشغيل الخدمة. بالنسبة لـ Docker، قد يشمل ذلك ملفات Compose YAML، ومتغيرات البيئة، وربط المجلدات، والبيانات السرية، والملفات المُثبّتة من المضيف. أما بالنسبة للتثبيت الأصلي، فقد يشمل ذلك مضيفًا افتراضيًا لخادم وكيل عكسي وشهادات إذا كانت تُدار على نفس الخادم.

الإجراء: قبل إنشاء الأرشيف، دوّن ما إذا كانت نسختك عبارة عن تثبيت حزمة أصلية أو نشر Docker/Compose. لا تفترض أن إجراء الاستعادة نفسه ينطبق على كليهما.

المفاهيم الخاطئة الشائعة قبل البدء

لا يؤدي نسخ ملف coolwsd.xml احتياطيًا إلى نسخ مستندات المستخدم احتياطيًا

عادةً ما يتم ربط برنامج CODE بمنصة تخزين عبر WOPI. وتبقى المستندات تحت سيطرة منصة التخزين تلك، مثل Nextcloud أو أي مضيف WOPI آخر. لذا، فإن استعادة إعدادات CODE لا تستعيد المستندات نفسها.

الإجراء: قم بعمل نسخة احتياطية من مضيف WOPI ومخزن بياناته باستخدام إجراء النسخ الاحتياطي الخاص بهذا المنتج. تعامل مع نسخة CODE الاحتياطية هذه كنسخة احتياطية لإعدادات الخدمة.

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

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

الإجراء: حفظ تعريف النشر والملفات المثبتة على المضيف، وليس فقط نظام ملفات الحاوية.

نسخ ملف coolwsd.xml القديم فوق نسخة أحدث ليس دائمًا هو الحل الأمثل لاستعادة النظام

قد تتغير خيارات التكوين بين إصدارات CODE المختلفة. تُظهر ملاحظات الإصدار الحالية لـ Collabora استمرار التغييرات في الخادم والوكيل في سلسلة 26.04، بما في ذلك توصيات محدّثة للوكيل لعنوان URL المُختصر لـ WebSocket. راجع ملاحظات إصدار CODE 26.04 الرسمية .

الإجراء: سجّل إصدار البرنامج مع كل نسخة احتياطية. عند الاستعادة إلى إصدار مختلف، قارن الملف المحفوظ مع الإصدار الافتراضي للحزمة الجديدة قبل استبداله بالكامل.

الخطوة 1: سجل الإصدار المثبت ونوع النشر

ابدأ بتسجيل معلومات كافية لإعادة إنتاج البيئة. بالنسبة لنشر الحاويات، افحص الحاوية قيد التشغيل وصورتها:

docker ps --filter name=collabora
docker inspect collabora --format '{{.Config.Image}}'
docker inspect collabora --format '{{json .Mounts}}'

إذا كان اسم الحاوية مختلفًا، فاستبدله collaboraوفقًا لذلك. الصورة الرسمية منشورة باسم collabora/code; ويُعرّف Docker Hub حاليًا الصورة 26.04.4.2 في أحدث إصدار. راجع صورة Collabora CODE الرسمية على Docker Hub .

لتثبيت حزمة أصلية، سجّل إصدار الحزمة باستخدام مدير الحزم الذي تستخدمه فعليًا. على سبيل المثال، في دبيان أو أوبونتو:

dpkg-query -W 'coolwsd*' 'collaboraoffice*' 2>/dev/null

الإجراء: حفظ مخرجات الإصدار في نفس دليل النسخ الاحتياطي المحمي الموجود فيه أرشيف التكوين.

الخطوة الثانية: نسخ بيانات التكوين الأساسية وبيانات النشر احتياطيًا

تثبيت الحزم الأصلية

أنشئ مجلد نسخ احتياطي خاص بالجذر فقط، وقم بأرشفة /etc/coolwsdالمجلد بأكمله بدلاً من اختيار ملف XML الرئيسي فقط. هذا يحافظ على أي ملفات إضافية أضافتها حزمة التثبيت أو التخصيصات المحلية.

sudo install -d -m 700 /var/backups/collabora
sudo tar -C /etc -czpf \
  /var/backups/collabora/coolwsd-etc-$(date +%F).tar.gz \
  coolwsd

يقوم هذا الأمر بتغيير المسار عمداً /etcقبل الأرشفة، بحيث يحتوي الأرشيف على coolwsd/مسار نسبي بدلاً من مسار نظام الملفات المطلق.

Docker أو Docker Compose

تنص وثائق Collabora على أن الصورة الرسمية تحتوي على /etc/coolwsd/coolwsd.xmlويمكن للمسؤولين نسخها أو تعديلها أو نسخها مرة أخرى أو تحميلها من خارج الحاوية.

إذا لم يكن الملف مرتبطًا بالفعل بالقرص المضيف، فانسخه للخارج:

sudo install -d -m 700 /var/backups/collabora
docker cp collabora:/etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/coolwsd.xml

بعد ذلك، قم بتسجيل كيفية تكوين الحاوية:

docker inspect collabora --format '{{json .Config.Env}}' \
  > /var/backups/collabora/container-env.json

docker inspect collabora --format '{{json .Mounts}}' \
  > /var/backups/collabora/container-mounts.json

هام: قد تحتوي مخرجات بيئة التشغيل على كلمات مرور، أو بيانات اعتماد وحدة تحكم المسؤول، أو أسماء مضيفين، أو غيرها من المعلومات السرية. لذا، يجب أن تكون هذه الملفات قابلة للقراءة من قِبل المستخدم الجذر فقط، وأن تقوم بتشفير أو حماية النسخ الموجودة خارج المضيف.

إذا كنت تستخدم Docker Compose، فانسخ ملف Compose الأصلي وأي ملفات بيئة أو ملفات سرية مُشار إليها من الجهاز المضيف. تختلف مواقع هذه الملفات باختلاف بيئة النشر، لذا لا يوجد مسار عام يمكن افتراضه بشكل آمن.

الإجراء: تأكد من أن النسخة الاحتياطية تتضمن المصدر الأصلي. إذا coolwsd.xmlكان المجلد مُثبّتًا عبر ربط، فقم بعمل نسخة احتياطية من ملف المضيف. إذا تم توفير الإعدادات عبر متغيرات البيئة، فاحتفظ بإعدادات Compose/run التي تُعرّف هذه المتغيرات.

الخطوة 3: تضمين مفاتيح الإثبات، وتكوين الوكيل، وTLS فقط عند انطباقها

تُعد هذه المكونات مهمة تحديداً لأنها ليست متطابقة في كل عملية تثبيت.

مفتاح إثبات WOPI: تُوثّق Collabora أن عمليات تثبيت RPM وDEB تُنشئ زوج مفاتيح إثبات WOPI تلقائيًا. أما بالنسبة لـ Docker، فلا يُضمّن زوج المفاتيح في الصورة العامة؛ وعند استخدامه، يجب إنشاؤه وتوفيره للحاوية، عادةً عبر وحدة تخزين. يُوثّق الدليل coolconfig generate-proof-keyكيفية إنشاء المفتاح. ولأن مفتاح Docker موجود خارج الصورة غير القابلة للتغيير، فإن فقدان المفتاح المُثبّت على جانب المضيف قد يُغيّر الهوية المُستخدمة لتوقيع إثبات WOPI.

الإجراء: استخدم قائمة نقاط التحميل الخاصة بالحاوية لتحديد موقع نقطة تحميل مفتاح الإثبات على المضيف، وقم بعمل نسخة احتياطية آمنة من ذلك الملف أو المجلد على جانب المضيف. لا تقم بإنشاء مسار جديد إذا لم يكن النشر يستخدم مسارًا.

الخادم الوكيل العكسي: قد يتولى خادم وكيل مثل Apache أو Nginx أو HAProxy أو Traefik أو أي خادم وكيل آخر إدارة اسم المضيف العام، وإنهاء بروتوكول TLS، وتوجيه WebSocket، وقواعد إعادة توجيه الطلبات. في الإصدار CODE 26.04، قامت Collabora بتحديث إرشادات الخادم الوكيل لتتوافق مع عنوان URL المُختصر الجديد لـ WebSocket، مع الإبقاء على خيار احتياطي قديم في بعض الحالات.

الإجراء المطلوب: قم بعمل نسخة احتياطية من إعدادات الوكيل (proxy) الخاصة باسم مضيف Collabora الخاص بك. يعتمد مسار نظام الملفات على نظام التشغيل والوكيل المستخدم، لذا حدده من إعدادات الوكيل النشط بدلاً من نسخ مسار عام من دليل تعليمي.

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

الخطوة الرابعة: التحقق من النسخة الاحتياطية قبل الحاجة إليها

لا يكفي تنفيذ الأمر بنجاح tar. اختبر إمكانية عرض محتويات الأرشيف والتأكد من وجود ملف التكوين الرئيسي المتوقع.

sudo tar -tzf /var/backups/collabora/coolwsd-etc-$(date +%F).tar.gz \
  | grep 'coolwsd/coolwsd.xml'

إنشاء مجموع اختباري للتحقق من خارج المضيف:

cd /var/backups/collabora
sha256sum * > SHA256SUMS

ثم انسخ النسخة الاحتياطية إلى موقع محمي ثانٍ باستخدام نظام النسخ الاحتياطي المعتاد. لا تترك النسخة الوحيدة على نفس الجهاز الذي تقوم بحمايته.

الإجراء: اختبر عملية الاستخراج إلى مجلد مؤقت مرة واحدة على الأقل. وجود نسخة احتياطية لم تقم بفتحها من قبل هو مجرد افتراض.

الخطوة 5: استعادة النظام بشكل متحفظ، ثم التحقق من صحة الخدمة قيد التشغيل

استعادة التثبيت الأصلي

يُفضّل تثبيت نفس إصدار البرنامج أولاً. أوقف الخدمة، واستخرج الملف المضغوط إلى مجلد مؤقت، وقارن الإعدادات المحفوظة بالإعدادات الافتراضية المُثبّتة حديثًا:

sudo systemctl stop coolwsd
sudo mkdir -p /root/collabora-restore
sudo tar -xzf /var/backups/collabora/coolwsd-etc-YYYY-MM-DD.tar.gz \
  -C /root/collabora-restore

sudo diff -u \
  /etc/coolwsd/coolwsd.xml \
  /root/collabora-restore/coolwsd/coolwsd.xml

إذا كانت الإصدارات متطابقة وكنت تنوي استبدالها بالكامل، فاحتفظ أولاً بالدليل الجديد كنسخة احتياطية:

sudo cp -a /etc/coolwsd /etc/coolwsd.pre-restore
sudo cp -a /root/collabora-restore/coolwsd/. /etc/coolwsd/
sudo systemctl start coolwsd

إذا اختلفت الإصدارات، فقم بدمج الإعدادات التي قمت بتغييرها فعلياً بدلاً من استبدال الملف الجديد دون أي تعديل. هذا يجنبك تجاهل الإعدادات الافتراضية الجديدة أو العناصر المطلوبة التي أضافها الإصدار الأحدث.

استعادة نشر Docker

أعد إنشاء الحاوية من نسخة الصورة المسجلة وملف Docker Compose الأصلي أو docker runالتعريف. استعد إعدادات الربط على المضيف، ومفاتيح الإثبات، والملفات الخارجية الأخرى إلى مساراتها الأصلية على المضيف قبل بدء تشغيل الحاوية.

إذا احتفظتَ coolwsd.xmlبالملف داخل الحاوية بدلاً من ربطه مباشرةً، فإنّ الطريقة الموثقة في Collabora تسمح بنسخ الملف مرة أخرى. عملياً، يُعدّ ربط الملف على المضيف أسهل في الاستعادة لأنّ الإعدادات تبقى محفوظة حتى بعد استبدال الحاوية.

الإجراء: استعادة تعريف النشر أولاً، ثم استعادة الملفات التي يشير إليها. هذا يحافظ على اتساق متغيرات البيئة ووحدات التخزين وتكوين XML مع بعضها البعض.

كيفية التأكد من نجاح عملية الاستعادة

لا تحكم على النجاح بمجرد بدء العملية. تحقق من الخدمة من نفس مسار الشبكة الذي يستخدمه العملاء.

للتثبيت الأصلي:

sudo systemctl status coolwsd --no-pager
sudo journalctl -u coolwsd -n 100 --no-pager

بالنسبة لـ Docker:

docker ps --filter name=collabora
docker logs --tail 100 collabora

تُوثّق منصة Collabora /hosting/capabilitiesنقطة النهاية كوسيلة لاسترجاع معلومات، من بينها اسم المنتج المُشغّل وإصداره. اختبرها عبر عنوان URL العام الخاص بك على Collabora باستخدام:

curl -fsS https://office.example.com/hosting/capabilities

استبدل اسم المضيف باسمك. افتح أيضًا مستندًا حقيقيًا من مضيف WOPI وتأكد من أن التحرير والحفظ وإعادة الاتصال تعمل عبر مسار الوكيل العكسي المعتاد.

الإجراء: لا تعتبر عملية الاستعادة مكتملة إلا بعد استجابة نقطة نهاية الإمكانيات وإمكانية فتح مستند فعلي وحفظه.

قائمة التحقق العملية للنسخ الاحتياطي

التوصية النهائية

إنّ خطة استعادة Collabora CODE الأكثر موثوقية لا تعتمد على ملف واحد منسوخ. احتفظ coolwsd.xmlبنسخة CODE الدقيقة وتعريف النشر معًا كمجموعة واحدة قابلة للاستعادة. أضف مفاتيح الإثبات وقواعد الوكيل ومواد TLS فقط في الأماكن التي تستخدمها فيها بنية نظامك فعليًا. عند الترقية، استعد إلى نفس الإصدار كلما أمكن؛ وإذا انتقلت إلى إصدار أحدث، قارن وادمج الإعدادات بدلًا من استبدال الإعدادات الافتراضية الجديدة دون مراجعة.

اعتبارًا من 6 أكتوبر 2026، يُعدّ الإصدار CODE 26.04.4.2 هو الإصدار الحالي وفقًا لملاحظات إصدار Collabora الرسمية 26.04 وبيانات تعريف صورة Docker. يُرجى مراجعة هذه المصادر الرسمية مجددًا قبل أي عملية ترحيل مستقبلية، نظرًا لأن إصدارات الصور وتوصيات البروكسي وخيارات التكوين لا تزال قيد التطوير.