قم بتعيين كلمة مرور آمنة للوحة تحكم إدارة Collabora

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

تأكد من كلمة المرور التي تقوم بتغييرها

لوحة تحكم المسؤول هي صفحة إدارة الخدمات في Collabora Online. وهي منفصلة عن حساب المسؤول في Nextcloud أو أي منصة تخزين أخرى، وتغيير كلمة مرورها لا يؤثر على بيانات تسجيل دخول مستخدمي المستندات أو بيانات الاعتماد التي تستخدمها منصتك للاتصال بـ Collabora. كما أن عمليات التثبيت القائمة على Docker والحزم تستخدم مسارات عمل تكوين مختلفة، لذا تأكد من تحديد بيئة النشر الخاصة بك قبل إجراء أي تغييرات.

بالنسبة لـ CODE في Docker، توفر Collabora وثائق usernameوإعدادات passwordبيئة الحاوية. بالنسبة لعمليات التثبيت القائمة على الحزم، يمكن لأداة تكوين Collabora تعيين كلمة مرور المسؤول بشكل تفاعلي. يشير مرجع التكوين الحالي إلى أن الاستخدام المباشر لهذا admin_console.passwordالإعداد أصبح قديمًا على معظم الأنظمة الأساسية، ويوصي باستخدام PAM coolconfigبدلاً منه. راجع وثائق صورة Docker الخاصة بـ CODE من Collabora ومرجع تكوين Collabora .

قم بالتحضير قبل تغيير بيانات الاعتماد

• تأكد من اسم المضيف، أو اسم الحاوية، أو اسم الخدمة، وما إذا كان Collabora يعمل في Docker أو كحزمة Linux. إذا كان لديك عدة نسخ، فدوّن أيها يخدم مستخدميك.
• اختر كلمة مرور فريدة واحفظها في مدير كلمات المرور أو مخزن كلمات المرور الخاص بك. لا تستخدم كلمة مرور نموذجية من أي دليل تعليمي.
• إذا كنت تدير Docker Compose، فقم بعمل نسخة احتياطية من ملف Compose أو قم بتثبيته دون تضمين أي بيانات سرية. قيّد الوصول إلى الملف الذي يحتوي على البيانات السرية؛ إذ تظل متغيرات البيئة مرئية للمسؤولين الذين يمكنهم فحص الحاوية.
• اجعل نقطة وصول المسؤول محمية بضوابط الوصول المعتادة. كلمة مرور قوية مفيدة، لكنها لا تغني عن تقييد من يمكنه الوصول إلى صفحة الإدارة.

قم بتعيين كلمة المرور لحاوية CODE Docker

في خدمة Compose الخاصة بـ Collabora، قم بتعيين المتغيرات الموثقة username. passwordيقرأ هذا المثال كلمة المرور من .envملف محلي بدلاً من وضع السر مباشرةً في ملف Compose.

services:
  collabora:
    image: collabora/code
    environment:
      username: admin
      password: "${COLLABORA_ADMIN_PASSWORD:?Set it in .env}"

في نفس مجلد المشروع، ضع السر في .env:

COLLABORA_ADMIN_PASSWORD=replace-with-your-unique-secret

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

docker compose up -d --force-recreate collabora

استخدم اسم خدمة Compose الفعلي الخاص بك إن لم يكن كذلك collabora. سيؤدي هذا إلى إعادة تشغيل حاوية Collabora؛ ولن يحذف مستنداتك، التي يتم تخزينها بواسطة منصتك المتصلة. إذا كانت عملية النشر مُدارة بواسطة Kubernetes أو Helm أو أي لوحة تحكم أخرى، فغيّر السر أو القيم المقابلة هناك، وطبّق عملية النشر العادية بدلاً من تعديل حاوية قيد التشغيل يدويًا.

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

على خادم تم تثبيت Collabora عليه كحزمة نظام، قم بتشغيل أداة التكوين على ذلك الخادم:

sudo coolconfig set-admin-password

سيطلب منك البرنامج إدخال كلمة المرور الجديدة، لذا لا داعي لإدراجها في سطر الأوامر. أدخلها عند ظهور الموجه، وكررها إذا طُلب منك ذلك. ثم أعد تشغيل الخدمة لتحميل الإعدادات المُحدثة.

sudo systemctl restart coolwsd

يستخدم مثال تثبيت Nextcloud الحالي على Ubuntu أيضًا coolconfig set-admin-passwordCollabora ويعيد التشغيل coolwsdبعد التهيئة. قد يختلف مدير الحزم والخدمات في التوزيعات الأخرى؛ لذا يُرجى مراجعة تعليمات تثبيت Collabora الخاصة بتلك التوزيعة إذا لم يكن الأمر أو اسم الخدمة متاحًا. مثال Nextcloud موثق في دليل إعداد Ubuntu 24.04 الخاص به .

سجّل الدخول وتحقق من النتيجة

افتح لوحة تحكم إدارة خادم Collabora، والتي عادةً ما تكون على الرابط التالي: [رابط https://collabora.example.com/browser/dist/admin/admin.htmlلوحة التحكم]، مع استبدال [رابط لوحة التحكم] بعنوان URL العام لخادمك. سجّل الدخول باستخدام اسم المستخدم الإداري المُعدّ مسبقًا وكلمة المرور الجديدة. يُؤكد تسجيل الدخول بنجاح قبول لوحة التحكم لبيانات الاعتماد، ولكنه لا يُؤكد تلقائيًا سلامة تحرير المستندات أو اتصال WOPI.

1. إذا فشل تسجيل الدخول على Docker، فتأكد من أنك قمت بتحرير مشروع Compose الذي يقدم عنوان URL هذا بالفعل، وأن اسم المتغير هو بالضبط usernameأو password، وأنك قمت بإعادة إنشاء الحاوية بعد التغيير.
2. إذا فشلت عملية تسجيل الدخول بعد تحديث الحزمة، فتأكد من coolwsdإعادة تشغيلها بنجاح وأن المتصفح يتصل بالخادم المطلوب. راجع سجلات الخدمة بحثًا عن أخطاء في التكوين دون نسخ البيانات السرية إلى منشور دعم.
3. إذا قمتَ بتفعيل مصادقة PAM، فسيتم تجاهل القيم المُكوّنة admin_console.username. admin_console.passwordاستخدم حساب PAM وكلمة المرور المُكوّنة للمضيف بدلاً من ذلك؛ لن يؤدي تغيير متغيرات بيئة CODE Docker إلى تجاوز إعدادات PAM.
4. إذا نجح تسجيل الدخول ولكن لم يتم تحميل صفحة الإدارة، فتحقق من مسارات Collabora وسياسة الوصول الخاصة بالخادم الوكيل العكسي. مشكلة الخادم الوكيل أو الشبكة تختلف عن رفض كلمة المرور.

أخطاء شائعة يجب تجنبها

لا تخلط بين كلمة مرور وحدة تحكم الإدارة وكلمة مرور مسؤول Nextcloud، ولا تلصق السر في أي أمر إذا docker run -e password=...كان من الممكن كشفه من خلال سجل الأوامر أو فحص العمليات. في حالة نشر Compose، احتفظ بالسر في ملف بيئة محمي أو مدير أسرار متاح، وقصر الوصول إليه على مضيف Docker. تجنب أيضًا التعديل coolwsd.xmlالمباشر كخيار أول، حيث يعتبر Collabora إعداد كلمة المرور القديم قديمًا على معظم المنصات.

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