لا يزال قالب التكوين العام الحالي لـ Collabora Online يعرض logging.levelالقيم coolwsd.xmlالمدعومة، والتي تتراوح من warningإلى debugو trace. في حالة فشل الاتصال، ارفع مستوى التسجيل لفترة وجيزة، ثم أعد إنتاج حالة فشل اتصال واحدة، وافحص وجهة سجل الخدمة الفعلية، ثم أعد مستوى التسجيل إلى الوضع الطبيعي عند الانتهاء. القيمة المعروضة في ملف XML ليست دائمًا هي القيمة الفعلية: فقد يتجاوزها أمر بدء التشغيل أو إعدادات الحاوية، كما يمكن تعطيل تسجيلات WebSocket ذات مستوى الإسهاب العالي بشكل منفصل.
يركز هذا الدليل على تشخيص مشاكل الاتصال بين المتصفح ومنصة Collabora أو فشل فتح المستندات. ويستخدم coolwsd.xml.inقالب المصدر العام الحالي ومواد Collabora الرسمية التي تم التحقق منها في 6 أكتوبر 2026. قد تختلف الإعدادات الافتراضية للحزمة وأسماء الخدمات باختلاف الإصدار والنشر، لذا يُرجى التأكد من النسخة المُشغّلة لديك قبل نسخ المسارات أو أوامر إعادة التشغيل.
coolwsdهو برنامج Collabora Online WebSocket Daemon، وهو عملية الخادم التي تُدير جلسات المتصفح ونشاط المستندات. يُحدد مستوى التسجيل الخاص به مقدار التفاصيل التي يُصدرها. يسرد قالب المصدر الحالي مستويات مُسماة تشمل fatal، critical، error، warning، notice، information، ، debugو trace، بالإضافة إلى مستويات رقمية من 0 إلى 8. تتدرج القيم الرقمية من الأقل تفصيلاً إلى الأكثر تفصيلاً. يُعد المستوى ، debugخطوة معقولة للتشخيص الأولي؛ استخدم traceفقط عندما تحتاج إلى تفاصيل اتصال أدق.
يتحكم الإعداد المنفصل level_startupفي تسجيل الأحداث أثناء بدء التشغيل الأولي، ثم يعود التسجيل إلى مستواه في القالب الحالي level. يضبط القالب الحالي تسجيل بدء التشغيل على مستوى معين trace؛ وهذا لا يعني أن التشغيل العادي يبقى في وضع التتبع. تجنب تغيير هذا الإعداد level_startupعندما تحدث المشكلة بعد أن يكون الخدمة قيد التشغيل بالفعل.
قد يؤدي إطالة حجم المخرجات إلى زيادة حجم السجلات، وقد تتضمن عناوين URL وعناوين المواقع الإلكترونية ومعرّفات الجلسات أو تفاصيل تشغيلية أخرى. تعامل مع السجلات على أنها حساسة؛ اجمع فقط المعلومات المطلوبة خلال الفترة الزمنية المحددة، واحذف البيانات السرية قبل مشاركتها.
حدد أولاً ما إذا كان Collabora Online يعمل كخدمة نظام، أو في Docker أو Podman، أو في Kubernetes. هذا مهم لأن تغيير ملف داخل حاوية قيد التشغيل قد لا يُحفظ، وقد تُرسل سجلات الحاوية إلى المخرج القياسي بدلاً من ملف.
coolwsdيكون ذلك عبر ملف التكوين /etc/coolwsd/coolwsd.xml. قد تستخدم الإصدارات القديمة loolwsdمسارًا قديمًا.coolwsd.xml. تعديل pod مباشرةً هو إجراء مؤقت.
قبل التعديل، أنشئ نسخة احتياطية من ملف الإعدادات الفعلي أو احفظ نسخة من قيم النشر. إذا لم تكن متأكدًا من الملف الذي يقرأه البرنامج قيد التشغيل، فافحص تعريف الخدمة أو أمر بدء التشغيل أولًا. من الأسباب الشائعة لعدم حدوث أي تغيير هو تعديل ملف تجريبي بدلًا من ملف الإعدادات النشط.
في الملف النشط coolwsd.xml، حدد <logging>القسم وقم بتغيير القيمة الموجودة بداخله فقط <level>. ابدأ بـ debug. إذا لم تُظهر محاولة الاتصال تفاصيل كافية، فاستخدم لفترة وجيزة traceلإعادة إنتاج المشكلة. احتفظ بالملفات الحالية level_startup، وإعدادات الملفات، والتكوينات الأخرى دون تغيير.
<config>
<logging>
<level>trace</level>
<level_startup>trace</level_startup>
</logging>
</config>
هذا مثال مختصر لبنية XML ذات الصلة، وليس بديلاً عن ملف التكوين الكامل. بالنسبة لعمليات نشر الحاويات، اضبط الخيار من خلال آلية الحفظ التي تدعمها تلك الصورة أو المخطط. يتضمن مصدر Collabora الرسمي تجاوزات تكوين سطر الأوامر، لذا إذا ظهرت القيمة متجاهلة، فتحقق من وسيطات بدء التشغيل أو معلمات النشر بحثًا عن logging.levelقيمة ثانية.
إذا كانت السجلات تُحفظ في ملف، فإن قالب المصدر الحالي يُوثّق مسار الملف ضمن المسار المحدد logging.file، /var/log/coolwsd.logوالذي يكون عادةً . قد يكون تسجيل الملفات مُعطّلاً في بيئة الإنتاج. إذا قمتَ بتمكين إخراج الملفات أو استخدام مسار مُخصّص، فتأكد من أن coolحساب الخدمة لديه صلاحية الكتابة إلى هذا المسار وأن نظام systemd يسمح للخدمة بالكتابة إلى ذلك الموقع. لا تجعل السجل قابلاً للقراءة من قِبل الجميع لحل مشكلة في الأذونات.
تُفعّل معظم الإعدادات المُجمّعة بعد إعادة تشغيل الخدمة. أعد التشغيل خلال فترة صيانة مناسبة أو أثناء اختبار الخدمة، حيث قد تنقطع جلسات التحرير النشطة. بالنسبة لخدمة systemd، يكون الأمر النموذجي كالتالي:
sudo systemctl restart coolwsd
sudo systemctl status coolwsd --no-pagerاستخدم اسم الخدمة الفعلي على مضيفك. بالنسبة للحاوية، حدّث الإعدادات الدائمة وأعد تشغيلها أو أعد نشرها. بالنسبة لـ Kubernetes، طبّق تغيير البيان أو Helm من خلال عملية الإصدار المعتادة. تأكد من بدء العملية بشكل سليم قبل إعادة إنتاج المشكلة.
سجّل الوقت بدقة، واسم المستخدم أو حساب الاختبار المتأثر، وخطوة فتح المستند، والخطأ الظاهر في المتصفح. كرّر الخطأ مرة واحدة، ثم توقف عن إرسال الطلبات. من الأسهل ربط محاولة واحدة مُؤرّخة زمنيًا عبر Collabora، والخادم الوكيل العكسي، ووحدة التخزين أو مضيف WOPI، مقارنةً بسلسلة طويلة من الجلسات غير المترابطة.
بالنسبة لخدمة systemd، اتبع سجل النظام أثناء إعادة إنتاج المشكلة:
sudo journalctl -u coolwsd -fلفحص نافذة حديثة محدودة، استخدم الأمر ` sudo journalctl -u coolwsd --since "10 minutes ago". إذا كان لوحدتك اسم آخر، فاستبدله. بالنسبة لـ Docker، استخدم الأمر `..` docker logs --since 10m --follow CONTAINER_NAMEواستبدل `..` CONTAINER_NAMEباسم الحاوية أو معرّفها الفعلي. لدى Podman وKubernetes أوامر تسجيل خاصة بهما؛ راجع وثائق وقت تشغيل النشر بدلاً من افتراض وجود ملف مضيف.
إذا كانت خاصية تسجيل الملفات مُفعّلة، فراجع المسار المُكوّن، على سبيل المثال sudo tail -F /var/log/coolwsd.log. قد يختلف المسار في ملفك. لا يعني غياب ملفٍ ما بالضرورة أن الخدمة لم تُنتج أي سجلات؛ فقد تكون تكتب إلى سجل النظام أو مُخرجات الحاوية بدلاً من ذلك.
ابدأ بالبيانات المسجلة عند الطابع الزمني. ابحث عن علامات التحذير والخطأ، والمصطلحات المتعلقة بالاتصال مثل أو WOPI، WebSocketأو Socket، أو مسار الطلب ذي الصلة. في الملف، يمكن أن يكون عامل التصفية الأول المُركّز عليه كالتالي:
grep -Ei 'ERR|WRN|WOPI|WebSocket' /var/log/coolwsd.logثم اتبع التسلسل التالي: هل وصل المتصفح إلى عنوان URL العام؟ هل قام الخادم الوكيل العكسي بإعادة توجيه الطلب؟ هل اكتملت ترقية WebSocket؟ وهل اتصل Collabora بمضيف المستند؟ يمكن لسجلات الوصول والأخطاء الخاصة بالخادم الوكيل الإجابة على أسئلة لا يستطيع سجل coolwsd الإجابة عليها، مثل ما إذا كان الطلب قد وصل إلى الخدمة أصلاً. إذا أبلغ المتصفح عن فشل اتصال WebSocket ولكن لم يسجل coolwsd أي طلب مطابق، فتحقق من نظام أسماء النطاقات (DNS)، وإنهاء TLS، وقواعد جدار الحماية، وتوجيه الخادم الوكيل العكسي قبل تغيير أذونات المستند.
تتضمن قائمة الإعدادات الحالية الإعدادات الافتراضية لإخراج البيانات بتفصيل عالٍ Socket، مثل `<network>` و`<network>` و` WebSocket< network>`. إذا كان تسجيل التتبع مُفعّلاً ولكن تفاصيل المقبس غير موجودة، فراجع هذا الإعداد. لإجراء تشخيص سريع، أزل فقط الجزء ذي الصلة من قائمة الأجزاء المعطلة المفصولة بفواصل، مع الإبقاء على الاستثناءات غير ذات الصلة. أعد تشغيل النظام أو أعد نشره، وكرر نفس الاختبار المُتحكم فيه. استعد القائمة الأصلية بعد جمع الأدلة.AdminPixeldisabled_areasSocketWebSocket
ارجع <level>إلى قيمة الإنتاج السابقة، والتي عادةً ما warningتكون في قالب المصدر العام، واستعد أي تغييرات disabled_areas. أعد تشغيل الخدمة أو إعادة نشرها إذا تطلب الأمر ذلك في حزمة التغليف الخاصة بك. تأكد من سلامة الخدمة وتوقف ظهور رسائل التصحيح أو التتبع الجديدة. احتفظ فقط بمقتطف التشخيص المحدد زمنيًا في موقع مقيد.
قبل إرسال مقتطف من السجل إلى دعم Collabora أو إلى أحد المسؤولين، يُرجى إزالة رموز الوصول، وعناوين التفويض، وعناوين URL الموقعة، وأسماء المستخدمين، وأسماء المضيفين الخاصة، وأسماء المستندات إن أمكن. احتفظ بالطوابع الزمنية وسياق الخطأ غير الحساس اللازم لإعادة إنتاج التسلسل.
level_startup: ينطبق هذا الإعداد على مرحلة بدء التشغيل الأولية، ثم يعود إلى الإعداد الافتراضي level. في حالة حدوث عطل بعد بدء التشغيل، قم بتغيير الإعداد level.traceتفعيل جميع الفئات: يمكن للمناطق المعطلة حجب رسائل المقابس أو WebSocket ذات المحتوى العالي من المعلومات. تحقق من قائمة التصفية.مايكروسوفت أكسس هو تطبيق قواعد بيانات لنظام ويندوز يُستخدم لتخزين السجلات ذات الصلة، وإنشاء الاستعلامات، وتصميم نماذج إدخال البيانات، وإعداد التقارير. تعرّف على كيفية عمله ومتى يكون استخدامه مناسبًا.
تعرّف على كيفية استيراد ملف PST إلى Outlook 2010 أو تصدير البريد وجهات الاتصال والتقويم والمهام. اتبع الخطوات الصحيحة وتجنب فقدان المجلدات أو وجود ملفات مكررة.
تعلم كيفية ضبط ارتفاع وعرض خطوط الشبكة في برنامج Word 2010، وتغيير تردد الخطوط المرئية، وتعيين تباعد شبكة الرسم الأفقية والرأسية الأساسية.
استرجع كلمة مرور ملف Outlook PST المفقودة باتباع الخطوات الحالية لبرنامج Kernel، بما في ذلك كيفية تحديد الملف الصحيح، وإنشاء نسخة احتياطية، والتحقق من حدود الأداة.
استخدم وظيفة LiveWeb الإضافية لوضع موقع ويب على شريحة PowerPoint، وتعيين حجمه وسلوك التحديث، والتحقق من التوافق قبل العرض.
أضف العطلات الرسمية الخاصة بكل دولة في Outlook الجديد، أو Outlook على الويب، أو Outlook الكلاسيكي. تعرّف على كيفية تجنب الأحداث المكررة والتحقق من وجود تواريخ مفقودة لعامي 2026-2027.
استخدم أداة فحص المستندات في برنامج Word لمراجعة تفاصيل المؤلف والتعليقات والتغييرات المتعقبة والنصوص المخفية وغيرها من البيانات قبل المشاركة، وتعرف على ما قد يفوته الفحص.
تعرف على كيفية إنشاء ملف تعريف Outlook 2010، واختيار الملف الذي يفتح عند بدء التشغيل، وحماية الوصول إلى ملفات PST والبيانات غير المتصلة بالإنترنت.
قم بتصدير جدول Access 2010 إلى Excel 2010، واختر ما إذا كنت تريد تضمين التنسيق، واحفظ خطوات التصدير القابلة لإعادة الاستخدام، وتحقق من مشكلات نقل البيانات الشائعة.
قم بتعيين خط وحجم وتأثيرات نص افتراضية في Word 2010، واحفظ الاختيار في Normal.dotm، وقم بتعديل نمط Normal للمستندات المستقبلية.
