إنتقل إلى المحتوى الرئيسي
الإصدار: 0.4 · الحالي

تثبيت Excubius

نظرة عامةتمت المراجعة في 11 أكتوبر 2026
ينطبق على:Excubius 0.4الأدوار: القائم بالتثبيت (مسؤول Linux)
الخططFree · Core · Pro · Enterpriseالنشراستضافة ذاتية

يعمل Excubius على خادم Linux واحد تتحكم فيه، سواء في اشتراك السحابة لديك أو في مركز البيانات. يفحص برنامج التثبيت التفاعلي الخادم، ويطرح قائمة قصيرة من الأسئلة، ثم يثبّت الحاويات ويحصل على الشهادة. تسرد هذه المقالة ما تحتاج إليه، وما يسأل عنه برنامج التثبيت وما يفعله، وإلى أين تنتقل لكل مهمة تالية.

قبل البدء​

العنصرالمتطلب
الخادمRocky Linux 9 أو 10 (أو نظام آخر من عائلة RHEL)، بمعمارية x86-64 ومع systemd. 2 vCPU على الأقل، و4 GiB من الذاكرة، و20 GiB من المساحة الحرة على القرص؛ وفي Azure تُعد Standard_B2ms (2 vCPU و8 GiB) بداية جيدة ويمكن تغيير حجمها لاحقًا. إذا كان فريق السحابة لديك هو من ينشئ الخوادم، فراجع طلب خادم Azure
الوصولحساب يملك sudo على الخادم، ويمكن الوصول إليه عبر SSH من محطة العمل لديك
الشبكة نحو المستخدمينالمنفذان 80 و443 غير مشغولين على الخادم ومفتوحان من الأماكن التي سيستخدم الناس Excubius منها
الاتصال الصادرHTTPS إلى ghcr.io وdocker.io لسحب الصور، ما لم تستخدم الحزمة دون اتصال
الشبكة نحو ما تراقبهمن الخادم، منفذ SQL لكل مثيل ولكل نسخة متماثلة ولكل عنوان IP لوحدة استماع (ومنفذ UDP 1434 للمثيلات المسماة التي ليس لها منفذ ثابت)، إضافةً إلى HTTPS نحو نقاط نهاية الويب التي تختبرها. لا شيء يتصل بالمُجمِّع
حزمة التثبيتexcubius-installer-<version>.tar.gz، أو الحزمة دون اتصال التي تتضمن الصور. يحصل المستخدمون الذين سجلوا الدخول على الحزمتين من التنزيلات
تسجيل الدخولتسجيل تطبيق في Microsoft Entra ID، أو عميل Google OAuth، أو كلاهما. راجع إعداد موفري تسجيل الدخول
حسابات دخول المراقبةحسابات دخول للقراءة فقط إلى ما ستراقبه، مثل حساب دخول SQL Server في المتطلبات الأساسية لمجموعات التوفر
الشهادةلاستخدام Let's Encrypt: اسم DNS عام يشير إلى الخادم، أو وصول عبر API إلى منطقة DNS الخاصة به. وهي غير مطلوبة إذا كنت تستخدم شهادتك الخاصة أو شهادة موقّعة ذاتيًا أو بوابة تُنهي TLS

كيف يعمل التثبيت​

تشمل عمليات التحقق المسبقة نظام التشغيل وإصداره، والمعمارية، وsystemd وdnf، والذاكرة، ووحدات المعالجة المركزية، والقرص، وتوفر المنفذين 80 و443، وSELinux، والوصول إلى السجلات أو أرشيف الصور، ومزامنة الساعة.

يتلقى الخادم حزمة الإصدار وملف إعدادات وصور الحاويات. ولا يتلقى الشفرة المصدرية أبدًا، ولا يتصل بأي مستودع شفرة.

التثبيت​

  1. انسخ حزمة التثبيت إلى الخادم وفك ضغطها:

    tar -xzf excubius-installer-0.4.0.tar.gz
    cd excubius-installer-0.4.0
  2. يمكنك اختياريًا تشغيل عمليات التحقق المسبقة فقط. فهي لا تغيّر شيئًا:

    sudo ./install.sh --check-only
  3. شغّل برنامج التثبيت وأجب عن أسئلته. اضغط Enter لقبول القيمة الموجودة بين الأقواس المربعة:

    sudo ./install.sh

    يحفظ برنامج التثبيت إجاباتك بإصدارات، لذا لا تسأل الترقية إلا عن الأسئلة المستجدة في ذلك الإصدار.

  4. عند اكتمال التثبيت، افتح العنوان العام الذي يعرضه برنامج التثبيت وسجّل الدخول بصفتك المسؤول الذي سمّيته أثناء التثبيت. بعد ذلك أعدّ تسجيل الدخول وادعُ الأشخاص الذين سيستخدمون Excubius.

يُسجَّل كل ما يفعله برنامج التثبيت في /var/log/excubius-install.log، دون أي أسرار.

أسئلة برنامج التثبيت​

