قم بتثبيت ownCloud Infinite Scale باستخدام Docker Compose

لتثبيت الخادم، ابدأ بمثال ocis_fullDocker Compose الرسمي من ownCloud لإصدار 8.2 المستقر. يتضمن هذا المثال خدمة Infinite Scale، وخادم وكيل عكسي، وخدمات تعاون مكتبية اختيارية؛ قم بتكوين نطاقاتك، ومرسل SMTP، ومسارات البيانات في .envملف Docker Compose قبل التشغيل docker compose up -d. صُمم هذا الإعداد لمثيل واحد ويتطلب نظام أسماء نطاقات عام ومنافذ قابلة للوصول لشهادات Let's Encrypt الموثوقة. لإجراء تقييم داخلي بدون نطاق، اتبع قيود الشهادات الموقعة ذاتيًا الموضحة أدناه.

قبل التثبيت

تتبع هذه العملية دليل إعداد Docker Compose الخاص بإصدار Infinite Scale 8.2 من ownCloud ، والذي تم التحقق منه في 9 أكتوبر 2026. يستهدف الدليل نظام Ubuntu LTS 24.04 أو 22.04 مع تثبيت Docker Engine وDocker Compose مسبقًا. يوصي الدليل بذاكرة لا تقل عن 4-6 جيجابايت. تحتاج الخدمات المُفعّلة افتراضيًا إلى حوالي 2.4 جيجابايت من مساحة القرص، قبل احتساب ملفات المستخدم والسجلات والنسخ الاحتياطية والتوسعات المستقبلية.

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

• المضيف: Ubuntu 24.04 LTS أو 22.04 LTS مع إمكانية الوصول إلى SSH و sudo.
• الشبكة: نطاق يتم فيه حل سجلات DNS المطلوبة إلى عنوان WAN الخاص بالخادم؛ السماح بمنافذ TCP الواردة 22 و80 و443 في جدار الحماية وأي جهاز توجيه علوي.
• البرامج: محرك Docker ومكوّن Compose الإضافي. على نظام Linux، يوفر Docker وثائق التثبيت من خلال مستودع الحزم الخاص به؛ بعد التثبيت، تأكد من استجابة Compose بـ docker compose version.
• البريد الإلكتروني: يلزم تحديد قيمة SMTP_SENDERلهذا الخيار لبدء هذا المثال. أكمل إعدادات SMTP الأخرى إذا كنت ترغب في استلام رسائل البريد الإلكتروني للإشعارات.

1. قم بتثبيت Docker Compose وإعداد المضيف

إذا كان محرك Docker مثبتًا بالفعل، فقم بتثبيت إضافة Compose باستخدام الطريقة المناسبة لتوزيعة Linux الخاصة بك والمذكورة في تعليمات تثبيت Compose الرسمية من Docker . بالنسبة لأنظمة Ubuntu أو Debian حيث تم تكوين مستودع Docker، فإن أمر الحزمة الموثق هو:

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

توصي Docker باستخدام الملحق ونمط docker composeالأوامر في عمليات التثبيت الحالية. قم بتثبيت Docker Engine من تعليمات Ubuntu الرسمية إذا لزم الأمر.

قبل تنزيل ملف الإعدادات، وجّه النطاق أو النطاقات الفرعية التي تنوي استخدامها إلى عنوان IP العام للجهاز المضيف. يتطلب نموذج ownCloud ذلك OCIS_DOMAIN؛ وقد يستخدم أيضًا عنوان IP COLLABORA_DOMAINالعام ONLYOFFICE_DOMAINعند إعداد خدمات المكتب هذه. يجب أن تتطابق أسماء DNS مع القيم الموجودة في ملف الإعدادات .env. تأكد من أن جهاز التوجيه الخاص بك يُعيد توجيه المنفذين 80 و443 إلى هذا الجهاز المضيف، وأن جدار الحماية المحلي يسمح بهما.

2. احصل على مثال Compose الرسمي

استخدم ocis_fullالدليل من فرع أمثلة نشر ownCloudstable-8.2 الرسمية . نزّل ملف ZIP على جهاز كمبيوتر مزود بمتصفح، وانقله إلى الخادم غير المرئي باستخدام الأمر المناسب ، ثم استخرجه في المسار الموضح في دليل ownCloud.scp/opt/compose/ocis/ocis_full

احفظ النسخة الحالية .envقبل استخراج نسخة محدثة: يحذرك ownCloud من إمكانية استبدال الملف. شغّل أوامر Compose من مجلد المشروع.

3. تكوين النطاقات والشهادات والبريد الإلكتروني ومسارات البيانات

افتح الملف /opt/compose/ocis/ocis_full/.envفي محرر نصوص. احتفظ بأسماء المتغيرات وبنية الجملة الخاصة بالمثال، وقم بتعديل القيم التي تنطبق على تثبيتك فقط:

