كيفية ضبط كلمة مرور لوحة تحكم المسؤول لـ Collabora Online

إذا تمكنت من فتح Collabora Online ولكنك لم تتمكن من تسجيل الدخول إلى لوحة تحكم الإدارة، فقد لا تكون بيانات الاعتماد مُهيأة لخادم Collabora. يعتمد الحل على طريقة تثبيت Collabora: يستخدم تثبيت حزمة Linux أداةً معينة coolconfig، بينما تقبل صورة CODE Docker الرسمية متغيرات usernameالبيئة password. هذه مسارات إعداد منفصلة؛ اختر المسار الذي يتوافق مع بيئة التثبيت لديك.

لوحة تحكم المسؤول هي صفحة إدارة من جانب الخادم. وهي ليست نفس حساب مسؤول Nextcloud، أو حساب مستخدم المستندات، أو بيانات اعتماد تكامل WOPI. يوثق دليل Collabora SDK 24.04 عنوان لوحة التحكم، وطريقة تهيئة Linux، ومتغيرات صورة Docker. نظرًا لاحتمالية تغيير تفاصيل النشر بين الإصدارات، يُرجى مراجعة وثائق الإصدار الذي تستخدمه قبل تطبيق أي تغيير على بيئة الإنتاج: دليل Collabora Online SDK 24.04 .

اختر طريقة التكوين التي تتناسب مع عملية التثبيت الخاصة بك

حدد أولاً طريقة النشر. إذا كان coolwsdالتطبيق يعمل مباشرةً كخدمة نظام وكان لدى المضيف coolconfigالأمر اللازم، فاستخدم طريقة الحزمة. أما إذا كان التطبيق يعمل في حاوية مبنية على نظام التشغيل collabora/code، فقم بتهيئة بيئتها بدلاً من ذلك. تجنب تعيين كلمة مرور على المضيف وتوقع أن يؤدي ذلك إلى تغيير حاوية قيد التشغيل بالفعل.

لتثبيت حزمة لينكس، قم بتعيين كلمة مرور بشكل تفاعلي

1. افتح نافذة طرفية على خادم Collabora أو اتصل عبر SSH باستخدام حساب لديه صلاحيات sudo.
2. يجري sudo coolconfig set-admin-password.
3. عند ظهور المطالبة، أدخل اسم المستخدم وكلمة المرور الخاصين بلوحة تحكم المسؤول، ثم أكد كلمة المرور. لن يظهر لك رمز كلمة المرور أثناء كتابتها في نافذة الأوامر.
4. إذا تطلّب تثبيتك إعادة تشغيل الخدمة بعد تغيير الإعدادات، فقم بتشغيل الأمر التالي sudo systemctl restart coolwsd. تحقق من حالة الخدمة باستخدام الأمر التالي sudo systemctl status coolwsd.
5. افتح عنوان URL الخاص بوحدة تحكم المسؤول وقم بتسجيل الدخول باستخدام بيانات الاعتماد التي قمت بتعيينها للتو.

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

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

بالنسبة لصورة CODE Docker، قم بتعيين كلا متغيري البيئة

تقرأ صورة CODE الرسمية usernameمن passwordبيئتها عند بدء تشغيل الحاوية. أضف كلا القيمتين إلى إعدادات الحاوية؛ فتعيين كلمة مرور فقط غير كافٍ. بالنسبة إلى Docker Compose، يمكن أن يبدو الربط كالتالي:

services:
  collabora:
    image: collabora/code
    restart: unless-stopped
    ports:
      - "9980:9980"
    environment:
      username: collabora_admin
      password: ${COLLABORA_ADMIN_PASSWORD}

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

احفظ ملف Compose وأعد إنشاء الحاوية لكي يمرر Docker البيئة المُحدَّثة عند بدء التشغيل. بالنسبة لخدمة باسم معين collabora، يكون هذا عادةً docker compose up -d --force-recreate collabora. إعادة تشغيل الحاوية ببساطة لا تستبدل قيم البيئة المخزنة عند إنشائها. تحقق من إصدار Compose واسم الخدمة قبل تشغيل الأمر، وتجنب عرض كلمة المرور حرفيًا في سجل الأوامر.

للنشر المباشر docker run، تكون الإعدادات المكافئة عبارة عن متغيرات بيئية يتم تمريرها مع -e، مثل -e username=collabora_adminو -e password=.... استخدم أسلوب إدارة الأسرار الخاص بك لتوفير القيمة؛ لا تقم بنسخ كلمة مرور نموذجية من برنامج تعليمي إلى خدمة متاحة عبر الإنترنت.

افتح لوحة تحكم المسؤول وتحقق من تسجيل الدخول

