استعادة إعدادات Collabora CODE دون فقدان تغييرات النشر

قد يُعاد تشغيل حاوية Collabora CODE بالإعدادات الافتراضية بعد إعادة بنائها، أو قد يؤدي عطل في الخادم إلى فقدان نسخة عاملة من إعداداتها. لذا، يُرجى نسخ coolwsd.xmlملفات الإعدادات النشطة وملفات النشر احتياطيًا. ثم استعادتها إلى نفس المصدر الدائم، وتحقق من صحة الملف والخدمة قبل أن يستأنف المستخدمون التحرير.

الملف الرئيسي عادةً ما يكون /etc/coolwsd/coolwsd.xml. يختلف مصدر البيانات الموثوقة باختلاف طريقة التثبيت (الحزمة، Docker، Helm)، لذا حدد طريقة التثبيت قبل نسخ أي شيء.

1. ابحث عن مصدر التكوين النشط

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

sudo ls -l /etc/coolwsd/coolwsd.xml
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
docker exec collabora-code ls -l /etc/coolwsd/coolwsd.xml

استبدل collabora-codeهذا باسم حاويتك الفعلي. توضح وثائق Collabora وDocker مسارات النشر هذه، كما يعرض مخطط Helm الخاص بها إعدادات على مستوى المخطط. راجع وثائق إصدارك؛ فقد تختلف الإعدادات الافتراضية وسلوك النشر بين الإصدارات.

2. قم بعمل نسخة احتياطية من ملفات XML وملفات النشر

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

لتثبيت الحزمة، احتفظ ببيانات تعريف الملف:

sudo install -d -m 700 /var/backups/collabora/$(date +%F)
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/$(date +%F)/coolwsd.xml
sudo stat /var/backups/collabora/$(date +%F)/coolwsd.xml

بالنسبة لـ Docker، انسخ الملف المباشر من الحاوية إلى المضيف:

mkdir -p ~/backups/collabora/$(date +%F)
docker cp collabora-code:/etc/coolwsd/coolwsd.xml \
  ~/backups/collabora/$(date +%F)/coolwsd.xml
chmod 600 ~/backups/collabora/$(date +%F)/coolwsd.xml

إذا كان ربط المجلد يوفر الملف، فقم بعمل نسخة احتياطية من مصدره على المضيف أيضًا؛ فهذا هو الملف الذي قد يستبدل أي تعديل داخل الحاوية عند إعادة التشغيل. احتفظ بملف Compose وأي .envملف مُشار إليه في نفس مجموعة النسخ الاحتياطية المحمية. بالنسبة إلى Helm، احفظ ملف القيم وهوية الإصدار، بالإضافة إلى الأسرار أو خرائط التكوين المُدارة بشكل منفصل باستخدام عملية إدارة الأسرار الحالية لديك.

3. اجعل النسخة الاحتياطية قابلة للتكرار

سجّل علامة صورة CODE أو إصدار الحزمة، واسم الحاوية، ومصدر التثبيت، وتاريخ النسخ الاحتياطي. يمكن استخدام هذه المعلومات cp -aفي تثبيت الحزم للحفاظ على البيانات الوصفية. قد تختلف ملكية ملفات الحاوية عن ملكية المضيف، لذا لا تفترض أن مالك المضيف أو وضع التثبيت مناسب لكل إصدار من الصورة.

بالنسبة لـ Compose، حدد ما إذا كان ملف أو مجلد كامل مُثبّتًا في المسار المحدد /etc/coolwsd. قد يؤدي تثبيت مجلد إلى إخفاء الملفات الموجودة في الصورة؛ وقد يؤدي عدم اكتمال المجلد إلى عدم توفر الملفات المتوقعة. انسخ احتياطيًا كل ملف في المجلد المُثبّت الذي يعتمد عليه CODE. احتفظ بإعدادات البيئة بشكل منفصل واحمي البيانات السرية.

بالنسبة لـ Helm، لا تعتمد على تعديل وحدة pod المُنشأة: فالتحديثات قد تُعيد إنشائها. احتفظ بقيم المخطط وأي سر خارجي أو ConfigMap. يدعم مخطط Collabora الأصلي محتوى التكوين من خلال القيم، لذا فإن مصدره المُعلن عنه قد يكون أكثر موثوقية من نسخة من وحدة pod قيد التشغيل.

4. استعادة البيانات إلى المصدر الدائم

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

sudo systemctl stop coolwsd
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml.before-restore
sudo cp /var/backups/collabora/2026-10-09/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml
sudo chown root:cool /etc/coolwsd/coolwsd.xml
sudo chmod 640 /etc/coolwsd/coolwsd.xml
sudo systemctl start coolwsd

قد لا يتطابق مالك العينة ومجموعتها مع حزمتك. تحقق من الملف الحالي statواحتفظ بملكيته ووضعه المتوقعين بدلاً من تطبيق قيم العينة بشكل أعمى. بالنسبة للحاوية المُثبّتة، ​​استعد ملف المضيف واتبع سير عمل إعادة تشغيل Compose أو إعادة إنشائها. إذا كانت صورة مخصصة أو قيمة Helm توفر التكوين، فقم بتحديث هذا المصدر وأعد النشر؛ لن يتم حفظ تعديل الحاوية القابلة للتصرف.

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

5. تحقق قبل إعادة فتح التحرير

تأكد من وجود الملف، وإمكانية قراءته بواسطة الخدمة، وأنه بتنسيق XML سليم. في حال تثبيته، xmllintيتحقق من بناء الجملة.

xmllint --noout /etc/coolwsd/coolwsd.xml

يؤكد هذا صحة بنية XML فقط؛ ولا يثبت أن جميع الخيارات مدعومة في إصدار الكود الخاص بك. راجع سجلات النظام بحثًا عن أخطاء التحليل، وتأكد من استمرار تشغيل الخدمة. بالنسبة للحاويات، تحقق docker compose psمن السجلات الحديثة. بالنسبة للحزم، تحقق systemctl status coolwsdمن سجل النظام.

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

• تأكد من تطابق إصدار النسخة الاحتياطية مع عملية النشر.
• تأكد من أن قيم mount أو Helm تشير إلى المصدر المستعاد.
• تأكد من نجاح تحليل XML وبدء تشغيل الخدمة.
• اختبر عملية الفتح والحفظ من خلال منصة التخزين المتصلة.

المراجع الرسمية

• وثائق تكوين Collabora عبر الإنترنت
• توثيق صور Docker لـ Collabora CODE
• قيم مخطط Helm العلوي لـ Collabora
• توثيق عمليات ربط Docker