• قم بتعيين OCIS_DOMAINاسم المضيف الذي سيدخله المستخدمون. قم بتعيين أسماء مضيف Collabora أو OnlyOffice فقط إذا كانت هذه الخدمات مفعلة في المثال.
• بالنسبة للخادم المتصل بالإنترنت، قم بتعطيل هذا الخيار INSECUREوفقًا لتوجيهات المثال. لا تترك إعدادات الأمان غير الآمنة مفعلة للاستخدام العام.
• قم بتعيين TRAEFIK_ACME_MAILعنوان بريد إلكتروني تتحكم به. لاختبار الشهادة مبدئيًا، قم بتعيينها TRAEFIK_ACME_CASERVERعلى خادم Let's Encrypt التجريبي. شهادات الاختبار التجريبي غير موثوقة للاستخدام العادي؛ فهي تساعد في اختبار نظام أسماء النطاقات (DNS) وإمكانية الوصول قبل طلب شهادات الإنتاج.
• قم بتعيين هذا الخيار SMTP_SENDER، حتى لو لم تقم بتهيئة خادم بريد إلكتروني فعال بعد. ينص الدليل الرسمي على أن عملية النشر لن تبدأ بدونه. أضف مضيف SMTP والمنفذ وبيانات الاعتماد والمصادقة وإعدادات الأمان عند توفرها؛ فبدون إعدادات البريد الأخرى، يمكن تشغيل النظام ولكنه لن يتمكن من إرسال الإشعارات.
• راجع OCIS_DOCKER_IMAGEعلامات الصور في المثال. لا تقم بتغيير قنوات الإصدار بشكل عشوائي أثناء اتباع تثبيت إصدار مستقر.
• بالنسبة لخادم الإنتاج، يُنصح بتخصيص OCIS_DATA_DIRمسارات OCIS_CONFIG_DIRالتخزين المُخطط لها على وحدات تخزين ذات سعة كافية وتغطية نسخ احتياطية مناسبة. تستخدم الإعدادات الافتراضية وحدات تخزين مُدارة بواسطة Docker، وهي مريحة، ولكن يُشير ownCloud إلى أن موقعها ولقطاتها ونسخها الاحتياطية واستعادتها وإعادة ضبطها وترحيلها تعتمد على وحدة تخزين مضيف Docker.

يجب تقييد الوصول إلى الخادم وملف تكوينه. الشهادة الموقعة ذاتيًا مناسبة فقط للتقييم الداخلي، وليست مناسبة للنشر العام الموثوق.

من دليل المشروع، تحقق من صحة التكوين المدمج قبل بدء تشغيل الحاويات:

cd /opt/compose/ocis/ocis_full
docker compose config

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

4. ابدأ تشغيل الخدمات وأكمل إعداد الشهادة

ابدأ تشغيل المكدس في الخلفية:

docker compose up -d

تقوم عملية التشغيل الأولى بسحب الصور وبدء الخدمات، لذا قد تستغرق وقتًا أطول من عمليات إعادة التشغيل اللاحقة. للتحقق من حالة الخدمة، استخدم الأمر التالي:

docker compose ps -a

ثم افحص السجلات إذا كانت الخدمة غير موجودة أو إذا لم يتم تحميل عنوان الويب:

docker compose logs --follow

ابدأ بفحص سجلات Traefik. تشير أخطاء الشهادات عادةً إلى عدم تطابق نظام أسماء النطاقات (DNS) .envوالقيم، أو حظر المنافذ 80/443، أو بريد إلكتروني غير صالح من ACME. أصلح السبب قبل إعادة المحاولة. لا تستخدم docker compose down -vهذه الطريقة لإعادة التعيين: فهي تحذف جميع وحدات تخزين المشروع، بما في ذلك البيانات.

عند نجاح عمليات التحقق من شهادات بيئة الاختبار، اتبع إجراءات شهادات ownCloud: أوقف عملية النشر، ثم احذف وحدة تخزين الشهادات الخاصة بالمثال فقط ocis_full_certs، وامسح إعدادات المرجع المصدق لبيئة الاختبار، ثم ابدأ من جديد لطلب شهادات الإنتاج الموثوقة. تأكد من اسم وحدة التخزين بدقة docker volume lsقبل حذفها. لا تحذف وحدات تخزين البيانات أو الإعدادات.

تحقق من الوصول وقم بحماية النشر

افتح عنوان URL المُحدد في ملف الإعدادات OCIS_DOMAIN. تعني النتيجة الناجحة أن المتصفح يصل إلى صفحة تسجيل الدخول عبر HTTPS دون ظهور تحذير بشأن الشهادة، docker compose ps -aويُظهر الخدمات المطلوبة قيد التشغيل. سجّل الدخول باستخدام بيانات الاعتماد الأولية الموثقة من قِبل ownCloud (الرابط admin/ admin، إلا إذا قمت بتعيين كلمة مرور أولية مختلفة)، ثم غيّر كلمة مرور المسؤول فورًا.

إذا كان الموقع غير متاح، فتحقق من نظام أسماء النطاقات (DNS)، وإعادة توجيه المنافذ، وسجلات ACME الخاصة بـ Traefik، ثم سجلات خدمة Infinite Scale. إذا نجح تسجيل الدخول ولكن لم تصل إشعارات البريد الإلكتروني، فتحقق من إعدادات SMTP.

قبل تخزين الملفات المهمة، تأكد من أن النسخة الاحتياطية تشمل كلاً من الإعدادات والبيانات. تُعدّ وحدات التخزين المُدارة بواسطة Docker ملائمة للتقييم؛ كما أن مسارات المضيف الصريحة أسهل في وضعها على قرص منفصل وتضمينها في النسخ الاحتياطية للمضيف. ستكون جاهزًا عندما يكون بروتوكول HTTPS صالحًا، وتستمر الخدمات في العمل بعد إعادة التشغيل، ويعمل تسجيل دخول المسؤول، وتغطي النسخ الاحتياطية وحدة التخزين المختارة.