تعطيل عمليات التحقق من تحديثات كود Collabora والاتصالات غير المرغوب فيها

لإيقاف برنامج Collabora Online Development Edition (CODE) من إجراء فحص الإصدار المُجدول، اضبط الإعدادات على fetch_update_checkو 0. بالنسبة للنشر الذي يجب ألا يتصل بخدمات خارجية غير معتمدة، قم أيضًا بتعطيل عمليات التكامل غير المستخدمة وفرض قائمة السماح الصادرة على حدود الشبكة؛ إخفاء إشعارات التحديث وحده لا يحظر حركة مرور الشبكة.allow_update_popupfalse

اعرف ما الذي تقوم بتعطيله

اعتبارًا من أكتوبر 2026، تُشير وثائق Collabora المُحدّثة إلى coolwsd.xml.inوجود فاصل زمني للتحقق من التحديثات مدته 10 ساعات، وعنصر تحكم منفصل لإشعارات التحديثات. لكنها لا تُوثّق مفتاحًا عامًا واحدًا مُسمى "تعطيل القياس عن بُعد". طلب ​​التحديث، والتحرير السحابي الاختياري، وسجلات التشخيص المحلية، واتصال WOPI الأساسي بخادم تخزين المستندات، كلها أمور مختلفة. التعامل معها كإعداد واحد قد يُبقي الاتصالات نشطة أو يُعطّل تحرير المستندات.

تنطبق هذه التعليمات بشكل أساسي على collabora/codeنشر Docker المستقل. تستخدم عمليات تثبيت الحزم نفس مفاهيم التكوين، ولكنها عادةً ما تتطلب تعديل الخدمة /etc/coolwsd/coolwsd.xmlوإعادة تشغيلها coolwsd. قد تُعيد عمليات تثبيت التعليمات البرمجية المدمجة التي تُدار بواسطة منتج آخر إنشاء خيارات التشغيل؛ لذا يُنصح بتغييرها في المنتج المُدير بدلاً من تعديل الملفات المؤقتة.

1. حدد إعدادات التشغيل واحتفظ بنسخة احتياطية.

حدد أولاً ما إذا كانت خدمة CODE الخاصة بك مُهيأة عبر Docker Compose، أو docker runأمر، أو حزمة أصلية. بالنسبة لـ Docker، افحص الحاوية وبيئتها الحالية دون نشر المخرجات علنًا، لأن متغيرات البيئة قد تحتوي على بيانات اعتماد.

docker ps --format 'table {{.Names}}	{{.Image}}'
docker inspect --format '{{range .Config.Env}}{{println .}}{{end}}' code

استبدل codeهذا باسم الحاوية الفعلي. احفظ نسخة آمنة من ملف النشر أو الملف الحالي coolwsd.xmlقبل إجراء أي تعديل. إذا كان تكوين Compose الخاص بك يتضمن بالفعل إنهاء TLS أو سماحات مضيف WOPI أو معلمات المصادقة، فاحتفظ بهذه القيم.

2. تعطيل اتصال التحديث الدوري

لـ Docker Compose

أضف هذه الخيارات إلى القيمة الموجودة extra_paramsضمن قسم خدمة CODE environment. هذا جزء من ملف Compose، وليس ملفًا بديلًا كاملًا.

services:
  code:
    environment:
      extra_params: >-
        --o:fetch_update_check=0
        --o:allow_update_popup=false

ادمج العلامتين مع أي extra_paramsعلامات موجودة بدلاً من استبدالها. ثم أعد إنشاء خدمة CODE فقط docker compose up -d --no-deps --force-recreate codeباستخدام اسم خدمة Compose الحقيقي. عند إعادة إنشاء الحاوية docker run، أضف نفس الخيارات إلى متغير البيئة.extra_params

لحزم لينكس

قم بالتحرير /etc/coolwsd/coolwsd.xml. حدد العناصر الموجودة وقم بتغيير قيمها مع الاحتفاظ بخصائصها الأصلية:

<fetch_update_check>0</fetch_update_check>
<allow_update_popup>false</allow_update_popup>

إذا كانت العناصر الموجودة تحتوي على سمات، فاحتفظ بها وقم بتغيير قيم النصوص فقط. تأكد من أن الملف بتنسيق XML صالح قبل إعادة التشغيل؛ على سبيل المثال، استخدم الأمر المناسب xmllint --noout /etc/coolwsd/coolwsd.xmlإذا xmllintكان مثبتًا. أعد التشغيل باستخدام الأمر المناسب sudo systemctl restart coolwsd.

هام: allow_update_popup=false هذا الإعداد يُعطّل إشعار التحديث الخاص بالمحرر؛ وهو ليس أداة للتحكم في الخروج. fetch_update_check=0يُعنى هذا الإعداد بالفحص المُجدول. يجب على مؤسستك الاستمرار في متابعة التحديثات الأمنية من خلال عملية الصيانة الدورية.

3. قم بإيقاف تشغيل الخدمات الاختيارية التي يمكنها الاتصال بمضيفين آخرين

راجع الإعدادات النشطة لعمليات التكامل عن بُعد. في الإعدادات الحالية، يكون التدقيق اللغوي عن بُعد باستخدام LanguageTool أو Duden مُعطّلاً افتراضيًا، كما أن مفاتيح AI وDeepL على مستوى الخادم مُعطّلة افتراضيًا أيضًا. قد يكون أحد المسؤولين أو أحد عمليات التكامل قد فعّلها. إذا كانت هذه الخيارات موجودة في إصدار CODE المُثبّت لديك، فاحتفظ بها مُعطّلة إذا لم تكن بحاجة إليها.

--o:languagetool.enabled=false
--o:ai.enabled=false
--o:deepl.enabled=false

