تثبيت Excubius
يعمل 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، والوصول إلى السجلات أو أرشيف الصور، ومزامنة الساعة.
يتلقى الخادم حزمة الإصدار وملف إعدادات وصور الحاويات. ولا يتلقى الشفرة المصدرية أبدًا، ولا يتصل بأي مستودع شفرة.
التثبيت
-
انسخ حزمة التثبيت إلى الخادم وفك ضغطها:
tar -xzf excubius-installer-0.4.0.tar.gzcd excubius-installer-0.4.0 -
يمكنك اختياريًا تشغيل عمليات التحقق المسبقة فقط. فهي لا تغيّر شيئًا:
sudo ./install.sh --check-only -
شغّل برنامج التثبيت وأجب عن أسئلته. اضغط Enter لقبول القيمة الموجودة بين الأقواس المربعة:
sudo ./install.shيحفظ برنامج التثبيت إجاباتك بإصدارات، لذا لا تسأل الترقية إلا عن الأسئلة المستجدة في ذلك الإصدار.
-
عند اكتمال التثبيت، افتح العنوان العام الذي يعرضه برنامج التثبيت وسجّل الدخول بصفتك المسؤول الذي سمّيته أثناء التثبيت. بعد ذلك أعدّ تسجيل الدخول وادعُ الأشخاص الذين سيستخدمون Excubius.
يُسجَّل كل ما يفعله برنامج التثبيت في /var/log/excubius-install.log، دون أي أسرار.
أسئلة برنامج التثبيت
| السؤال | القيمة الافتراضية | ملاحظات |
|---|---|---|
| دليل التثبيت | /opt/excubius | أي مسار مطلق |
| حساب الخدمة | excubius | يُنشأ إذا لم يكن موجودًا. يشغّل الحاويات دون امتيازات root |
| عنوان URL العام | https://monitoring.example.com | العنوان الذي سيفتحه الناس. مضيفه هو الاسم الأساسي للخادم |
| الأسماء المستعارة | لا شيء | أسماء أخرى يمكن للناس فتحها، مفصولة بمسافات، مثل اسم مستعار في نطاق تتحكم فيه |
| TLS | letsencrypt | letsencrypt (عبر 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 حرفًا أو أكثر، ويُطلب إدخالها مرتين |
| الإعداد المسبق الأساسي | enterprise | enterprise أو 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 أيضًا الإصدار الذي يعمل.