مسار وحدة التحكم الموثق هو /browser/dist/admin/admin.html. على المنفذ الافتراضي، يكون عنوان URL الكامل هو https://your-collabora-host:9980/browser/dist/admin/admin.html. إذا انتهى بروتوكول TLS عند خادم وكيل عكسي، فاستخدم اسم المضيف والمنفذ العامين لبروتوكول HTTPS اللذين يوفرهما هذا الخادم الوكيل. قد يختلف العنوان إذا قام مسؤول النظام بتكوين منفذ أو توجيه URL غير افتراضي.

سجّل الدخول وتأكد من تحميل وحدة التحكم لمعلومات المراقبة. يشرح دليل SDK مراقبة الجلسات المباشرة، بما في ذلك المستندات المفتوحة والمستخدمين. ولأن وحدة التحكم قد تكشف تفاصيل تشغيلية وتتيح إجراءات إدارية مثل إغلاق جلسات المستندات، يُنصح بتقييد الوصول إلى المسؤولين الموثوق بهم، واستخدام بروتوكول HTTPS، وتجنب إتاحة نقطة إدارة النظام على نطاق واسع للإنترنت العام. طبّق قيود الشبكة على جدار الحماية أو الخادم الوكيل العكسي إذا كان نظامك يدعمها.

لتثبيت حزمة، تأكد من سلامة الخدمة باستخدام الأمر `docker install` sudo systemctl status coolwsd. بالنسبة لـ Docker، افحص حالة الحاوية باستخدام الأمر `docker install` docker compose psوسجلاتها الأخيرة باستخدام الأمر ` docker compose logs --tail=100 collaboradocker install`. لا تكفي سلامة الخدمة وحدها لإثبات صحة كلمة المرور؛ فالتحقق النهائي هو تسجيل الدخول بنجاح إلى عنوان URL الخاص بلوحة تحكم الإدارة.

المفاهيم الخاطئة الشائعة وما يجب فعله بدلاً منها

"تستخدم لوحة تحكم المسؤول كلمة مرور Nextcloud الخاصة بي."

ليس افتراضيًا. يتم تكوين بيانات اعتماد وحدة تحكم إدارة Collabora على خادم Collabora، بشكل مستقل عن حسابات مستخدمي Nextcloud. الإجراء: استخدمها coolconfig set-admin-passwordفي تثبيت حزمة، أو قم بتحديث بيئة حاوية CODE وأعد إنشاء الحاوية.

"لقد قمت بتغيير ملف Docker Compose، لذا فإن الحاوية قيد التشغيل تحتوي على كلمة المرور الجديدة."

لا يؤدي تعديل الملف إلى تغيير بيئة الحاوية المحفوظة. الإجراء: أعد إنشاء خدمة Compose ذات الصلة، ثم اختبر بيانات الاعتماد الجديدة. احفظ كلمة المرور بعيدًا عن مخرجات الأوامر ونظام التحكم في الإصدارات.

"إذا تم فتح عنوان URL الخاص بوحدة تحكم المسؤول، فهذا يعني أن الخادم مؤمن."

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

"لوحة تحكم المسؤول هي المكان المناسب لتعيين بيانات اعتماد تحرير المستندات."

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

إذا استمر فشل تسجيل الدخول

• تأكد مما إذا كان Collabora يعمل كخدمة مضيفة أو في حاوية CODE، ثم استخدم مسار التكوين المطابق فقط.
• تحقق من عنوان URL الخاص بوحدة التحكم العامة بدقة، بما في ذلك HTTPS والمنفذ و /browser/dist/admin/admin.html.
• بالنسبة لـ Docker، تأكد من وجود كليهما usernameفي passwordتكوين الخدمة الفعال وأعد إنشاء الحاوية بعد التغييرات.
• لتثبيت حزمة، أعد تشغيل coolconfigالأمر التفاعلي على مضيف Collabora وافحص coolwsdالحالة والسجلات.
• في حال استخدام خادم وكيل عكسي، اطلب من مسؤول النظام التحقق من صحة مسار لوحة التحكم الإدارية وأي بيانات WebSocket مطلوبة. لا تُضعف إجراءات المصادقة لتجاوز مشكلة في الخادم الوكيل.

بمجرد تسجيل الدخول والتأكد من سلامة الخدمة، احفظ بيانات الاعتماد الجديدة في مدير كلمات المرور المعتمد لديك، ووثّق المضيف أو الحاوية التي تملكها. قد يختلف تكوين لوحة تحكم Collabora الإدارية باختلاف الإصدار وطريقة التغليف؛ ودليل SDK 24.04 المذكور أعلاه خاص بهذا الإصدار، لذا استخدم الوثائق المطابقة للإصدارات الأحدث أو المُخصصة من قِبل المورّد.