السؤالالقيمة الافتراضيةملاحظات
دليل التثبيت/opt/excubiusأي مسار مطلق
حساب الخدمةexcubiusيُنشأ إذا لم يكن موجودًا. يشغّل الحاويات دون امتيازات root
عنوان URL العامhttps://monitoring.example.comالعنوان الذي سيفتحه الناس. مضيفه هو الاسم الأساسي للخادم
الأسماء المستعارةلا شيءأسماء أخرى يمكن للناس فتحها، مفصولة بمسافات، مثل اسم مستعار في نطاق تتحكم فيه
TLSletsencryptletsencrypt (عبر HTTP)، وletsencrypt-dns (عبر DNS)، وselfsigned، وcustom (ملفات PEM الخاصة بك)، وgateway (يُنهى TLS في الواجهة الأمامية)، أو later (HTTP عادي في الوقت الحالي)
الأسماء في الشهادةallيُطرح هذا السؤال عند وجود أسماء مستعارة: استبعد الأسماء التي لا تستطيع الشهادة تغطيتها
البريد الإلكتروني لـ Let's Encrypt—وضعا Let's Encrypt كلاهما
موفر DNS وبيانات الاعتماد—letsencrypt-dns فقط: معرّف dnsapi في acme.sh، مثل dns_cf أو dns_dreamhost أو dns_azure، ومتغيراته، وتُكتب واحدًا تلو الآخر دون إظهارها على الشاشة
ملفا الشهادة والمفتاح—custom فقط: سلسلة PEM مع شهادة الخادم أولًا، ومفتاح غير مشفّر
اسم مستخدم المسؤول وكلمة مرورهاسم مستخدم مقترحالحساب المستخدم في أول تسجيل دخول، على العنوان الذي يطبعه برنامج التثبيت عند الانتهاء. تتطلب كلمة المرور 12 حرفًا أو أكثر، ويُطلب إدخالها مرتين
الإعداد المسبق الأساسيenterpriseenterprise أو databases أو core؛ راجع تكوين المثيل
مستخدم السجل ورمزه المميز—يُسلَّمان إليك مع الترخيص. لا يُطلبان مع الحزمة دون اتصال
الرمز المميز لروبوت Slack وقناته— و#alertsاختياري؛ يمكنك تعيينهما لاحقًا. راجع تكوين إشعارات Slack
معرّف مستأجر Entra ID ومعرّف العميل والسر—اختياري؛ يمكنك تعيينها لاحقًا

عند اختيار أحد وضعي Let's Encrypt، يتحقق برنامج التثبيت بعد ذلك من الأسماء في DNS العام، ومن أنها تشير إلى هذا الخادم عبر HTTP. وإذا لم تشر إليه، فإنه يشرح البدائل، لكنه لا يتوقف بسبب ذلك.

ينشئ برنامج التثبيت كلمة مرور قاعدة البيانات، وسر توقيع الجلسات، والمفتاح الذي يشفّر الأسرار المخزنة، والرمز المميز للمُجمِّع مرة واحدة، ولا يسأل عنها أبدًا. وبعد أن تخزّن المنصة كلمة مرور المسؤول وبيانات اعتماد DNS ومفتاحًا خاصًا، تزيلها من ملف الإعدادات.

لتثبيت دون أسئلة، مرّر الإجابات في ملف باستخدام --answers؛ راجع مرجع برنامج التثبيت.

الأسماء وTLS​

الوضعمتى تستخدمه
Let's Encrypt بالتحقق عبر HTTPيشير الاسم علنًا إلى الخادم ويمكن الوصول إلى المنفذ 80 من الإنترنت
Let's Encrypt بالتحقق عبر DNSالخادم خاص، لكن يمكنك إنشاء سجلات DNS عبر API
شهادتك الخاصةتُصدر مؤسستك الشهادات
موقّعة ذاتيًامختبر أو تجربة أولى
بوابةيُنهي موازن حمل أو وكيل عكسي في الواجهة الأمامية اتصال TLS
HTTP عاديتجربة أولى، أو شبكة تثق بها تمامًا

يمكنك تغيير الأسماء والشهادة لاحقًا من Settings دون إعادة تثبيت، ويتم التجديد تلقائيًا. راجع إعداد الأسماء وTLS.

الترقية أو إعادة التثبيت أو إلغاء التثبيت​

الأمرما يفعله
sudo ./install.sh على خادم مثبَّت عليه Excubiusيعرض Upgrade (يحتفظ بالبيانات ولا يسأل إلا عن الأسئلة الجديدة)، وReinstall، وPurge and install fresh، أو Cancel
sudo ./install.sh --uninstallيأخذ نسخة احتياطية أخيرة لقاعدة البيانات، ثم يزيل الخدمات والصور. ويُبقي على البيانات والنسخ الاحتياطية والإعدادات
sudo ./install.sh --uninstall --purgeيحذف أيضًا البيانات والنسخ الاحتياطية وحساب الخدمة. ويطلب منك كتابة purge
تحذير

نفّذ الترقية في نافذة تغيير. تُعاد الخدمات للعمل خلال ثوانٍ قليلة وتُشغَّل ترحيلات قاعدة البيانات. اقرأ المشكلات المعروفة الخاصة بالإصدار قبل أن تبدأ.

يعمل --dry-run مع كل أمر، ولا يفعل سوى طباعة ما سيحدث. وتجد خطوات الترقية والتراجع والنسخ الاحتياطي والاستعادة في الترقية والنسخ الاحتياطي والاستعادة، للمستخدمين الذين سجلوا الدخول.

راقب Excubius من الخارج​

لا ينبغي أن يكون Excubius الجهة الوحيدة التي تراقب نفسه. سجّل https://<your server>/heartbeat لدى مراقب خارجي، مثل اختبار التوفر في Azure Monitor، أو Uptime Kuma يعمل في مكان آخر، أو خدمة من نوع healthchecks، واجعله ينبهك عندما يتوقف العنوان عن الرد بـ ok. وإذا توقف الخادم، فإن هذا المراقب هو ما يخبرك بذلك.

يرد /heartbeat و/healthz عبر HTTP عادي في كل أوضاع TLS. ويعيد /healthz أيضًا الإصدار الذي يعمل.

الخطوات التالية​