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

تكوين المثيل

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

يأتي كل تثبيت من Excubius بجميع الإمكانات. ويحدد Settings › Instance أيًّا منها يعرضه التثبيت، وبأي اسم وشعار وسمة. وتسري التغييرات على الجميع دفعة واحدة وتُكتب في سجل التدقيق. يوضح هذا الدليل كيفية تشغيل الميزات وتطبيق إعداد مسبق وضبط العلامة التجارية.

قبل البدء​

  • تحتاج إلى دور Super admin. ولا تُعرض الشاشة لأي شخص آخر.
  • تحتاج بعض الميزات أيضًا إلى إعداد على الخادم، مثل الرمز المميز لـ Slack أو بيانات اعتماد Jira. يؤدي تشغيل ميزة إلى إظهارها؛ ولا يؤدي إلى إعدادها.

فتح الشاشة​

  1. حدد Settings، ثم Instance.
  2. ابحث عن الأقسام Presets وFeatures وBranding الموضحة أدناه. وفي أسفل الشاشة، تخبرك الشاشة هل الميزات الموقوفة مخفية فقط أم ترفضها واجهة API أيضًا، ومتى أُجري آخر تغيير.

للأسماء وTLS الخاصة بالخادم شاشة مستقلة، يظهر رابطها في أعلى الشاشة باسم Server names and HTTPS. راجع إعداد الأسماء وTLS.

البدء من إعداد مسبق​

الإعداد المسبق نقطة بداية مسمّاة: مجموعة من مفاتيح الميزات إضافةً إلى العلامة التجارية. ويُعرض كل منها على شكل بطاقة مع وصفه. والإعدادات المسبقة العامة الغرض هي:

الإعداد المسبقالمحتوى
enterpriseكل شيء مشغّل؛ وهو الافتراضي للتثبيت الجديد
databasesالبنية التحتية والتنبيهات وصفحة الحالة ووحدات قواعد البيانات
coreالبنية التحتية والتنبيهات وصفحة الحالة
تحذير

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

حتى في enterprise، يظل مصدرا Defender for Cloud وWazuh متوقفين إلى أن تشغّلهما.

تشغيل ميزة أو إيقافها​

  1. ضمن Features، ابحث عن الميزة في مجموعتها: Sources أو Monitoring أو Security أو Collaboration أو Access أو Interface. يعرض كل سطر مفتاح الميزة، وما تفعله، والميزة التي تتطلبها إن وُجدت.
  2. استخدم مفتاحها.

يسري التغيير فورًا.

  • تظهر الميزة التي تتطلب ميزة أخرى باللون الرمادي ما دامت الأخرى موقوفة. ويؤدي إيقاف متطلَّب إلى إيقاف الميزات التابعة له أيضًا؛ فمثلًا يؤدي إيقاف security إلى إيقاف security.defender وsecurity.wazuh أيضًا.
  • يؤدي إيقاف ميزة تملك وحدات كتالوج إلى إزالة تلك الوحدات من قائمة الكتالوج.
  • الإخفاء شكلي افتراضيًا: يخضع التنقل والشاشات وعناصر الواجهة للمفاتيح، بينما يستمر جمع البيانات وتخزينها وعمل واجهة API. وعندما تعيد تشغيل ميزة يكون سجلها موجودًا. ولجعل واجهة API ترفض الميزات الموقوفة أيضًا، اضبط EXCUBIUS_FEATURES_ENFORCE_API=true في إعدادات الخادم؛ وعندئذٍ ترد نقاط نهايتها بالرمز 404.
  • تُفرض بعض المفاتيح في جميع الأحوال. فعند إيقاف access.google_login، يُرفض تسجيل الدخول عبر Google.

الميزات التي تشير إليها أدلة أخرى:

الميزةما تتحكم فيه
monitoring.databasesوحدات SQL Server (بما فيها مجموعات التوفر) وAzure SQL وManaged Instance وPostgreSQL
monitoring.updatesصفحة Updates & advisories وفحوصها
securityصفحة Security posture والاكتشافات ودرجة الأمان
security.defender، security.wazuhجمع البيانات من Microsoft Defender for Cloud ومن Wazuh. موقوفان افتراضيًا
security.recommendationsتعرض توصيات Defender for Cloud بجوار الاكتشافات
collab.jiraCreate Jira ticket على التنبيهات والاكتشافات؛ وتتطلب collab.assign
access.google_loginتسجيل الدخول عبر Google
access.directory_groupsأدوار مجموعات Microsoft Entra ID
ui.public_status_pageصفحات الحالة العامة
ui.i18nاللغات غير الإنجليزية، في وحدة التحكم وفي رسائل Slack
ui.themesالسمات اللونية الإضافية إلى جانب الفاتحة والداكنة

ضبط العلامة التجارية​

  1. ضمن Branding، املأ الحقول:

    الحقلالتأثير
    Product nameعنوان المتصفح، والترويسة، وصفحة تسجيل الدخول، واسم التطبيق المثبَّت، وبادئة قضايا Jira وتسميتها. حتى 60 حرفًا
    Taglineيُعرض بجوار الاسم على الشاشات العريضة وفي وصف التطبيق المثبَّت. حتى 120 حرفًا
    LogoNone، أو Built-in mark، أو Image URL: عنوان https أو مسار على هذا الخادم يبدأ بـ /
    Default themeسمة صفحة تسجيل الدخول والمستخدمين الجدد. ولا يزال بإمكان الناس اختيار سماتهم الخاصة
    Show "powered by" lineسطر اعتماد في التذييل، يظهر مع العلامة المضمّنة فقط
  2. حدد Save.

عندما يكون Logo مضبوطًا على None، تُستخدم أيقونة محايدة في كل مكان، بما في ذلك تبويب المتصفح والتطبيق المثبَّت، فلا يذكر شيء في المتصفح اسم المنتج. ولا تذكر رسائل Slack وصفحات الحالة العامة اسم المنتج أبدًا، أيًّا كانت العلامة التجارية.

السمات هي Midnight وDaylight وSlate and amber وOps room (high contrast) وOkabe–Ito (colour-blind safe) وPaper. وعند إيقاف ui.themes، يقدّم التثبيت السمتين الفاتحة والداكنة فقط.

يمكن أن يكون لفرع العميل سمته وشعاره الافتراضيان الخاصان به؛ راجع ضبط مظهر الفرع.

التنفيذ عبر API​

يتطلب كل طلب دور Super admin ويخضع للتدقيق.

المهمةالطلب
قراءة الإعدادات الكاملة والإعدادات المسبقة وسجل الميزاتGET /api/v1/instance/admin
تطبيق إعداد مسبقPOST /api/v1/instance/preset مع {"name": "databases"}
تشغيل الميزات أو إيقافهاPATCH /api/v1/instance/features مع {"changes": {"collab.jira": false}}
تغيير العلامة التجاريةPATCH /api/v1/instance/branding مع أي من product_name وtagline وlogo وshow_powered_by وtheme_default

لا يتطلب GET /api/v1/instance تسجيل دخول: فهو يعيد العلامة التجارية والمفاتيح كما يراها المتصل، وهذا ما تقرؤه وحدة التحكم عند تحميلها.