قم بتضمين الخيارات المدعومة فقط من قِبل الإصدار المُثبّت لديك، وادمجها extra_paramsبدلاً من إنشاء قيمة ثانية مُتعارضة. يُمكن ضبط التأثيرات نفسها في الأقسام المُطابقة من <languagetool>ملف XML الأصلي.<ai><deepl>

افحصها remote_config.remote_urlجيدًا remote_font_config.urlقبل حذفها. يؤدي وجود عنوان URL فارغ لتكوين النظام عن بُعد إلى تجنب جلب التكوين الاختياري؛ بينما قد يشير عنوان URL لخط النظام عن بُعد بشكل صحيح إلى تثبيت Nextcloud الخاص بك. قد يؤثر حذفه على تنسيق الخطوط في المستندات، لذا احتفظ به إذا كانت خدمة الخطوط معتمدة ومطلوبة. كذلك، افحص أي عناوين WebSocket مُكوّنة للمراقبة وأي إضافات أخرى، مثل مدير الاقتباسات، وفقًا لاحتياجات نظامك.

يُعدّ تسجيل البيانات مسألة خصوصية منفصلة، ​​وليس دليلاً على استخدام بيانات خارجية. راجع الإعدادات logging.docstatsإذا logging.userstatsكنت logging.anonymize.anonymize_user_dataترغب في تقييد المعرّفات المحلية في التشخيص. احتفظ بسجلات كافية للأمان والتشغيل لتحديد المشكلات وحلها؛ تغيير مستوى تفصيل السجلات لا يمنع الاتصالات الصادرة.

4. تقييد حركة المرور الصادرة دون الإخلال بسياسة WOPI

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

لا تقم بتعطيل الشبكة بشكل عشوائي أو ضبط إعدادات شبكة Docker على internal: true":"، فقد يؤدي ذلك، بحسب بنية نظامك، إلى منع CODE من الوصول إلى خادم WOPI الخاص به أو تعطيل عمليات التكامل المطلوبة. تذكر أيضًا أن متصفح المستخدم يقوم بتحميل موارد المحرر وقد يرسل طلبات بشكل مستقل عن خادم CODE؛ فقواعد جدار حماية الخادم لا تتحكم في المتصفح.

بالنسبة لتثبيتات Docker Engine التي تستخدم واجهة iptables الخلفية، تُوثّق Docker أن DOCKER-USERسلسلة قواعد التوجيه هي المكان المُخصّص لقواعد توجيه المسؤول. أما مع واجهة nftables الخلفية، فيُرجى إنشاء سلسلة أساسية منفصلة بدلاً من افتراض DOCKER-USERوجودها. صمّم قواعد لشبكة الجسر أو شبكة الحاويات الفعلية، وبروتوكولي IPv4 وIPv6، ونظام أسماء النطاقات (DNS)، وحالة الاتصال، وحركة مرور WOPI المشروعة؛ يُمكنك استخدام قاعدة عامة مُلصقة DROPلتعديلها دون اتصال بالإنترنت. راجع إرشادات Docker الخاصة بـ iptables وإرشادات Docker الخاصة بـ nftables قبل تطبيق أي سياسة.

5. تحقق من التغييرات، بما في ذلك نشاط الشبكة الفعلي

بعد إعادة التشغيل أو إعادة إنشاء الحاوية، افحص سجلات بدء التشغيل بحثًا عن أخطاء في التكوين، واختبر فتح مستند وتحريره وحفظه من خلال التكامل المعتاد للتخزين. لا يُعدّ استجابة المحرر وحدها دليلًا على توقف جميع الطلبات غير المصرح بها. تحقق من معلمات بدء التشغيل، ثم راجع سجلات نظام أسماء النطاقات (DNS) وسجلات الاتصالات الصادرة من جدار الحماية أو خادم الوكيل الصادر أو شبكة الحاوية أثناء بدء التشغيل وتحرير المستندات.

docker logs --since 10m code
# Check configured flags without exposing unrelated environment secrets:
docker inspect --format '{{range .Config.Env}}{{println .}}{{end}}' code | grep '^extra_params='

في عمليات التثبيت الأصلية، استخدم sudo journalctl -u coolwsd --since '10 minutes ago'ملف XML المحلي وافحصه. أما في جانب المتصفح، فافتح أدوات مطوري المتصفح وراجع علامة تبويب الشبكة أثناء فتح أي مستند. ميّز الطلبات المُرسلة إلى خوادم CODE وWOPI الخاصة بك عن تلك المُرسلة إلى وجهات خارجية.

معايير النجاح: يقوم برنامج CODE بتحميل المستندات وحفظها بشكل طبيعي؛ خيار التحقق من التحديثات مُعيّن على الصفر؛ تبقى عمليات التكامل السحابي الاختيارية مُعطّلة ما لم تتم الموافقة عليها صراحةً؛ ولا تُظهر مراقبة الشبكة سوى الوجهات المسموح بها خلال فترة المراقبة. في حال فشل تحميل المستندات بعد تصفية حركة البيانات، يُرجى مراجعة الوجهات الممنوعة مؤقتًا مقابل قائمة WOPI والبنية التحتية المعتمدة بدلاً من تعطيل التحقق من شهادة TLS أو فتح منفذ صادر غير مقيد.

المراجع الأساسية: نموذج تكوين الخادم المُحدّث من Collabora ، وتكوين حاوية Code المتكاملة من Nextcloud ، ووصف صورة Docker الرسمية لـ Code . توثّق هذه المراجع الإعدادات وأنماط النشر ذات الصلة، ولكنها لا تُغني عن تدقيق الشبكة لتثبيتك الخاص.